Stop-Service
実行中の 1 つ以上のサービスを停止します。
構文
Stop-Service
[-Force]
[-NoWait]
[-InputObject] <ServiceController[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Stop-Service
[-Force]
[-NoWait]
[-Name] <String[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Stop-Service
[-Force]
[-NoWait]
[-PassThru]
-DisplayName <String[]>
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Stop-Service
コマンドレットは、指定された各サービスの停止メッセージを Windows サービス コントローラーに送信します。 サービス名または表示名でサービスを指定することも、InputObject パラメーターを使用して、停止するサービスを表すサービス オブジェクトを渡すことができます。
例
例 1: ローカル コンピューターでサービスを停止する
PS C:\> Stop-Service -Name "sysmonlog"
このコマンドは、ローカル コンピューター上のパフォーマンス ログとアラート (SysmonLog) サービスを停止します。
例 2: 表示名を使用してサービスを停止する
PS C:\> Get-Service -DisplayName "telnet" | Stop-Service
このコマンドは、ローカル コンピューター上の Telnet サービスを停止します。 このコマンドは、Get-Service
を使用して、Telnet サービスを表すオブジェクトを取得します。 パイプライン演算子 (|
) は、サービスを停止する Stop-Service
にオブジェクトをパイプ処理します。
例 3: 依存サービスを持つサービスを停止する
PS C:\> Get-Service -Name "iisadmin" | Format-List -Property Name, DependentServices
PS C:\> Stop-Service -Name "iisadmin" -Force -Confirm
次の使用例は、ローカル コンピューターの IISAdmin サービスを停止します。 このサービスを停止すると、IISAdmin サービスに依存するサービスも停止するため、Stop-Service
の前に IISAdmin サービスに依存するサービスを一覧表示するコマンドを使用することをお勧めします。
最初のコマンドは、IISAdmin に依存するサービスを一覧表示します。
Get-Service
を使用して、IISAdmin サービスを表すオブジェクトを取得します。 パイプライン演算子 (|
) は、結果を Format-List
コマンドレットに渡します。 このコマンドでは、Format-List
の Property パラメーターを使用して、サービスの Name プロパティと DependentServices プロパティのみを一覧表示します。
2 番目のコマンドは IISAdmin サービスを停止します。 依存サービスを持つサービスを停止するには、Force パラメーターが必要です。 コマンドは、Confirm パラメーターを使用して、各サービスを停止する前にユーザーに確認を要求します。
パラメーター
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DisplayName
停止するサービスの表示名を指定します。 ワイルドカード文字を使用できます。
型: | String[] |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | True |
-Exclude
このコマンドレットが省略するサービスを指定します。 このパラメーターの値は、Name パラメーターを修飾します。 名前要素またはパターン (s* など) を入力します。 ワイルドカード文字を使用できます。
型: | String[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | True |
-Force
そのサービスに依存するサービスがある場合でも、コマンドレットにサービスの停止を強制します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Include
このコマンドレットが停止するサービスを指定します。 このパラメーターの値は、Name パラメーターを修飾します。 名前要素またはパターン (s* など) を入力します。 ワイルドカード文字を使用できます。
型: | String[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | True |
-InputObject
停止するサービス 表す ServiceController オブジェクトを指定します。 オブジェクトを含む変数を入力するか、オブジェクトを取得するコマンドまたは式を入力します。
型: | ServiceController[] |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Name
停止するサービスのサービス名を指定します。 ワイルドカード文字を使用できます。
型: | String[] |
Aliases: | ServiceName |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | True |
-NoWait
このコマンドレットが no wait オプションを使用することを示します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-PassThru
サービスを表すオブジェクトを返します。 既定では、このコマンドレットは出力を生成しません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
サービス オブジェクトをこのコマンドレットにパイプできます。
サービスの名前を含む文字列をこのコマンドレットにパイプできます。
出力
None
既定では、このコマンドレットは出力を返しません。
PassThru パラメーターを使用すると、このコマンドレットはサービスを表す ServiceController オブジェクトを返します。
メモ
Windows PowerShell には、Stop-Service
の次のエイリアスが含まれています。
spsv
Stop-Service
は、現在のユーザーがこれを行うアクセス許可を持っている場合にのみサービスを制御できます。 コマンドが正しく機能しない場合は、必要なアクセス許可がない可能性があります。
システム上のサービス名と表示名を検索するには、「Get-Service
」と入力します。 サービス名は Name 列に表示され、表示名は DisplayName 列に表示されます。
関連リンク
PowerShell