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

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

名前
    Stop-Service
    
概要
    実行中のサービスを 1 つ以上停止します。
    
構文
    Stop-Service [-Name] <string[]> [-Exclude <string[]>] [-Force] [-Include <st
    ring[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]
    
    Stop-Service -DisplayName <string[]> [-Exclude <string[]>] [-Force] [-Includ
    e <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]
    
    Stop-Service [-InputObject <ServiceController[]>] [-Exclude <string[]>] [-Fo
    rce] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParamete
    rs>]
    
説明
    Stop-Service コマンドレットは、ユーザーが指定した各サービスについて、Windows 
    サービス コントローラーに停止メッセージを送ります。サービスはサービス名また
    は表示名で指定するか、InputObject パラメーターを使用して、停止したいサービス
    を表すサービス オブジェクトを渡します。
    
パラメーター
    -DisplayName <string[]>
        停止するサービスの表示名を指定します。ワイルドカードを使用できます。
        
        必須                         true
        位置                         named
        既定値                       
        パイプライン入力を許可する   false
        ワイルドカード文字を許可する false
        
    -Exclude <string[]>
        指定されたサービスを除外します。このパラメーターの値は、Name パラメータ
        ーを修飾します。"s*" などの名前要素またはパターンを入力します。ワイルド
        カードを使用できます。
        
        必須                         false
        位置                         named
        既定値                       
        パイプライン入力を許可する   false
        ワイルドカード文字を許可する false
        
    -Force [<SwitchParameter>]
        他のサービスが依存しているサービスであっても、コマンドレットでサービスを
        停止できるようにします。
        
        必須                         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
        パイプを使用してサービス オブジェクトまたはサービス名を含む文字列を Stop
        -Service に渡すことができます。
    
出力
    なし、または System.ServiceProcess.ServiceController
        PassThru パラメーターを使用すると、Stop-Service はサービスを表す System.
        ServiceProcess.ServiceController オブジェクトを生成します。それ以外の場
        合、このコマンドレットによる出力はありません。
    
メモ
        Stop-Service は、その組み込みエイリアスである "spsv" で参照することもで
        きます。詳細については、「about_Aliases」を参照してください。
        
        Stop-Service では、現在のユーザーに権限がある場合のみサービスを制御でき
        ます。コマンドが正常に機能しない場合は、必要な権限が与えられていない可
        能性があります。
        
        システム上のサービスのサービス名と表示名を参照するには、「get-service」
        と入力します。サービス名は [Name] 欄に表示され、表示名は [DisplayName] 
        欄に表示されます。
        
    -------------------------- 例 1 --------------------------
    
    C:\PS>stop-service sysmonlog
    
    説明
    -----------
    このコマンドを実行すると、ローカル コンピューター上の Performance Logs and A
    lerts (SysmonLog) サービスが停止されます。
    
    -------------------------- 例 2 --------------------------
    
    C:\PS>get-service -displayname telnet | stop-service
    
    説明
    -----------
    このコマンドを実行すると、ローカル コンピューター上の Telnet サービスが停止
    されます。Get-Service コマンドレットを使用して、Telnet サービスを表すオブジ
    ェクトを取得しています。パイプライン演算子 (|) により、オブジェクトが Stop-S
    ervice コマンドレットに渡され、サービスが停止されます。
    
    -------------------------- 例 3 --------------------------
    
    C:\PS>get-service iisadmin | format-list -property name, dependentservices
    
    C:PS>stop-service iisadmin -force -confirm
    
    説明
    -----------
    この Stop-Service コマンドを実行すると、ローカル コンピューター上の IISAdmin 
    サービスが停止されます。このサービスを停止すると、IISAdmin サービスに依存する
    サービスも停止されるため、Stop-Service コマンドの前に、IISAdmin サービスに依
    存するサービスの一覧を表示するコマンドを実行することをお勧めします。
    
    最初のコマンドを実行すると、IISAdmin に依存するサービスの一覧が表示されます。
    Get-Service コマンドレットを使用して、IISAdmin サービスを表すオブジェクトを取
    得しています。パイプライン演算子 (|) により、結果が Format-List コマンドレッ
    トに渡されます。このコマンドは、Format-List の Property パラメーターを使用し
    て、サービスの Name プロパティと DependentServices プロパティだけを取り出しま
    す。
    
    2 番目のコマンドを実行すると、IISAdmin サービスが停止します。他のサービスが依
    存しているサービスを停止するには、Force パラメーターが必要です。このコマンド
    では、Confirm パラメーターを使用して、各サービスを停止する前にユーザーに確認
    することを指示します。
    
関連するリンク
    Online version: http://go.microsoft.com/fwlink/?LinkID=113414
    Get-Service 
    Suspend-Service 
    Start-Service 
    Restart-Service 
    Resume-Service 
    Set-Service 
    New-Service 
    	
記事で解説しているパソコンの環境
 基本ソフト: Windows 7
 キーワード: Windows PowerShell、ヘルプ、Cmdlet、Stop-Service
ご利用数: 1917536
感想・要望・問い合わせは こちら