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 コマンドレットに送信します。このコマンドレットでは、状態が停止しているサービスのみが選択されます。 別のパイプライン演算子は、選択したサービスを に 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

入力

ServiceController

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

String

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

出力

None

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

ServiceController

PassThru パラメーターを使用すると、再起動されたサービスを表す ServiceController オブジェクトが返されます。

メモ

このコマンドレットは、Windows プラットフォームでのみ使用できます。

  • Restart-Service は、現在のユーザーがこれを行うアクセス許可を持っている場合にのみ、サービスを制御できます。 コマンドが正常に機能しない場合は、必要なアクセス許可が与えられていない可能性があります。
  • システム上のサービス名と表示名を検索するには、「」と入力 Get-Serviceします。 サービス名は [名前] 列に表示され、表示名は DisplayName 列に表示されます。