Stop-Computer

参考

模块:: Microsoft.PowerShell.Management

停止（关闭）本地和远程计算机。

语法

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

说明

Stop-Computer cmdlet 远程关闭计算机。它也可以关闭本地计算机。

可以使用 Stop-Computer 的参数将关闭操作作为后台作业运行、指定身份验证级别和备用凭据、限制为运行命令而创建的并发连接，以及强制立即关闭。

除非使用 AsJob 参数，否则此 cmdlet 不需要Windows PowerShell远程处理。

示例

示例 1：关闭本地计算机

PS C:\> Stop-Computer

此命令关闭本地计算机。

示例 2：关闭两台远程计算机和本地计算机

PS C:\> Stop-Computer -ComputerName "Server01", "Server02", "localhost"

此命令停止两台远程计算机 Server01 和 Server02 以及标识为“localhost”的本地计算机。

示例 3：关闭远程计算机，作为后台作业运行

PS C:\> $j = Stop-Computer -ComputerName "Server01", "Server02" -AsJob
PS C:\> $results = $j | Receive-Job
PS C:\> $results

这些命令在两台远程计算机上将 Stop-Computer 作为后台作业运行，然后获取结果。

第一条命令指定 AsJob 参数将该命令作为后台作业运行。此命令将生成的作业对象保存在 $j 变量中。

第二条命令使用管道运算符将 $j 中的作业对象发送给 Receive-Job，它将获取作业结果。该命令将结果保存在 $results 变量中。

第三条命令显示保存在 $results 变量中的结果。

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

示例 4：关闭远程计算机

PS C:\> Stop-Computer -CompupterName "Server01" -Impersonation anonymous -Authentication PacketIntegrity

此命令停止远程计算机 Server01。此命令将使用自定义模拟和身份验证设置。

示例 5：

PS C:\> $s = Get-Content Domain01.txt
PS C:\> $c = Get-Credential domain01\admin01
PS C:\> Stop-Computer -ComputerName $s -Force -ThrottleLimit 10 -Credential $c

这些命令强制立即关闭 Domain01 中的所有计算机。

第一条命令获取该域中的计算机列表，然后将其存储在 $s 变量中。

第二条命令获取域管理员的凭据，并将其存储在 $c 变量中。

第三条命令关闭这些计算机。它使用 ComputerName 参数提交$s变量中的计算机列表，使用 Force 参数强制立即关闭，并使用 Credential 参数提交保存在$c变量中的凭据。此外，它还使用 ThrottleLimit 参数将该命令限制在 10 个并发连接范围内。

参数

-AsJob

指示此 cmdlet 作为后台作业运行。

若要使用此参数，必须为本地计算机和远程计算机配置远程处理，并且在 Windows Vista 以及更高版本的 Windows 操作系统上，还必须使用“以管理员身份运行”选项打开 Windows PowerShell。有关详细信息，请参阅 about_Remote_Requirements。

指定 AsJob 参数时，该命令立即返回代表后台作业的对象。当作业完成时，你可以继续在此会话中工作。作业在本地计算机上创建，并且来自远程计算机的结果将自动返回本地计算机。若要获取作业结果，请使用 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

指定要停止的计算机。默认为本地计算机。

在一个逗号分隔列表中键入一台或多台计算机的 NETBIOS 名称、IP 地址或完全限定的域名。若要指定本地计算机，请键入计算机名称或“localhost”。

此参数不依赖于 Windows PowerShell 远程处理。即使你的计算机未配置为运行远程命令，你也可以使用 ComputerName 参数。

Type:	String[]
Aliases:	CN, __SERVER, Server, IPAddress
Position:	0
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Confirm

提示你在运行 cmdlet 之前进行确认。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

指定有权执行此操作的用户帐户。默认为当前用户。

键入用户名（如 User01 或 Domain01\User01），或输入 PSCredential 对象，例如 Get-Credential cmdlet 中的一个。

Type:	PSCredential
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DcomAuthentication

指定此 cmdlet 用于 WMI 的身份验证级别。 Stop-Computer 使用 WMI。此参数的可接受值为：

默认。 Windows 身份验证
无。无 COM 身份验证
连接。连接级 COM 身份验证
Call。调用级 COM 身份验证
Packet。数据包级 COM 身份验证
PacketIntegrity。数据包完整性级 COM 身份验证
PacketPrivacy。数据包隐私级 COM 身份验证
未更改。与前一个命令相同

默认值为 Packet。

有关此参数的值的详细信息，请参阅 MSDN 库中的 AuthenticationLevel 枚举。

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

-Force

强制立即关闭计算机。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Impersonation

指定此 cmdlet 调用 WMI 时使用的模拟级别。 Stop-Computer 使用 WMI。此参数的可接受值为：

默认。默认模拟。
匿名。隐藏调用方的身份。
Identify。允许对象查询调用方的凭据。
Impersonate。允许对象使用调用方的凭据。

默认值为“Impersonate”。

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。默认值为 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

指定为运行此命令可建立的并发连接的最大数目。如果省略此参数或输入 0 值，则使用默认值 32。

节流限制仅适用于当前命令，而不适用于会话或计算机。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。此 cmdlet 未运行。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WsmanAuthentication

指定此 cmdlet 使用 WSMan 协议时用于对用户的凭据进行身份验证的机制。此参数的可接受值为：

基本
CredSSP
Default
摘要
Kerberos
Negotiate。

默认值为 Default。

有关此参数的值的详细信息，请参阅 MSDN 库中的 AuthenticationMechanism 枚举。

注意：在凭据安全服务提供程序 (CredSSP) 身份验证中，用户凭据传递到远程计算机中以进行验证，这种验证用于要求对多个资源（例如访问远程网络共享）进行验证的命令。此机制增加了远程操作的安全风险。如果远程计算机的安全受到威胁，则传递给该计算机的凭据可用于控制网络会话。