ローカルコンピュータとリモートコンピュータでオペレーティングシステムを再起動します。
構文
説明
Restart-Computerコマンドレットは、ローカルコンピュータとリモートコンピュータでオペレーティングシステムを再起動します。
Restart-Computerのパラメーターを使用して、再起動操作を実行し、認証レベルと代替資格情報を指定し、同時に実行される操作を制限し、即時再起動を強制
Windows PowerShell3.0以降では、nextcommandを実行する前に再起動が完了するのを待つことができます。 待機中のタイムアウトとクエリ間隔を指定し、再起動されたコンピューターで特定のサービスが利用可能になるまで待機します。 この機能により、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-ComputerGet-ContentテキストファイルDomain01からコンピュータ名のリストを取得するには、Pathパラメータを使用します。txt。 コンピュータ名はパイプラインの下に送信されます。 Restart-Computer各コンピュータを再起動します。
例4:テキストファイルにリストされているコンピューターの強制的な再起動
この例では、Domain01.txtファイルにリストされているコンピ テキストファイルからのコンピュータ名は変数に格納されます。 Forceパラメーターは、animmediateの再起動を強制します。
Get-Contentは、pathパラメータを使用して、テキストファイルDomain01からコンピュータ名のリストを取得します。txt。 コンピュータ名は変数$NamesGet-Credentialユーザー名とパスワードをpromptsyouし、変数$CredsRestart-Computerは、ComputerNameパラメーターとCredentialパラメーターを変数とともに使用します。 Forceparameterにより、各コンピューターが即座に再起動されます。
例6:リモートコンピューターを再起動し、PowerShellを待機します
Restart-Computerリモートコンピューターを再起動し、再起動したコンピューターでpowershellが使用可能になるまで最大5分(300秒)待機してから続行します。
Restart-Computer -ComputerName Server01 -Wait -For PowerShell -Timeout 300 -Delay 2Restart-ComputerComputernameパラメーターを使用してServer01を指定します。 Waitparameterは、再起動が完了するのを待ちます。 Forは、PowerShellがリモートコンピューターでコマンドを実行できることを指定します。 Timeoutパラメーターには、5分間の待機を指定します。 遅延パラメーターは、リモートコンピューターを二秒ごとに照会して、再起動されたかどうかを判断します。
例7:WsmanAuthenticationを使用してコンピューターを再起動します
Restart-ComputerWsmanAuthenticationメカニズムを使用してリモートコンピューターを再起動します。Kerberos認証は、現在のユーザーがremotecomputerを再起動する権限を持っているかどうかを決定します。 詳細については、”authenticationmechanism”を参照してください。
Restart-Computer -ComputerName Server01 -WsmanAuthentication KerberosRestart-ComputerComputerNameパラメーターを使用して、リモートコンピューター Server01を指定します。WsmanAuthenticationパラメーターは、認証方法をKerberosとして指定します。
パラメータ
コンピュータ名またはコンピュータ名のカンマ区切りの配列を指定します。 Restart-Computerパイプラインまたは変数からのacceptsComputerNameオブジェクト。
リモートコンピューターのNetBIOS名、IPアドレス、または完全修飾ドメイン名を入力します。 ローカルコンピューターを指定するには、コンピューター名、ドット.、またはlocalhostを入力します。
このパラメーターは、PowerShellリモート処理には依存しません。 コンピューターがリモートコマンドを実行するように構成されていない場合でも、ComputerNameパラメーターを使用できます。
ComputerNameパラメーターが指定されていない場合、Restart-Computerはローカルコンピューターを再起動します。
Prompts you for confirmation before running Restart-Computer.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters:/td> | False |
このアクションを実行する権限を持つユーザーアカウントを指定します。 デフォルトは現在のユーザーです。User01やDomain01\User01などのユーザー名を入力するか、Get-Credentialコマンドレットによって生成されたPSCredential objectgeneratedを入力します。 ユーザー名を入力すると、パスワードの入力を求められます。
資格情報はPSCredentialobjectに格納され、パスワードはSecureStringとして格納されます。
Note
For more information about SecureString data protection, seeHow secure is SecureString?.
| Type: | PSCredential |
| Position: | 1 |
| Default value: | Current user |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies the frequency of queries, in seconds. PowerShellは、コンピューターの再起動後にサービスが使用可能かどうかを判断するために、forパラメーターで指定されたサービスを照会します。
このパラメータは、WaitおよびForパラメータと一緒にのみ有効です。
このパラメーターは、Windows PowerShell3.0で導入されました。
遅延パラメータが指定されていない場合、Restart-Computerは五秒の遅延を使用します。
コンピュータの再起動後に指定されたサービスまたは機能が利用可能になるのを待 このパラメーターは、Waitパラメーターでのみ有効です。
このパラメーターの許容値は次のとおりです。
- デフォルト:PowerShellが再起動するのを待ちます。
- PowerShell:コンピューター上のPowerShellリモートセッションでコマンドを実行できます。
- WMI: コンピューターのWin32_Computersystemクエリへの応答を受け取ります。
- WinRM:WS-Managementを使用してコンピューターへのリモートセッションを確立できます。
このパラメーターは、Windows PowerShell3.0で導入されました。Tr>
Forces an immediate restart of the computer.
| Type: | SwitchParameter |
| Aliases: | f |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies the duration of the wait, in seconds. タイムアウトが経過すると、コンピュータが再起動されていなくても、Restart-Computerはコマンドプロンプトに戻ります。
TimeoutパラメータはWaitパラメータでのみ有効です。 タイムアウトは、waitパラメータの無期限の待機期間を上書きします。
このパラメーターは、Windows PowerShell3.0で導入されました。
Restart-ComputerPowerShellプロンプトを抑制し、コンピュータが起動するまでパイプラインをブロックします。 スクリプトでこのパラメーターを使用すると、コンピューターを再起動し、再起動が完了したときに処理を続行できます。
Waitパラメーターは、コンピューターが再起動するまで無期限に待機します。 TimeoutパラメーターとForパラメーターとDelayパラメーターを調整して、再起動されたコンピューターで特定のサービスが使用可能になるのを待つことができます。
ローカルコンピューターを再起動すると、Waitパラメーターが無効になります。 Computernameパラメーターの値にリモートコンピューターとローカルコンピューターの名前が含まれている場合、Restart-Computerは、ローカルコンピューターで待機するために終了しな
このパラメーターは、Windows PowerShell3.0で導入されました。p>
| タイプ: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Shows what would happen if the Restart-Computer runs. The Restart-Computer cmdlet isn’t run.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | 名前付き |
| デフォルト値： | False |
| パイプライン入力を受け入れる： | False |
| ワイルドカード文字を受け入れる： | False |
は、ユーザー資格情報の認証に使用されるメカニズムを指定します。 このパラメーターは、Windows PowerShell3.0で導入されました。
このパラメーターに使用できる値は、Basic、CredSSP、Default、Digest、Kerberos、およびNegotiateです。
詳細については、”authenticationmechanism”を参照してください。
Warning
Credential Security Service Provider(CredSSP)認証は、認証されるリモートコンピュータにユーザー資格情報が渡され、リモートネットワーク共有へのアクセスなど、複数のリソースに対する認 このメカニズムリモート操作のセキュリティリスクを増加させます。 リモートコンピュータが危険にさらされた場合、それに渡される認証情報を使用してネットワークセッションを制御できます。
| タイプ: | 文字列 |
| 受け入れられる値: | Basic, CredSSP, Default, Digest, Kerberos, Negotiate |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Inputs
String
Restart-Computer accepts computer names from the pipeline or variables.
Outputs
None
Restart-Computer doesn’t generate any output.
ノート
- Windowsでは、
Restart-Computerは、Windows Management Instrumentation(WMI)Win32_OperatingsystemclassのWin32Shutdownメソッドを使用します。 この方法では、マシンを再起動するために使用されるユーザーアカウントに対してSeShutdownPrivilege権限を有効にする必要があります。LinuxおよびMac OSでは、Restart-Computer/sbin/shutdownbashツールを使用します。Windowsリモート管理について - Get-Credential
- WS-Management Protocol