実行中の 1 つ以上のサービスを中断 (一時停止) します。

構文

Suspend-Service [-Name] <string[]> [-Exclude <string[]>] [-Include <string[]>] [-PassThru] [-確認] [-WhatIf] [<CommonParameters>]

Suspend-Service -DisplayName <string[]> [-Exclude <string[]>] [-Include <string[]>] [-PassThru] [-確認] [-WhatIf] [<CommonParameters>]

Suspend-Service [-InputObject <ServiceController[]>] [-Exclude <string[]>] [-Include <string[]>] [-PassThru] [-確認] [-WhatIf] [<CommonParameters>]

説明

Suspend-Service コマンドレットは、ユーザーが指定した各サービスについて、Windows サービス コントローラーに中断メッセージを送ります。中断中でもサービスは実行状態のままですが、Resume-Service を使用するなどして再開するまでは、その動作は停止されます。サービスはサービス名または表示名で指定するか、InputObject パラメーターを使用して、中断するサービスを表すサービス オブジェクトを渡します。

パラメーター

-DisplayName <string[]>

中断するサービスの表示名を指定します。ワイルドカードを使用できます。

必須

true

位置

named

既定値

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-Exclude <string[]>

指定されたサービスを除外します。このパラメーターの値は、Name パラメーターを修飾します。"s*" などの名前要素またはパターンを入力します。ワイルドカードを使用できます。

必須

false

位置

named

既定値

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-Include <string[]>

指定したサービスだけを中断します。このパラメーターの値は、Name パラメーターを修飾します。"s*" などの名前要素またはパターンを入力します。ワイルドカードを使用できます。

必須

false

位置

named

既定値

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-InputObject <ServiceController[]>

中断するサービスを表す ServiceController オブジェクトを指定します。オブジェクトが格納されている変数を入力するか、オブジェクトを取得するコマンドまたは式を入力します。

必須

false

位置

named

既定値

パイプライン入力を許可する

true (ByValue)

ワイルドカード文字を許可する

false

-Name <string[]>

中断するサービスのサービス名を指定します。ワイルドカードを使用できます。

パラメーター名は省略可能です。Name またはそのエイリアスである ServiceName を使用するか、パラメーター名を省略することができます。

必須

true

位置

1

既定値

パイプライン入力を許可する

true (ByValue, ByPropertyName)

ワイルドカード文字を許可する

false

-PassThru

サービスを表すオブジェクトを返します。既定では、このコマンドレットによる出力はありません。

必須

false

位置

named

既定値

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-確認

コマンドを実行する前に確認メッセージを表示します。

必須

false

位置

named

既定値

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-WhatIf

実際にコマンドを実行せずに、コマンドを実行すると何が起きるかを出力します。

必須

false

位置

named

既定値

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

<CommonParameters>

このコマンドレットは、次の共通パラメーターをサポートします: -Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、および -OutVariable。Ô”¼š¤Ë¤Ä¤¤¤Æ¤Ï¡¢次を参照してください: about_Commonparameters.

入力と出力

入力値の型は、コマンドレットへのパイプが可能なオブジェクトの型です。戻り値の型は、コマンドレットによって返されるオブジェクトの型です。

入力

System.ServiceProcess.ServiceController または System.String

パイプを使用してサービス オブジェクトまたはサービス名を含む文字列を Suspend-Service に渡すことができます。

出力

なし、または System.ServiceProcess.ServiceController

PassThru パラメーターを使用すると、Suspend-Service はサービスを表す System.ServiceProcess.ServiceController オブジェクトを生成します。それ以外の場合、このコマンドレットによる出力はありません。

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

例 1

C:\PS>suspend-service -displayname "Telnet"

説明
-----------
このコマンドを実行すると、ローカル コンピューター上の Telnet サービス (Tlntsvr) が中断されます。






例 2

C:\PS>suspend-service -name lanman* -whatif

説明
-----------
このコマンドを実行すると、名前が "lanman" で始まるサービスを中断した場合、どのような結果になるかが表示されます。サービスを中断するには、WhatIf パラメーターなしでコマンドを再度実行します。






例 3

C:\PS>get-service schedule | suspend-service

説明
-----------
このコマンドは、Get-Service コマンドレットを使用して、コンピューター上の Task Scheduler (Schedule) サービスを表すオブジェクトを取得します。パイプライン演算子 (|) により、結果が Suspend-Service コマンドレットに渡され、サービスが中断されます。






例 4

C:\PS>get-service | where-object {$_.canpauseandcontinue -eq "True"} | suspend-service -confirm

説明
-----------
このコマンドを実行すると、コンピューター上の中断可能なすべてのサービスが中断されます。このコマンドは、Get-Service コマンドレットを使用して、コンピューター上のサービスを表すオブジェクトを取得します。パイプライン演算子 (|) により、結果が Where-Object コマンドレットに渡され、CanPauseAndContinue プロパティの値が True のサービスだけが選択されます。もう一つのパイプライン演算子は、結果を Suspend-Service コマンドレットに渡します。Confirm パラメーターがあることで、各サービスを中断する前に確認メッセージが表示されます。






関連項目




目次