Restart-Computer

構文

Restart-Computer
       [-WsmanAuthentication <String>]
       [[-ComputerName] <String[]>]
       [[-Credential]<PSCredential>]
       [-Force]
       [-Wait]
       [-Timeout <Int32>]
       [-For <WaitForServiceTypes>]
       [-Delay <Int16>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

説明

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

Restart-Computer コマンドレットは、ローカル コンピューターとリモート コンピューター上のオペレーティング システムを再起動します。

Restart-Computerのパラメーターを使用して、再起動操作を実行したり、認証レベルと代替資格情報を指定したり、同時に実行する操作を制限したり、即時再起動を強制したりできます。

Windows PowerShell 3.0 以降では、再起動が完了するまで待ってから次のコマンドを実行できます。 待機タイムアウトとクエリ間隔を指定し、再起動されたコンピューターで特定のサービスが使用可能になるまで待機します。 この機能により、スクリプトや関数で Restart-Computer を使用することが実用的になります。

例

例 1: ローカル コンピューターを再起動する

Restart-Computer はローカル コンピューターを再起動します。

Restart-Computer

例 2: 複数のコンピューターを再起動する

Restart-Computer リモート コンピューターとローカル コンピューターを再起動できます。 ComputerName パラメーターは、コンピューター名の配列を受け入れます。

Restart-Computer -ComputerName Server01, Server02, localhost

例 3: テキスト ファイルからコンピューター名を取得する

Restart-Computer は、テキスト ファイルからコンピューター名の一覧を取得し、コンピューターを再起動します。 ComputerName パラメーターが指定されていません。 ただし、これは最初の位置パラメーターであるため、パイプラインから送信されるテキスト ファイルのコンピューター名を受け入れます。

Get-Content -Path C:\Domain01.txt | Restart-Computer

Get-Content では、 Path パラメーターを使用して、テキスト ファイル ( Domain01.txt) からコンピューター名の一覧を取得します。 コンピューター名はパイプラインに送信されます。 Restart-Computer は、各コンピューターを再起動します。

例 4: テキスト ファイルに一覧表示されているコンピューターの強制的な再起動

次の使用例は、 Domain01.txt ファイルに一覧表示されているコンピューターを強制的に再起動します。 テキスト ファイルのコンピューター名は変数に格納されます。 Force パラメーターは、直ちに再起動を強制します。

$Names = Get-Content -Path C:\Domain01.txt
$Creds = Get-Credential
Restart-Computer -ComputerName $Names -Credential $Creds -Force

Get-Content では、 Path パラメーターを使用して、テキスト ファイル ( Domain01.txt) からコンピューター名の一覧を取得します。 コンピューター名は変数 $Namesに格納されます。 Get-Credential は、ユーザー名とパスワードの入力を求め、変数 $Credsに値を格納します。 Restart-Computer は、 ComputerName および Credential パラメーターを変数と共に使用します。 Force パラメーターを指定すると、各コンピューターが直ちに再起動されます。

例 6: リモート コンピューターを再起動し、PowerShell を待機する

Restart-Computer はリモート コンピューターを再起動し、再起動されたコンピューターで PowerShell が使用できるようになるまで最大 5 分 (300 秒) 待機してから続行します。

Restart-Computer -ComputerName Server01 -Wait -For PowerShell -Timeout 300 -Delay 2

Restart-Computer では、 ComputerName パラメーターを使用して Server01 を指定します。 Wait パラメーターは、再起動が完了するまで待機します。 Forは、PowerShell がリモート コンピューターでコマンドを実行できることを指定します。 Timeout パラメーターは、5 分間の待機を指定します。 Delay パラメーターは、リモート コンピューターを 2 秒ごとに照会して、再起動されたかどうかを判断します。

例 7: WsmanAuthentication を使用してコンピューターを再起動する

Restart-Computer は、 WsmanAuthentication メカニズムを使用してリモート コンピューターを再起動します。 Kerberos 認証は、現在のユーザーがリモート コンピューターを再起動するアクセス許可を持っているかどうかを決定します。 詳細については、「 AuthenticationMechanismを参照してください。

Restart-Computer -ComputerName Server01 -WsmanAuthentication Kerberos

Restart-Computer は、 ComputerName パラメーターを使用して、リモート コンピューターである Server01 を指定します。 WsmanAuthentication パラメーターは、認証方法を Kerberos として指定します。

パラメーター

-ComputerName

-Confirm

-Credential

-Delay

-For

-Force

-Timeout

-Wait

-WhatIf

-WsmanAuthentication

入力

String

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

出力

None

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

メモ

• Windows では、Restart-Computerは Windows Management Instrumentation (WMI) Win32_OperatingSystem クラスのWin32Shutdown メソッドを使用します。 この方法では、コンピューターの再起動に使用するユーザー アカウントに対して SeShutdownPrivilege 権限を有効にする必要があります。
• Linux および Mac OS では、 Restart-Computer は /sbin/shutdown bash ツールを使用します。

関連リンク

• Windows リモート管理について
• Get-Credential
• WS-Management Protocol (WS-Management プロトコル)