Test-WSMan

项目
10/30/2009

测试 WinRM 服务是否正在本地或远程计算机上运行。

语法

Test-WSMan [[-ComputerName] <string>] [-Authentication <Authentication>] [-Credential <PSCredential>] [<CommonParameters>]

说明

Test-WSMan cmdlet 提交一个识别请求以确定 WinRM 服务是在本地计算机还是远程计算机上运行。如果接受测试的计算机正在运行该服务，则该 cmdlet 将显示被测服务的 WS-Management 标识方案、协议版本、产品供应商及产品版本。

参数

-Authentication <Authentication>

指定服务器上要使用的身份验证机制。可能值为：

- Basic：Basic 是一种方案，在该方案中，用户名和密码以明文形式发送到服务器或代理。

- Default：使用 WS-Management 协议实现的身份验证方法。

- Digest：Digest 是一种质询响应方案，该方案将服务器指定的数据字符串用于质询。

- Kerberos：客户端计算机和服务器使用 Kerberos 证书相互进行身份验证。

- Negotiate：Negotiate 是一种质询响应方案，该方案与服务器或代理协商以确定要使用的身份验证方案。例如，此参数值允许进行协商以确定是使用 Kerberos 协议还是 NTLM。

- CredSSP：使用凭据安全服务提供程序 (CredSSP) 身份验证，这种方法允许用户委派凭据。此选项用于这样的命令：在一台远程计算机上运行，但从其他远程计算机上收集数据或者在其他远程计算机上运行其他命令。

注意：CredSSP 将本地计算机中的用户凭据委派给远程计算机。此操作增加了远程操作的安全风险。如果远程计算机的安全受到威胁，则在向该计算机传递凭据时，可使用这些凭据来控制网络会话。

重要说明：如果不指定 authentication 参数，则以匿名方式（不使用身份验证）将 Test-WSMan 请求发送到远程计算机。如果 Test-WSMan 请求是以匿名方式发出的，则不会返回任何针对操作系统版本的信息。实际上，Test-WSMan 将操作系统版本和 Service Pack 级别显示为空值 (OS: 0.0.0 SP: 0.0)。

是否为必需？	false
位置？	named
默认值
是否接受管道输入？	false
是否接受通配符？	false

-ComputerName <string>

指定要对其运行管理操作的计算机。值可以是完全限定的域名、NetBIOS 名称或 IP 地址。使用本地计算机名称、localhost 或点 (.)指定本地计算机。默认值为本地计算机。当远程计算机与用户位于不同的域时，必须使用完全限定的域名。

是否为必需？	false
位置？	1
默认值	localhost
是否接受管道输入？	false
是否接受通配符？	false

-Credential <PSCredential>

指定有权执行此操作的用户帐户。默认值为当前用户。键入用户名，例如“User01”、“Domain01\User01”或 User@Domain.com。或者，输入 PSCredential 对象，例如由 Get-Credential cmdlet 返回的对象。键入用户名时，将会提示您键入密码。

是否为必需？	false
位置？	named
默认值
是否接受管道输入？	false
是否接受通配符？	false

<CommonParameters>

此 cmdlet 支持通用参数：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。有关详细信息，请参阅 about_Commonparameters.

输入和输出

输入类型是指可通过管道传递给 cmdlet 的对象的类型。返回类型是指 Cmdlet 所返回对象的类型。

输入

无

此 cmdlet 不接受任何输入。

输出

无

此 cmdlet 将不产生任何输出对象。

说明

默认情况下，Test-WSMan cmdlet 在查询 WinRM 服务时不使用身份验证，并且不返回针对操作系统版本的任何信息。而是将操作系统版本和 Service Pack 级别显示为空值 (OS: 0.0.0 SP: 0.0)。

示例 1

C:\PS>test-wsman

wsmid           : http://schemas.dmtf.org/wbem/wsman/identity/1/wsmanidentity.xsd
ProtocolVersion : http://schemas.dmtf.org/wbem/wsman/1/wsman.xsd
ProductVendor   : Microsoft Corporation
ProductVersion  : OS: 0.0.0 SP: 0.0 Stack: 2.0

说明
-----------
此命令确定 WinRM 服务正在本地计算机还是远程计算机上运行。

示例 2

C:\PS>test-wsman -computername server01

wsmid           : http://schemas.dmtf.org/wbem/wsman/identity/1/wsmanidentity.xsd
ProtocolVersion : http://schemas.dmtf.org/wbem/wsman/1/wsman.xsd
ProductVendor   : Microsoft Corporation
ProductVersion  : OS: 0.0.0 SP: 0.0 Stack: 2.0

说明
-----------
此命令确定 WinRM 服务是否正在名为 server01 的计算机上运行。

示例 3

C:\PS>test-wsman -authentication default

wsmid           : http://schemas.dmtf.org/wbem/wsman/identity/1/wsmanidentity.xsd
ProtocolVersion : http://schemas.dmtf.org/wbem/wsman/1/wsman.xsd
ProductVendor   : Microsoft Corporation
ProductVersion  : OS: 6.0.6001 SP: 1.0 Stack: 2.0

说明
-----------
此命令将使用 authentication 参数进行测试以了解 WS-Management (WinRM) 服务是否正在本地计算机上运行。

使用 authentication 参数可允许 Test-WSMan cmdlet 返回操作系统的版本。

示例 4

C:\PS>test-wsman -computername server01 -authentication default

wsmid           : http://schemas.dmtf.org/wbem/wsman/identity/1/wsmanidentity.xsd
ProtocolVersion : http://schemas.dmtf.org/wbem/wsman/1/wsman.xsd
ProductVendor   : Microsoft Corporation
ProductVersion  : OS: 6.1.7021 SP: 0.0 Stack: 2.0

说明
-----------
此命令将使用 authentication 参数进行测试以了解 WS-Management (WinRM) 服务是否正在名为 server01 的计算机上运行。

使用 authentication 参数可允许 Test-WSMan cmdlet 返回操作系统的版本。

另请参阅

概念

Connect-WSMan
Disable-WSManCredSSP
Disconnect-WSMan
Enable-WSManCredSSP
Get-WSManCredSSP
Get-WSManInstance
Invoke-WSManAction
New-WSManInstance
New-WSManSessionOption
Remove-WSManInstance
Set-WSManInstance
Set-WSManQuickConfig

通过