Restart-Computer

  • 参考
模块:
Microsoft.PowerShell.Management

在本地和远程计算机上重启操作系统。

语法

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

输入

String

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 中，为解决此问题，该实现方式有所更改。