連線到遠端電腦上的 WinRM 服務。

語法

Connect-WSMan [-ApplicationName <string>] [-ComputerName <string>] [-Port <int>] [-UseSSL] [-Authentication <Authentication>] [-ComputerName <string>] [-Credential <PSCredential>] [-Port <int>] [-SessionOption <hashtable>] [<CommonParameters>]

Connect-WSMan [-ConnectionURI <Uri>] [-Authentication <Authentication>] [-ComputerName <string>] [-Credential <PSCredential>] [-Port <int>] [-SessionOption <hashtable>] [<CommonParameters>]

描述

Connect-WSMan Cmdlet 會連線到遠端電腦的 WinRM 服務,並建立與遠端電腦的固定連線。您可以在 WS-Management 提供者的內容中使用這個 Cmdlet,連線到遠端電腦的 WinRM 服務。不過,您也可以在變更為 WS-Management 提供者之前,使用這個 Cmdlet 連線到遠端電腦的 WinRM 服務。遠端電腦將會出現在 WS-Management 提供者的根目錄中。

如需如何中斷與遠端電腦 WinRM 服務之連線的詳細資訊,請參閱 Disconnect-WSMan。

參數

-ApplicationName <string>

指定連線中的應用程式名稱。ApplicationName 參數的預設值為 "WSMAN"。遠端端點的完整識別元的格式如下:

<傳輸>://<伺服器>:<連接埠>/<ApplicationName>

例如:

http://server01:8080/WSMAN

為工作階段提供服務的 Internet Information Services (IIS) 會將包含此端點的要求轉送到指定的應用程式。此 "WSMAN" 的預設設定適合大部分使用情況。此參數是為了多台電腦遠端連線到一台執行 Windows PowerShell 的電腦時使用而設計。在此情況下,IIS 會裝載 Web Services for Management (WS-Management) 以提升效率。

必要?

false

位置?

named

預設值

wsman

接受管線輸入?

false

接受萬用字元?

false

-Authentication <Authentication>

指定用於伺服器的驗證機制。可能的值為:

- Basic:Basic 是一種以純文字格式將使用者名稱和密碼傳送到伺服器或 Proxy 的配置。

- Default:使用 WS-Management 通訊協定所實作的驗證方法。這是預設值。

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

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

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

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

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

必要?

false

位置?

named

預設值

Default

接受管線輸入?

false

接受萬用字元?

false

-ComputerName <string>

指定要對其執行管理作業的電腦。此值可以是完整網域名稱、NetBIOS 名稱或 IP 位址。請使用本機電腦名稱、localhost 或點 (.) 指定本機電腦。本機電腦為預設值。當遠端電腦所在的網域與使用者的網域不同時,必須使用完整網域名稱。您可以經由管道將此參數的值輸出至 Cmdlet。

必要?

false

位置?

named

預設值

localhost

接受管線輸入?

false

接受萬用字元?

false

-ConnectionURI <Uri>

指定連線端點。此字串的格式為:

<Transport>://<Server>:<Port>/<ApplicationName>。

下列字串是此參數的正確格式值:

http://Server01:8080/WSMAN。此 URI 必須是完整的 URI。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-Credential <PSCredential>

指定具有執行此動作之權限的使用者帳戶。預設為目前使用者。請輸入使用者名稱,例如 "User01"、"Domain01\User01" 或 "User@Domain.com"。或者輸入 PSCredential 物件,例如 Get-Credential Cmdlet 所傳回的物件。當您輸入使用者名稱時,會提示您輸入密碼。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-OptionSet <hashtable>

將一組切換參數傳遞到服務,以修改或精簡要求的性質。這些切換參數與命令列殼層中使用的切換參數相似,都是服務專有的參數。您可以指定任何數量的選項。

下列範例會示範將值 1、2、3 傳遞給參數 a、b、c 的語法:

-OptionSet @{a=1;b=2;c=3}

必要?

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-Port <int>

指定用戶端與 WinRM 服務連線時所要使用的連接埠。傳輸協定為 HTTP 時的預設連接埠是 80。傳輸協定為 HTTPS 時的預設連接埠是 443。當您使用 HTTPS 做為傳輸協定時,ComputerName 參數的值必須與伺服器的憑證一般名稱 (CN) 相符。然而,若將 SkipCNCheck 參數指定為 SessionOption 參數的一部分,則伺服器的憑證一般名稱不必與伺服器的主機名稱相符。SkipCNCheck 參數只能用於受信任的電腦。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-SessionOption <hashtable>

定義一組用於 WS-Management 工作階段的擴充選項。請輸入使用 New-WSManSessionOption Cmdlet 所建立的 SessionOption 物件。如需可用選項的詳細資訊,請參閱 New-WSManSessionOption。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-UseSSL

指定必須使用安全通訊端層 (SSL) 通訊協定來建立與遠端電腦的連線。預設不會使用 SSL。

WS-Management 會將所有透過網路傳輸的 Windows PowerShell 內容加密。UseSSL 參數可以讓您指定使用 HTTPS 提供多一層防護,而非使用 HTTP。如果連線所用的連接埠無法供 SSL 使用,但卻指定此參數,則命令會失敗。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

<CommonParameters>

這個 Cmdlet 支援一般參數:-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。如需詳細資訊,請參閱 about_Commonparameters.

輸入和輸出

輸入型別是可經由管道輸出至 Cmdlet 的物件型別。傳回型別則是 Cmdlet 所傳回的物件型別。

輸入

這個 Cmdlet 不接受任何輸入。

輸出

這個 Cmdlet 不會產生任何輸出。

附註

您可以在遠端電腦執行管理命令或查詢管理資料,而不需要建立 WS-Management 工作階段。您可以使用 Invoke-WSManActionGet-WSManInstance 的 ComputerName 參數達到上述目的。使用 ComputerName 參數時,Windows PowerShell 會建立用於該單一命令的暫時連線。在命令執行完成之後,這個連線便會關閉。

範例 1

C:\PS>Connect-WSMan -computer server01

PS C:\Users\testuser> cd wsman:
PS WSMan:\> 
PS WSMan:\> dir


   WSManConfig: Microsoft.WSMan.Management\WSMan::WSMan

ComputerName                                  Type
------------                                  ----
localhost                                     Container
server01                                      Container

Description
-----------
這個命令會建立與遠端 server01 電腦的連線。

Connect-WSMan Cmdlet 通常是在 WS-Management 提供者的內容中,用來連線到遠端電腦 (在這個範例中就是 server01 電腦)。不過,您可以在變更為 WS-Management 提供者之前,使用此 Cmdlet 建立與遠端電腦的連線。這些連線將會出現在 ComputerName 清單中。






範例 2

C:\PS>$cred = Get-Credential Administrator
Connect-WSMan -computer server01 -credential $cred

PS C:\Users\testuser> cd wsman:
PS WSMan:\>
PS WSMan:\> dir


   WSManConfig: Microsoft.WSMan.Management\WSMan::WSMan

ComputerName                                  Type
------------                                  ----
localhost                                     Container
server01                                      Container

Description
-----------
這個命令會使用管理員帳戶認證,建立與遠端系統 server01 的連線。

第一個命令會使用 Get-Credential Cmdlet 取得系統管理員認證,然後將其儲存在 $cred 變數中。Get-Credential Cmdlet 會提示使用者輸入密碼或者使用者名稱和密碼。提示使用者的方式是透過對話方塊
或命令列 (視系統登錄設定而定)。

第二個命令會使用 Credential 參數,將儲存在 $cred 中的認證傳遞到 Connect-WSMan。接著 Connect-WSMan 會使用系統管理員認證連線到遠端系統 server01。

Connect-WSMan Cmdlet 通常是在 WS-Management 提供者的內容中,用來連線到遠端電腦 (在這個範例中就是 server01)。不過,您可以在變更為 WS-Management 提供者之前,使用此 Cmdlet 建立與遠端電腦的連線,而這些連線將會出現在 ComputerName 清單中。






範例 3

C:\PS>Connect-WSMan -computer server01 -port 80

PS C:\Users\testuser> cd wsman:
PS WSMan:\> 
PS WSMan:\> dir


   WSManConfig: Microsoft.WSMan.Management\WSMan::WSMan

ComputerName                                  Type
------------                                  ----
localhost                                     Container
server01                                      Container

Description
-----------
這個命令會透過連接埠 80 建立與遠端 server01 電腦的連線。

Connect-WSMan Cmdlet 通常是在 WS-Management 提供者的內容中,用來連線到遠端電腦 (在這個範例中就是 server01 電腦)。不過,您可以在變更為 WS-Management 提供者之前,使用此 Cmdlet 建立與遠端電腦的連線。這些連線將會出現在 ComputerName 清單中。






範例 4

C:\PS>$a = New-WSManSessionOption -operationtimeout 30000
Connect-WSMan -computer server01 -sessionoption $a

PS C:\Users\testuser> cd wsman:
PS WSMan:\> 
PS WSMan:\> dir


   WSManConfig: Microsoft.WSMan.Management\WSMan::WSMan

ComputerName                                  Type
------------                                  ----
localhost                                     Container
server01                                      Container

Description
-----------
這個命令會使用 New-WSManSessionOption 命令中定義的連線選項,建立與遠端 server01 電腦的連線。

第一個命令會使用 New-WSManSessionOption Cmdlet 將一組連線設定選項儲存在 $a 變數中。在這個範例中,工作階段選項會將連線逾時設定為 30 秒 (30,000 毫秒)。

第二個命令會使用 SessionOption 參數,將儲存在 $a 變數中的認證傳遞到 Connect-WSMan。接著,Connect-WSMan 會使用指定的工作階段選項連線到遠端 server01 電腦。

Connect-WSMan Cmdlet 通常是在 WS-Management 提供者的內容中,用來連線到遠端電腦 (在這個範例中就是 server01 電腦)。不過,您可以在變更為 WS-Management 提供者之前,使用此 Cmdlet 建立與遠端電腦的連線。這些連線將會出現在 ComputerName 清單中。






請參閱




目錄