PowerShell Cmdlet - Suspend-Service
 記事記号:[mh1914] 初版:2011/Sep/30

この文書は、Windows PowerShellのヘルプ機能で表示される内容を再構成したものです。

名前
    Suspend-Service
    
概要
    実行中の 1 つ以上のサービスを中断 (一時停止) します。
    
構文
    Suspend-Service [-Name] <string[]> [-Exclude <string[]>] [-Include <string[]
    >] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]
    
    Suspend-Service -DisplayName <string[]> [-Exclude <string[]>] [-Include <str
    ing[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]
    
    Suspend-Service [-InputObject <ServiceController[]>] [-Exclude <string[]>] [
    -Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]
    
説明
    Suspend-Service コマンドレットは、ユーザーが指定した各サービスについて、Wind
    ows サービス コントローラーに中断メッセージを送ります。中断中でもサービスは
    実行状態のままですが、Resume-Service を使用するなどして再開するまでは、その
    動作は停止されます。サービスはサービス名または表示名で指定するか、InputObjec
    t パラメーターを使用して、中断するサービスを表すサービス オブジェクトを渡し
    ます。

パラメーター
    -DisplayName <string[]>
        中断するサービスの表示名を指定します。ワイルドカードを使用できます。
        
        必須                         true
        位置                         named
        既定値                       
        パイプライン入力を許可する   false
        ワイルドカード文字を許可する false
        
    -Exclude <string[]>
        指定されたサービスを除外します。このパラメーターの値は、Name パラメータ
        ーを修飾します。"s*" などの名前要素またはパターンを入力します。ワイルド
        カードを使用できます。
        
        必須                         false
        位置                         named
        既定値                       
        パイプライン入力を許可する   false
        ワイルドカード文字を許可する false
        
    -Include <string[]>
        指定したサービスだけを中断します。このパラメーターの値は、Name パラメー
        ターを修飾します。"s*" などの名前要素またはパターンを入力します。ワイル
        ドカードを使用できます。
        
        必須                         false
        位置                         named
        既定値                       
        パイプライン入力を許可する   false
        ワイルドカード文字を許可する false
        
    -InputObject <ServiceController[]>
        中断するサービスを表す ServiceController オブジェクトを指定します。オブ
        ジェクトが格納されている変数を入力するか、オブジェクトを取得するコマンド
        または式を入力します。
        
        必須                         false
        位置                         named
        既定値                       
        パイプライン入力を許可する   true (ByValue)
        ワイルドカード文字を許可する false
        
    -Name <string[]>
        中断するサービスのサービス名を指定します。ワイルドカードを使用できます。
        
        パラメーター名は省略可能です。Name またはそのエイリアスである ServiceNam
        e を使用するか、パラメーター名を省略することができます。
        
        必須                         true
        位置                         1
        既定値                       
        パイプライン入力を許可する   true (ByValue, ByPropertyName)
        ワイルドカード文字を許可する false
        
    -PassThru [<SwitchParameter>]
        サービスを表すオブジェクトを返します。既定では、このコマンドレットによる
        出力はありません。
        
        必須                         false
        位置                         named
        既定値                       
        パイプライン入力を許可する   false
        ワイルドカード文字を許可する false
        
    -Confirm [<SwitchParameter>]
        コマンドを実行する前に確認メッセージを表示します。
        
        必須                         false
        位置                         named
        既定値                       
        パイプライン入力を許可する   false
        ワイルドカード文字を許可する false
        
    -WhatIf [<SwitchParameter>]
        実際にコマンドを実行せずに、コマンドを実行すると何が起きるかを出力します。
        
        必須                         false
        位置                         named
        既定値                       
        パイプライン入力を許可する   false
        ワイルドカード文字を許可する false
        
    <CommonParameters>
        このコマンドレットは、次の共通パラメーターをサポートします: Verbose、
        Debug、ErrorAction、ErrorVariable、WarningAction、WarningVariable、
        OutBuffer、および OutVariable。詳細については、
        「get-help about_commonparameters」と入力してヘルプを参照してください。
    
入力
    System.ServiceProcess.ServiceController または System.String
        パイプを使用してサービス オブジェクトまたはサービス名を含む文字列を Susp
        end-Service に渡すことができます。
    
出力
    なし、または System.ServiceProcess.ServiceController
        PassThru パラメーターを使用すると、Suspend-Service はサービスを表す Syst
        em.ServiceProcess.ServiceController オブジェクトを生成します。それ以外の
        場合、このコマンドレットによる出力はありません。
    
メモ
        Suspend-Service では、現在のユーザーに権限がある場合のみサービスを制御で
        きます。コマンドが正常に機能しない場合は、必要な権限が与えられていない可
        能性があります。
        
        また、Suspend-Service は、中断と再開をサポートしているサービスだけを中断
        することができます。あるサービスが中断可能かどうかを確認するには、Get-Se
        rvice コマンドレットを CanPauseAndContinue プロパティと共に使用します。
        たとえば、"get-service wmi | format-list name, canpauseandcontinue" を実
        行します。コンピューター上で中断可能なサービスをすべて参照するには、「ge
        t-service | where-object {$_.canpauseandcontinue -eq "True"}」と入力しま
        す。
        
        システム上のサービスのサービス名と表示名を参照するには、「get-service」
        と入力します。サービス名は [Name] 欄に表示され、表示名は [DisplayName] 
        欄に表示されます。
        
    -------------------------- 例 1 --------------------------
    
    C:\PS>suspend-service -displayname "Telnet"
    
    説明
    -----------
    このコマンドを実行すると、ローカル コンピューター上の Telnet サービス (Tlnts
    vr) が中断されます。
    
    -------------------------- 例 2 --------------------------
    
    C:\PS>suspend-service -name lanman* -whatif
    
    説明
    -----------
    このコマンドを実行すると、名前が "lanman" で始まるサービスを中断した場合、ど
    のような結果になるかが表示されます。サービスを中断するには、WhatIf パラメー
    ターなしでコマンドを再度実行します。
    
    -------------------------- 例 3 --------------------------
    
    C:\PS>get-service schedule | suspend-service
    
    説明
    -----------
    このコマンドは、Get-Service コマンドレットを使用して、コンピューター上の Tas
    k Scheduler (Schedule) サービスを表すオブジェクトを取得します。パイプライン
    演算子 (|) により、結果が Suspend-Service コマンドレットに渡され、サービスが
    中断されます。
    
    -------------------------- 例 4 --------------------------
    
    C:\PS>get-service | where-object {$_.canpauseandcontinue -eq "True"} | suspen
    d-service -confirm
    
    説明
    -----------
    このコマンドを実行すると、コンピューター上の中断可能なすべてのサービスが中断
    されます。このコマンドは、Get-Service コマンドレットを使用して、コンピュータ
    ー上のサービスを表すオブジェクトを取得します。パイプライン演算子 (|) により、
    結果が Where-Object コマンドレットに渡され、CanPauseAndContinue プロパティの
    値が True のサービスだけが選択されます。もう一つのパイプライン演算子は、結果
    を Suspend-Service コマンドレットに渡します。Confirm パラメーターがあることで、
    各サービスを中断する前に確認メッセージが表示されます。
    
関連するリンク
    Online version: http://go.microsoft.com/fwlink/?LinkID=113416
    Get-Service 
    Start-Service 
    Stop-Service 
    Restart-Service 
    Resume-Service 
    Set-Service 
    New-Service 
    	
記事で解説しているパソコンの環境
 基本ソフト: Windows 7
 キーワード: Windows PowerShell、ヘルプ、Cmdlet、Suspend-Service
ご利用数: 1915749
感想・要望・問い合わせは こちら