次の方法で共有


Restart-Service

1 つ以上のサービスを停止し、再起動します。

構文

InputObject (既定)

Restart-Service
    [-InputObject] <ServiceController[]>
    [-Force]
    [-PassThru]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Default

Restart-Service
    [-Name] <String[]>
    [-Force]
    [-PassThru]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

DisplayName

Restart-Service
    -DisplayName <String[]>
    [-Force]
    [-PassThru]
    [-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

コマンドレットを実行する前に確認を求めるメッセージが表示されます。

パラメーターのプロパティ

型:SwitchParameter
規定値:False
ワイルドカードのサポート:False
DontShow:False
Aliases:cf

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-DisplayName

再起動するサービスの表示名を指定します。 ワイルドカード文字を使用できます。

パラメーターのプロパティ

型:

String[]

規定値:None
ワイルドカードのサポート:True
DontShow:False

パラメーター セット

DisplayName
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Exclude

このコマンドレットが省略するサービスを指定します。 このパラメーターの値は、Name パラメーターを修飾します。 名前要素またはパターン (s* など) を入力します。 ワイルドカード文字を使用できます。

パラメーターのプロパティ

型:

String[]

規定値:None
ワイルドカードのサポート:True
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Force

ユーザーの確認を求めずにコマンドを強制的に実行します。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Include

このコマンドレットが再起動するサービスを指定します。 このパラメーターの値は、Name パラメーターを修飾します。 名前要素またはパターン (s* など) を入力します。 ワイルドカード文字を使用できます。

パラメーターのプロパティ

型:

String[]

規定値:None
ワイルドカードのサポート:True
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-InputObject

再起動するサービス 表す ServiceController オブジェクトを指定します。 オブジェクトを含む変数を入力するか、オブジェクトを取得するコマンドまたは式を入力します。

パラメーターのプロパティ

型:

ServiceController[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

InputObject
配置:0
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Name

再起動するサービスのサービス名を指定します。

パラメーターのプロパティ

型:

String[]

規定値:None
ワイルドカードのサポート:True
DontShow:False
Aliases:サービス名

パラメーター セット

Default
配置:0
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-PassThru

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

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

パラメーターのプロパティ

型:SwitchParameter
規定値:False
ワイルドカードのサポート:False
DontShow:False
Aliases:ウィスコンシン

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

入力

ServiceController

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

String

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

出力

None

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

ServiceController

PassThru パラメーターを使用すると、このコマンドレットは、再起動されたサービスを表す ServiceController オブジェクトを返します。

メモ

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

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