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 是一種以純文字格式將使用者名稱和密碼傳送到伺服器或 Proxy 的配置。

- Default：使用 WS-Management 通訊協定所實作的驗證方法。

- Digest：Digest 是一種挑戰-回應配置，會使用伺服器指定的資料字串進行挑戰。

- Kerberos：用戶端電腦與伺服器可使用 Kerberos 憑證相互驗證。

- Negotiate：Negotiate 是一種挑戰-回應配置，可與伺服器或 Proxy 進行交涉以決定要用於驗證的配置。例如，此參數值允許交涉式驗證判斷是使用 Kerberos 通訊協定還是 NTLM。

- CredSSP：使用認證安全性服務提供者 (CredSSP) 驗證，該驗證允許使用者委派認證。此選項專為在一台遠端電腦執行，但卻從其他遠端電腦收集資料或執行其他命令的命令而設計。

警告：CredSSP 會從本機電腦將使用者的認證委派給遠端電腦。此做法會提高遠端操作的安全性風險。如果遠端電腦已經遭受危害，當認證傳送到遠端電腦時，便可能遭到利用來控制網路工作階段。

重要：如果未指定驗證參數，則會以匿名方式將 Test-WSMan 要求傳送到遠端電腦 (不使用驗證)。如果 Test-WSMan 要求是以匿名方式提出，則不會傳回作業系統版本專屬的任何資訊。而且針對作業系統版本和 Service Pack 等級，Test-WSMan 會顯示 null 值 (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 等級顯示 null 值 (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

描述
-----------
這個命令會測試 WS-Management (WinRM) 服務是否使用驗證參數在本機電腦執行。

使用驗證參數可以讓 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

描述
-----------
這個命令會測試 WS-Management (WinRM) 服務是否使用驗證參數在名為 server01 的電腦執行。

使用驗證參數可以讓 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

共用方式為