Test-WSMan
測試 WinRM 服務是否已在本機或遠端電腦上執行。
Syntax
Test-WSMan
[[-ComputerName] <String>]
[-Authentication <AuthenticationMechanism>]
[-Port <Int32>]
[-UseSSL]
[-ApplicationName <String>]
[-Credential <PSCredential>]
[-CertificateThumbprint <String>]
[<CommonParameters>]
Description
此 Cmdlet 僅適用於 Windows 平臺。
Cmdlet 會 Test-WSMan
提交識別要求,以判斷 WinRM 服務是在本機或遠端電腦上執行。 若測試的電腦正在執行該服務,則此 Cmdlet 會顯示已測試之服務的 WS-Management 身分識別結構描述、通訊協定版本、產品廠商與產品版本。
範例
範例 1︰判斷 WinRM 服務的狀態
Test-WSMan
此命令會判斷 WinRM 服務是否已在本機電腦或遠端電腦上執行。
範例 2︰判斷遠端電腦上 WinRM 服務的狀態
Test-WSMan -ComputerName "server01"
此命令會判斷 WinRM 服務是否正在 server01 電腦上執行。
範例 3︰判斷 WinRM 服務的狀態和作業系統版本
Test-WSMan -Authentication default
此命令會使用驗證參數,來測試 WS-Management (WinRM) 服務是否正在本機電腦上執行。
使用驗證參數可讓 Test-WSMan
傳回作業系統版本。
範例 4:判斷遠端電腦上的 WinRM 服務和 OS 版本的狀態
Test-WSMan -ComputerName "server01" -Authentication default
此命令會使用驗證參數,來查看 WS-Management (WinRM) 服務是否正在名為 server01 的電腦上執行。
使用驗證參數可讓 Test-WSMan
傳回作業系統版本。
參數
-ApplicationName
指定連線中的應用程式名稱。 ApplicationName 參數的預設值為 WSMAN。 遠端端點的完整識別碼使用下列格式:
<Transport>://<Server>:<Port>/<ApplicationName>
例如:http://server01:8080/WSMAN
裝載工作階段的網際網路資訊服務 (IIS),會使用此端點轉送要求至指定的應用程式。 此預設設定 WSMAN 適用於大部分用途。 此參數是設計用於下列狀況:如果有多部電腦會建立遠端連線至同一部執行 Windows PowerShell 的電腦。 在此案例中,IIS 會裝載管理 Web 服務 (WS-Management) 以獲得較佳效率。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Authentication
指定用於伺服器的驗證機制。 此參數可接受的值為:
Basic
- 基本是一種配置,其中使用者名稱和密碼會以純文本形式傳送至伺服器或 Proxy。Default
- 使用由 WS-Management 通訊協定實作的驗證方法。 此為預設值。- 1 - 摘要是一種挑戰回應配置,會針對挑戰使用伺服器指定的數據字串。
Kerberos
- 用戶端電腦和伺服器會使用 Kerberos 憑證相互驗證。Negotiate
- 交涉是與伺服器或 Proxy 交涉以判斷要用於驗證的配置的挑戰回應配置。 例如,此參數值允許交涉,以決定要使用 Kerberos 通訊協定或 NTLM。CredSSP
- 使用認證安全性支援提供者 (CredSSP) 驗證,讓使用者委派認證。 此選項是針對下列命令所設計:命令在遠端電腦上執行,但是收集來自其他遠端電腦上的資料,或是在其他遠端電腦上執行其他命令。
警告
CredSSP 會將使用者認證從本機計算機委派給遠端電腦。 此做法會使得遠端作業的安全性風險變高。 若遠端電腦遭到入侵,當認證被傳遞給它時,該認證便可用來控制網路工作階段。
重要
如果您未指定 Authentication 參數,要求 Test-WSMan
會匿名傳送至遠端電腦,而不使用驗證。 若以匿名方式提出要求,它就不會傳回任何作業系統版本特定的資訊。 相反地,此 Cmdlet 會為作業系統版本與 Service Pack 等級顯示 Null 值 (OS:0.0.0 SP:0.0)。
Type: | AuthenticationMechanism |
Aliases: | auth, am |
Accepted values: | None, Default, Digest, Negotiate, Basic, Kerberos, ClientCertificate, Credssp |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CertificateThumbprint
對於具有執行此動作之權限的使用者帳戶,指定其數位公開金鑰憑證 (X509)。 請輸入憑證的憑證指紋。
憑證將用於用戶端憑證式驗證。 這些憑證只能對應至本機使用者帳戶,無法用於網域帳戶。
若要取得憑證指紋,請使用 Windows PowerShell 憑證: 磁碟驅動器中的 Get-Item 或 Get-ChildItem
命令。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ComputerName
指定要執行管理作業的電腦。 值可以是完整網域名稱、NetBIOS 名稱或 IP 位址。 使用本機計算機名稱、使用localhost,或使用點 () .
來指定本機電腦。 預設值是本機電腦。 當遠端電腦與使用者位於不同網域,您必須使用完整網域名稱。 您可以使用管線將此參數的值傳送至 Cmdlet。
Type: | String |
Aliases: | cn |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Credential
指定具有執行此動作權限的使用者帳戶。 預設為目前使用者。 輸入使用者名稱,例如 User01、Domain01\User01 或 User@Domain.com。 或者,輸入 PSCredential 物件,例如 Cmdlet 所傳回的物件 Get-Credential
。 當您輸入使用者名稱時,此 Cmdlet 會提示您輸入密碼。
Type: | PSCredential |
Aliases: | cred, c |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Port
指定用戶端連線 WinRM 服務時所使用的連接埠。 傳輸為 HTTP 時,預設連接埠為 80。 傳輸為 HTTPS 時,預設連接埠為 443。
當您使用 HTTPS 作為傳輸時, ComputerName 參數的值必須符合伺服器的憑證一般名稱 (CN) 。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseSSL
指定使用安全通訊端層 (SSL) 通訊協定來建立遠端電腦連線。 預設不會使用 SSL。
WS-Management 會加密透過網路傳輸的所有 Windows PowerShell 內容。 UseSSL 參數可讓您指定 HTTPS 的額外保護,而不是 HTTP。 若用於連線的連接埠上無法使用 SSL,且您指定此參數,則命令會失敗。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
輸入
None
您無法使用管線將物件傳送至此 Cmdlet。
輸出
此 Cmdlet 會傳回代表測試結果的 XmlElement 物件。
備註
根據預設, Test-WSMan
Cmdlet 會查詢 WinRM 服務而不使用驗證,而且不會傳回作業系統版本特有的資訊。 相反地,它會為作業系統版本與 Service Pack 等級顯示 Null 值 (OS:0.0.0 SP:0.0)。