Suspend-Service
実行中の 1 つ以上のサービスを中断 (一時停止) します。
構文
InputObject (既定)
Suspend-Service
[-InputObject] <ServiceController[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Default
Suspend-Service
[-Name] <String[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
DisplayName
Suspend-Service
-DisplayName <String[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
このコマンドレットは、Windows プラットフォームでのみ使用できます。
Suspend-Service
コマンドレットは、指定された各サービスの中断メッセージを Windows サービス コントローラーに送信します。 一時停止中、サービスはまだ実行中ですが、Resume-Service
コマンドレットを使用するなどして、再開されるまでそのアクションは停止されます。 サービスは、サービス名または表示名で指定することも、InputObject パラメーターを使用して、中断するサービスを表すサービス オブジェクトを渡すことができます。
例
例 1: サービスを中断する
Suspend-Service -DisplayName "Telnet"
このコマンドは、ローカル コンピューター上の Telnet サービス (Tlntsvr) サービスを中断します。
例 2: サービスを中断した場合の処理を表示する
Suspend-Service -Name lanman* -WhatIf
このコマンドは、lanman で始まるサービス名を持つサービスを中断した場合に何が起こるかを示します。 サービスを中断するには、WhatIf パラメーターを指定せずにコマンドを再実行します。
例 3: サービスを取得して中断する
Get-Service schedule | Suspend-Service
このコマンドは、Get-Service
コマンドレットを使用して、コンピューター上のタスク スケジューラ (スケジュール) サービスを表すオブジェクトを取得します。 パイプライン 演算子 (|
) は結果を Suspend-Service
に渡し、サービスを中断します。
例 4: 中断できるすべてのサービスを中断する
Get-Service |
Where-Object {$_.CanPauseAndContinue -eq "True"} |
Suspend-Service -Confirm
このコマンドは、中断可能なコンピューター上のすべてのサービスを中断します。
Get-Service
を使用して、コンピューター上のサービスを表すオブジェクトを取得します。 パイプライン演算子は結果を Where-Object
コマンドレットに渡します。このコマンドレットでは、$true
プロパティの値が のサービスのみが選択されます。 別のパイプライン演算子が結果を Suspend-Service
に渡します。
Confirm パラメーターは、各サービスを中断する前に確認を求められます。
パラメーター
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
パラメーターのプロパティ
型: | SwitchParameter |
規定値: | False |
ワイルドカードのサポート: | False |
DontShow: | False |
Aliases: | cf |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-DisplayName
中断するサービスの表示名を指定します。 ワイルドカード文字を使用できます。
パラメーターのプロパティ
型: | String[] |
規定値: | None |
ワイルドカードのサポート: | True |
DontShow: | False |
パラメーター セット
DisplayName
配置: | Named |
必須: | True |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Exclude
指定したサービスから省略するサービスを指定します。 このパラメーターの値は、Name パラメーターを修飾します。 "s*" などの名前要素またはパターンを入力します。 ワイルドカード文字を使用できます。
パラメーターのプロパティ
型: | String[] |
規定値: | None |
ワイルドカードのサポート: | True |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Include
中断するサービスを指定します。 このパラメーターの値は、Name パラメーターを修飾します。 "s*" などの名前要素またはパターンを入力します。 ワイルドカード文字を使用できます。
パラメーターのプロパティ
型: | String[] |
規定値: | None |
ワイルドカードのサポート: | True |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-InputObject
中断するサービス 表す ServiceController オブジェクトを指定します。 オブジェクトを含む変数を入力するか、オブジェクトを取得するコマンドまたは式を入力します。
パラメーターのプロパティ
型: | |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
InputObject
配置: | 0 |
必須: | True |
パイプラインからの値: | True |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Name
中断するサービスのサービス名を指定します。 ワイルドカード文字を使用できます。
パラメーター名は省略可能です。 名前 もしくはそのエイリアス ServiceNameを使用するか、またはパラメーター名を省略することもできます。
パラメーターのプロパティ
型: | String[] |
規定値: | None |
ワイルドカードのサポート: | True |
DontShow: | False |
Aliases: | サービス名 |
パラメーター セット
Default
配置: | 0 |
必須: | True |
パイプラインからの値: | True |
プロパティ名別のパイプラインからの値: | True |
残りの引数からの値: | False |
-PassThru
作業中のアイテムを表すオブジェクトを返します。 既定では、このコマンドレットは出力を生成しません。
パラメーターのプロパティ
型: | SwitchParameter |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。
パラメーターのプロパティ
型: | SwitchParameter |
規定値: | False |
ワイルドカードのサポート: | False |
DontShow: | False |
Aliases: | ウィスコンシン |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
入力
ServiceController
サービス オブジェクトをこのコマンドレットにパイプできます。
String
サービス名を含む文字列をこのコマンドレットにパイプできます。
出力
None
既定では、このコマンドレットは出力を返しません。
ServiceController
PassThru パラメーターを使用すると、このコマンドレットはサービスを表す ServiceController オブジェクトを返します。
メモ
このコマンドレットは、Windows プラットフォームでのみ使用できます。
-
Suspend-Service
は、現在のユーザーがこれを行うアクセス許可を持っている場合にのみサービスを制御できます。 コマンドが正しく機能しない場合は、必要なアクセス許可がない可能性があります。 -
Suspend-Service
は、中断および再開をサポートするサービスのみを中断できます。 特定のサービスを中断できるかどうかを判断するには、Get-Service
コマンドレットを canPauseAndContinue プロパティ と共に使用します。 たとえば、Get-Service wmi | Format-List Name, CanPauseAndContinue
のようにします。 中断できるコンピューター上のすべてのサービスを検索するには、「Get-Service | Where-Object {$_.CanPauseAndContinue -eq $true}
」と入力します。 - システム上のサービス名と表示名を検索するには、「
Get-Service
」と入力します。 サービス名は Name 列に表示され、表示名は DisplayName 列に表示されます。