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>]
説明
このコマンドレットは、Windows プラットフォームでのみ使用できます。
コマンドレットは 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
送信します。このコマンドレットでは、状態が stopped のサービスのみが選択されます。 別のパイプライン 演算子は、選択したサービスを に Restart-Service
送信します。
実際には、 WhatIf パラメーターを使用して、実行する前にコマンドの効果を判断します。
パラメーター
-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 |
-Force
ユーザーに確認せずに、直ちにコマンドを実行します。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-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
再起動するサービスのサービス名を指定します。
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 プラットフォームでのみ使用できます。
Restart-Service
は、現在のユーザーがこれを行うアクセス許可を持っている場合にのみサービスを制御できます。 コマンドが正常に機能しない場合は、必要なアクセス許可が与えられていない可能性があります。- システム上のサービス名と表示名を検索するには、「」と入力します
Get-Service
。 サービス名は [名前] 列に表示され、表示名は DisplayName 列に表示されます。