Restart-Service
1 つ以上のサービスを停止してから開始します。
構文
Restart-Service
[-Force]
[-InputObject] <ServiceController[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Restart-Service
[-Force]
[-Name] <String[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Restart-Service
[-Force]
[-PassThru]
-DisplayName <String[]>
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]説明
Restart-Service コマンドレットは、指定したサービスの Windows サービス コントローラーに停止メッセージを送信し、次に開始メッセージを送信します。 サービスが既に停止されている場合は、エラーを通知せずに開始されます。 サービスをサービス名または表示名で指定することも、InputObject パラメーターを使用して、再起動する各サービスを表すオブジェクトを渡すことができます。
例
例 1: ローカル コンピューターでサービスを再起動する
PS C:\> Restart-Service -Name winmgmtこのコマンドは、ローカル コンピューター上の Windows Management Instrumentation サービス (WinMgmt) を再起動します。
例 2: サービスを除外する
PS C:\> Restart-Service -DisplayName "net*" -Exclude "net logon"このコマンドは、Net ログオン サービスを除き、Net で始まる表示名を持つサービスを再起動します。
例 3: 停止したすべてのネットワーク サービスを開始する
PS C:\> Get-Service -Name "net*" | Where-Object {$_.Status -eq "Stopped"} | Restart-Serviceこのコマンドは、コンピューター上で停止されているすべてのネットワーク サービスを開始します。
このコマンドでは、Get-Service コマンドレットを使用して、サービス名が net で始まるサービスを表すオブジェクトを取得します。 パイプライン演算子 (|) は、サービス オブジェクトを Where-Object コマンドレットに送信し、状態が停止しているサービスのみを選択します。 別のパイプライン オペレーターは、選択したサービスを Restart-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 |
-Force
ユーザーの確認を求めずにコマンドを強制的に実行します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-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 |
| ワイルドカード文字を受け取る: | True |
-PassThru
サービスを表すオブジェクトを返します。 既定では、このコマンドレットは出力を生成しません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
System.ServiceProcess.ServiceController, System.String
サービス オブジェクトまたはサービス名を含む文字列をこのコマンドレットにパイプできます。
出力
None, System.ServiceProcess.ServiceController
このコマンドレットは、PassThru パラメーターを指定した場合、再起動されたサービスを表す System.ServiceProcess.ServiceController オブジェクトを生成します。 それ以外の場合、このコマンドレットは出力を生成しません。
メモ
- Restart-Service は、現在のユーザーがこれを行うアクセス許可を持っている場合にのみ、サービスを制御できます。 コマンドが正しく機能しない場合は、必要なアクセス許可がない可能性があります。
- システム上のサービス名とサービスの表示名を検索するには、「 Get-Service」と入力します。 サービス名は Name 列に表示され、表示名は DisplayName 列に表示されます。