測試 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 : https://schemas.dmtf.org/wbem/wsman/identity/1/wsmanidentity.xsd ProtocolVersion : https://schemas.dmtf.org/wbem/wsman/1/wsman.xsd ProductVendor : Microsoft Corporation ProductVersion : OS: 0.0.0 SP: 0.0 Stack: 2.0 Description ----------- 這個命令會判斷 WinRM 服務是在本機電腦或遠端電腦執行。
範例 2
C:\PS>test-wsman -computername server01 wsmid : https://schemas.dmtf.org/wbem/wsman/identity/1/wsmanidentity.xsd ProtocolVersion : https://schemas.dmtf.org/wbem/wsman/1/wsman.xsd ProductVendor : Microsoft Corporation ProductVersion : OS: 0.0.0 SP: 0.0 Stack: 2.0 Description ----------- 這個命令會判斷 WinRM 服務是否正在 server01 的電腦執行。
範例 3
C:\PS>test-wsman -authentication default wsmid : https://schemas.dmtf.org/wbem/wsman/identity/1/wsmanidentity.xsd ProtocolVersion : https://schemas.dmtf.org/wbem/wsman/1/wsman.xsd ProductVendor : Microsoft Corporation ProductVersion : OS: 6.0.6001 SP: 1.0 Stack: 2.0 Description ----------- 這個命令會測試 WS-Management (WinRM) 服務是否使用驗證參數在本機電腦執行。 使用驗證參數可以讓 Test-WSMan Cmdlet 傳回作業系統版本。
範例 4
C:\PS>test-wsman -computername server01 -authentication default wsmid : https://schemas.dmtf.org/wbem/wsman/identity/1/wsmanidentity.xsd ProtocolVersion : https://schemas.dmtf.org/wbem/wsman/1/wsman.xsd ProductVendor : Microsoft Corporation ProductVersion : OS: 6.1.7021 SP: 0.0 Stack: 2.0 Description ----------- 這個命令會測試 WS-Management (WinRM) 服務是否使用驗證參數在名為 server01 的電腦執行。 使用驗證參數可以讓 Test-WSMan Cmdlet 傳回作業系統版本。
請參閱