Restart-Computer

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

Restart-Computer
    [[-ComputerName] <String[]>]
    [[-Credential] <PSCredential>]
    [-AsJob]
    [-DcomAuthentication <AuthenticationLevel>]
    [-Impersonation <ImpersonationLevel>]
    [-Force]
    [-ThrottleLimit <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

这个 Restart-Computer cmdlet 在本地和远程计算机上重启操作系统。

可以使用 Restart-Computer 的参数将重启操作作为后台作业运行、指定身份验证级别和备用凭据、限制同时运行的操作以及强制立即重启。

从 Windows PowerShell 3.0 开始，可以等待重启完成，然后再运行下一个命令。 指定等待超时和查询间隔，并等待特定服务在重启的计算机上可用。 此功能使在脚本和函数中使用 Restart-Computer 变得实用。

可以使用 WS-Management （WSMan） 协议重启计算机，以防分布式组件对象模型 （DCOM） 调用被阻止，例如企业防火墙。 有关详细信息，请参阅 WS-Management 协议。

仅当你在命令中使用 AsJob 参数时，此 cmdlet 才需要 Windows PowerShell 远程处理。

Restart-Computer 重启本地计算机。

Restart-Computer

Restart-Computer 可以重启远程计算机和本地计算机。 ComputerName 参数接受计算机名称数组。

Restart-Computer -ComputerName Server01, Server02, localhost

这些命令在两台远程计算机上以后台作业的形式运行 Restart-Computer 命令，然后获取结果。

由于 AsJob 在本地计算机上创建作业，并自动将结果返回到本地计算机，因此可以将 Receive-Job 作为本地命令运行。

$Job = Restart-Computer -ComputerName "Server01", "Server02" -AsJob
$Job | Receive-Job

Restart-Computer 使用 ComputerName 参数指定 Server01 和 Server02。 AsJob 参数将命令作为后台作业运行。 作业对象存储在 $Job 变量中。 $Job 将管道向下发送到获取结果的 Receive-Job cmdlet。

Restart-Computer 重启具有自定义模拟和身份验证设置的远程计算机。

Restart-Computer -ComputerName Server01 -Impersonation Anonymous -DcomAuthentication PacketIntegrity

Restart-Computer 使用 ComputerName 参数来指定 Server01。 模拟 参数指定匿名以隐藏请求者的标识。 DcomAuthentication 参数将 PacketIntegrity 指定为连接的身份验证级别。

此示例强制立即重启 Domain01.txt 文件中列出的计算机。 文本文件中的计算机名称存储在变量中。 Force 参数强制立即重启，ThrottleLimit 参数限制并发连接数。

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

Get-Content 使用 Path 参数从文本文件中获取计算机名称列表，Domain01.txt。 计算机名称存储在变量 $Names中。 Get-Credential 提示输入用户名和密码，并将值存储在变量 $Creds中。 Restart-Computer 使用 ComputerName 和 Credential 参数及其变量。 Force 参数会导致立即重启每台计算机。 ThrottleLimit 参数将命令限制为 10 个并发连接。

Restart-Computer 重启远程计算机，然后等待最多 5 分钟（300 秒）让 PowerShell 在重启的计算机上可用，然后再继续。

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

Restart-Computer 使用 ComputerName 参数来指定 Server01。 Wait 参数等待重启完成。 For 指定 PowerShell 可以在远程计算机上运行命令。 Timeout 参数指定五分钟的等待。 Delay 参数每隔两秒查询远程计算机，以确定它是否已重启。

Restart-Computer 使用 WSMan 协议而不是默认的 DCOM 重启远程计算机。 Kerberos 身份验证确定当前用户是否有权重启远程计算机。

这些设置专为基于 DCOM 的重启失败的企业设计，因为 DCOM 被阻止。 例如，防火墙。

Restart-Computer -ComputerName Server01 -Protocol WSMan -WsmanAuthentication Kerberos

Restart-Computer 使用 ComputerName 参数来指定远程计算机，Server01。 Protocol 参数指定使用 WSMan 协议。 WsmanAuthentication 参数将身份验证方法指定为 Kerberos。

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

可以通过管道将包含计算机名称的字符串传递给此 cmdlet。

默认情况下，此 cmdlet 不返回任何输出。

使用 AsJob 参数时，此 cmdlet 将返回作业对象。

• Restart-Computer 仅适用于运行 Windows 的计算机，并且需要 WinRM 和 WMI 关闭系统，包括本地系统。
• Restart-Computer 使用 Windows Management Instrumentation （WMI） Win32_OperatingSystem 类的 Win32Shutdown 方法。 此方法要求为用于重启计算机的用户帐户启用 SeShutdownPrivilege 特权。

在 Windows PowerShell 2.0 中，AsJob 参数在重启或停止远程计算机时无法可靠地工作。 在 Windows PowerShell 3.0 中，实现已更改以解决此问题。