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

入力

ServiceController

サービス オブジェクトをこのコマンドレットにパイプできます。

String

サービス名を含む文字列をこのコマンドレットにパイプできます。

出力

None

既定では、このコマンドレットは出力を返しません。

ServiceController

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 列に表示されます。