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