Resume-Service
中断 (一時停止) 中のサービスを 1 つ以上再開します。
構文
Resume-Service
[-InputObject] <ServiceController[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Resume-Service
[-Name] <String[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Resume-Service
[-PassThru]
-DisplayName <String[]>
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Resume-Service
コマンドレットは、指定された各サービスの再開メッセージを Windows サービス コントローラーに送信します。 サービスが中断されると、再開されます。 現在実行中の場合、メッセージは無視されます。 サービスをサービス名または表示名で指定することも、 InputObject パラメーターを使用して、再開するサービスを表すサービス オブジェクトを渡すことができます。
例
例 1: ローカル コンピューターでサービスを再開する
PS C:\> Resume-Service "sens"
このコマンドは、ローカル コンピューターでシステム イベント通知サービスを再開します。 サービス名は、コマンド内で sens によって表されます。 このコマンドでは、 Name パラメーターを使用してサービスのサービス名を指定しますが、パラメーター名は省略可能であるため、このコマンドはパラメーター名を省略します。
例 2: 中断されているすべてのサービスを再開する
PS C:\> Get-Service | Where-Object {$_.Status -eq "Paused"} | Resume-Service
このコマンドは、コンピューター上のすべての中断されたサービスを再開します。 Get-Service
コマンドレット コマンドは、コンピューター上のすべてのサービスを取得します。 パイプライン演算子 (|
) は、結果を Where-Object
コマンドレットに渡します。このコマンドレットは、Paused の Status プロパティを持つサービスを選択します。 次のパイプライン 演算子は結果を Resume-Service
に送信し、一時停止されたサービスを再開します。
実際には、コマンドを実行する前に WhatIf パラメーターを使用して、コマンドの効果を確認します。
パラメーター
-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 |
-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 |
ワイルドカード文字を受け取る: | False |
-PassThru
サービスを表すオブジェクトを返します。 既定では、このコマンドレットによる出力はありません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
サービス オブジェクトをこのコマンドレットにパイプできます。
サービス名を含む文字列をこのコマンドレットにパイプできます。
出力
None
既定では、このコマンドレットは出力を返しません。
PassThru パラメーターを使用すると、このコマンドレットは再開されたサービスを表すServiceController オブジェクトを返します。
メモ
- 中断されたサービスの状態は一時停止されています。 サービスが再開されると、サービスの状態は [実行中] になります。
Resume-Service
は、現在のユーザーがこれを行うアクセス許可を持っている場合にのみ、サービスを制御できます。 コマンドが正常に機能しない場合は、必要なアクセス許可が与えられていない可能性があります。- システム上のサービス名と表示名を検索するには、「
Get-Service
」と入力します。 サービス名は Name 列に表示され、表示名は DisplayName 列に表示されます。
関連リンク
PowerShell