Restart-Computer
在本地和远程计算机上重启操作系统。
语法
Restart-Computer
[[-ComputerName] <string[]>]
[[-Credential] <pscredential>]
[-DcomAuthentication <AuthenticationLevel>]
[-Impersonation <ImpersonationLevel>]
[-WsmanAuthentication <string>]
[-Protocol <string>]
[-Force]
[-Wait]
[-Timeout <int>]
[-For <WaitForServiceTypes>]
[-Delay <int16>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Restart-Computer
[[-ComputerName] <string[]>]
[[-Credential] <pscredential>]
[-AsJob]
[-DcomAuthentication <AuthenticationLevel>]
[-Impersonation <ImpersonationLevel>]
[-Force]
[-ThrottleLimit <int>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
说明
cmdlet Restart-Computer
在本地和远程计算机上重启操作系统。
可以使用 的参数 Restart-Computer
将重启操作作为后台作业运行、指定身份验证级别和备用凭据、限制同时运行的操作以及强制立即重启。
从 Windows PowerShell 3.0 开始,可以等待重启完成,然后再运行下一个命令。 指定等待超时和查询间隔,并等待特定服务在重启的计算机上可用。 此功能使在脚本和函数中使用起来很实用 Restart-Computer
。
可以使用 WS-Management (WSMan) 协议来重启计算机,以防分布式组件对象模型 (DCOM) 调用被阻止(例如企业防火墙)。 有关详细信息,请参阅 WS-Management 协议。
只有在命令中使用了 AsJob 参数的情况下,此 cmdlet 才需要使用 Windows PowerShell 远程处理功能。
示例
示例 1:重启本地计算机
Restart-Computer
重启本地计算机。
Restart-Computer
示例 2:重启多台计算机
Restart-Computer
可以重启远程和本地计算机。 ComputerName 参数接受计算机名称数组。
Restart-Computer -ComputerName Server01, Server02, localhost
示例 3:将计算机作为后台作业重启
这些命令在两台远程计算机上作为后台作业运行 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。
示例 4:重启远程计算机
Restart-Computer
使用自定义模拟和身份验证设置重启远程计算机。
Restart-Computer -ComputerName Server01 -Impersonation Anonymous -DcomAuthentication PacketIntegrity
Restart-Computer
使用 ComputerName 参数指定 Server01。 Impersonation 参数指定 Anonymous 以隐藏请求者的标识。 DcomAuthentication 参数将 PacketIntegrity 指定为连接的身份验证级别。
示例 5:强制重启文本文件中列出的计算机
此示例强制立即重启文件中列出的 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 个并发连接。
示例 6:重启远程计算机并等待 PowerShell
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 参数每隔两秒查询一次远程计算机,以确定它是否已重启。
示例 7:使用 WSMan 协议重启计算机
Restart-Computer
使用 WSMan 协议(而不是默认的 DCOM)重启远程计算机。 Kerberos 身份验证确定当前用户是否有权重启远程计算机。
这些设置适用于由于 DCOM 被阻止而基于 DCOM 的重启失败的企业。 例如,通过防火墙。
Restart-Computer -ComputerName Server01 -Protocol WSMan -WsmanAuthentication Kerberos
Restart-Computer
使用 ComputerName 参数指定远程计算机 Server01。
Protocol 参数指定使用 WSMan 协议。 WsmanAuthentication 参数将身份验证方法指定为 Kerberos。
参数
-AsJob
指示 Restart-Computer
作为后台作业运行。
若要使用此参数,必须将本地计算机和远程计算机配置为远程处理。 在 Windows Vista 和更高版本的 Windows 操作系统上,必须使用 “以管理员身份运行” 选项打开 PowerShell。 有关详细信息,请参阅 about_Remote_Requirements。
指定 AsJob 参数时,该命令立即返回代表后台作业的对象。 当作业完成时,你可以继续在此会话中工作。 作业在本地计算机上创建,并且来自远程计算机的结果将自动返回本地计算机。 若要管理作业,可以使用 Job cmdlet。 若要获取作业结果,请使用 Receive-Job
cmdlet。
有关Windows PowerShell后台作业的详细信息,请参阅about_Jobs和about_Remote_Jobs。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ComputerName
指定一个计算机名称或逗号分隔的计算机名称数组。 Restart-Computer
接受管道或变量中的 ComputerName 对象。
键入远程计算机的 NetBIOS 名称、IP 地址或完全限定的域名。 若要指定本地计算机,请键入计算机名称、点 .
或 localhost。
此参数不依赖于 PowerShell 远程处理。 即使计算机未配置为运行远程命令,也可以使用 ComputerName 参数。
如果未指定 ComputerName 参数, Restart-Computer
则重启本地计算机。
Type: | String[] |
Aliases: | CN, __SERVER, Server, IPAddress |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
在运行 Restart-Computer
之前提示你进行确认。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
指定有权执行此操作的用户帐户。 键入用户名,例如 User01、Domain01\User01,或输入 cmdlet Get-Credential
生成的 PSCredential 对象。
如果未指定 Credential 参数, Restart-Computer
请使用当前用户的凭据。
Type: | PSCredential |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DcomAuthentication
指定用于 WMI 连接的身份验证级别。 Restart-Computer
使用 WMI。
有效值为:
- 呼叫:调用级 COM 身份验证
- 连接:连接级 COM 身份验证
- 默认值:Windows 身份验证
- 无:无 COM 身份验证
- 数据包:数据包级 COM 身份验证。
- PacketIntegrity:数据包完整性级别 COM 身份验证
- PacketPrivacy:数据包隐私级别 COM 身份验证。
- 未更改:身份验证级别与上一个命令相同。
有关详细信息,请参阅 AuthenticationLevel 枚举。
此参数是在 Windows PowerShell 3.0 中引入的。
Type: | AuthenticationLevel |
Aliases: | Authentication |
Accepted values: | Default, None, Connect, Call, Packet, PacketIntegrity, PacketPrivacy, Unchanged |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Delay
指定查询的频率(以秒为单位)。 PowerShell 查询 For 参数指定的服务,以确定重启计算机后该服务是否可用。
此参数仅与 Wait 和 For 参数一起有效。
已在 Windows PowerShell 3.0 中引入了此参数。
如果未指定 Delay 参数, Restart-Computer
则使用 5 秒延迟。
Type: | Int16 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-For
指定 PowerShell 在计算机重启后等待指定的服务或功能可用时的行为。 此参数仅对 Wait 参数有效。
此参数的可接受值为:
- 默认值:等待 PowerShell 重启。
- PowerShell:可以在计算机上的 PowerShell 远程会话中运行命令。
- WMI:接收对计算机的Win32_ComputerSystem查询的答复。
- WinRM:可以使用 WS-Management 与计算机建立远程会话。
已在 Windows PowerShell 3.0 中引入了此参数。
Type: | WaitForServiceTypes |
Accepted values: | Wmi, WinRM, PowerShell |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
强制立即重启计算机。
Type: | SwitchParameter |
Aliases: | f |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Impersonation
指定此 cmdlet 用于调用 WMI 的模拟级别。 Restart-Computer
使用 WMI。
此参数的可接受值为:
- 默认值:默认模拟。 尽管名称为 ,但这不是默认值。
- 匿名:隐藏调用方的身份。
- 标识:允许对象查询调用方凭据。
- 模拟:允许对象使用调用方凭据。
Type: | ImpersonationLevel |
Accepted values: | Default, Anonymous, Identify, Impersonate, Delegate |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Protocol
指定重新启动计算机要使用的协议。 有效值为 WSMan 和 DCOM。
此参数是在 Windows PowerShell 3.0 中引入的。
Type: | String |
Accepted values: | DCOM, WSMan |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ThrottleLimit
指定为运行此命令可建立的并发连接的最大数目。 节流限制仅适用于当前命令,而不适用于会话或计算机。
如果未指定 ThrottleLimit 参数或使用值 0, Restart-Computer
则最多使用 32 个并发连接。
Type: | Int |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Timeout
指定等待的持续时间,以秒为单位。 超时时间过后,即使计算机未重启, Restart-Computer
也会返回到命令提示符。
Timeout 参数仅对 Wait 参数有效。 超时 覆盖 Wait 参数的无限等待期。
已在 Windows PowerShell 3.0 中引入了此参数。
Type: | Int |
Aliases: | TimeoutSec |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Wait
Restart-Computer
取消 PowerShell 提示符并阻止管道,直到计算机重启。 可以在脚本中使用此参数来重新启动计算机,然后在重启完成后继续处理。
Wait 参数无限期等待计算机重启。 可以使用 Timeout 调整计时和 For 和 Delay 参数,以等待特定服务在重启的计算机上可用。
重启本地计算机时 ,Wait 参数无效。 如果 ComputerName 参数的值包含远程计算机和本地计算机的名称, Restart-Computer
则 在本地计算机上 为 Wait 生成非终止错误,但会等待远程计算机重启。
已在 Windows PowerShell 3.0 中引入了此参数。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
显示运行后 Restart-Computer
会发生什么情况。 cmdlet Restart-Computer
未运行。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WsmanAuthentication
指定用于对用户的凭据进行身份验证的机制。 已在 Windows PowerShell 3.0 中引入了此参数。
此参数的可接受值为: Basic、 CredSSP、 Default、 Digest、 Kerberos 和 Negotiate。
有关详细信息,请参阅 AuthenticationMechanism。
警告
凭据安全服务提供程序 (CredSSP) 身份验证,其中用户凭据将传递给远程计算机以进行身份验证,适用于需要对多个资源进行身份验证的命令,例如访问远程网络共享。 此机制增加了远程操作的安全风险。 如果远程计算机的安全受到威胁,则传递给该计算机的凭据可用于控制网络会话。
Type: | String |
Accepted values: | Basic, CredSSP, Default, Digest, Kerberos, Negotiate |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
输入
Restart-Computer
接受管道或变量中的计算机名称。
在 Windows PowerShell 2.0 中,ComputerName 参数仅按属性名称通过管道获取输入。 在 Windows PowerShell 3.0 及更高版本中,ComputerName 参数按值从管道中获取输入。
输出
None, System.Management.Automation.RemotingJob
如果指定 AsJob 参数, Restart-Computer
则返回作业对象。 否则,不会生成任何输出。
备注
Restart-Computer
仅在运行 Windows 的计算机上运行,并且需要 WinRM 和 WMI 来关闭系统,包括本地系统。Restart-Computer
使用 Windows Management Instrumentation (WMI) Win32_OperatingSystem 类的Win32Shutdown 方法。
在 Windows PowerShell 2.0 中,在重启或停止远程计算机时,AsJob 参数无法可靠地工作。 在 Windows PowerShell 3.0 中,为解决此问题,该实现方式有所更改。