New-PSSession

New-PSSession [[-ComputerName] <string[]>] [-ApplicationName <string>] [-Authentication {<Default> | <Basic> | <Negotiate> | <NegotiateWithImplicitCredential> | <Credssp> | <Digest> | <Kerberos>}] [-CertificateThumbprint <string>] [-ConfigurationName <string>] [-Credential <PSCredential>] [-Name <string[]>] [-Port <int>] [-SessionOption <PSSessionOption>] [-UseSSL] [-ThrottleLimit <int>] [<CommonParameters>]

New-PSSession [[-Session] <PSSession[]>] [-Name <string[]>] [-ThrottleLimit <int>] [<CommonParameters>]

New-PSSession [-ConnectionURI] <Uri[]> [-AllowRedirection] [-Authentication {<Default> | <Basic> | <Negotiate> | <NegotiateWithImplicitCredential> | <Credssp> | <Digest> | <Kerberos>}] [-CertificateThumbprint <string>] [-ConfigurationName <string>] [-Credential <PSCredential>] [-Name <string[]>] [-SessionOption <PSSessionOption>] [-ThrottleLimit <int>] [<CommonParameters>]

C:\PS>$s = new-pssession

描述
-----------
這個命令會在本機電腦建立新的 PSSession，並將 PSSession 儲存在 $s 變數中。

您現在可以使用這個 PSSession 在本機電腦執行命令。

C:\PS>$Server01 = new-pssession -ComputerName Server01

描述
-----------
這個命令會在 Server01 電腦建立新的 PSSession，並將其儲存在 $Server01 變數中。

建立多個 PSSession 時，請使用適當的名稱將它們指定給變數。這可協助您在後續的命令中管理 PSSession。

C:\PS>$s1, $s2, $s3 = new-session -computername server1,server2,server3

描述
-----------
這個命令會建立三個新的 PSSession，ComputerName 參數指定的每一部電腦各一個。

這個命令會使用指定運算子 (=)，將新的 PSSession 指定給下列變數的陣列：$s1, $s2, $s3。它會將 Server01 PSSession 指定給 $s1、將 Server02 PSSession 指定給 $s2，並將 Server03 PSSession 指定給 $s3。

將多個物件指定給變數的陣列時，Windows PowerShell 會將每個物件分別指定給陣列中的變數。如果物件比變數還要多，所有剩餘的物件都會指定給最後一個變數。如果變數比物件還要多，剩餘的變數就會空白 (null)。

C:\PS>new-pssession -computername Server01 -port 8081 -useSSL -ConfigurationName E12

描述
-----------
這個命令會在 Server01 電腦上建立新的 PSSession，以便連線至伺服器連接埠 8081 及使用 SSL 通訊協定。這個新的 PSSession 會使用名為 "E12" 的其他工作階段設定。

設定連接埠之前，您必須先在遠端電腦上設定要接聽連接埠 8081 的 WinRM 接聽程式。如需詳細資訊，請參閱 Port 參數的描述。

C:\PS>new-pssession -session $s -credential domain01\user01

描述
-----------
這個命令會使用與現有 PSSession 相同的屬性來建立新的 PSSession。當現有 PSSession 的資源已用盡，需要新的 PSSession 來分擔部分需求時，您就可以使用這個命令格式。

這個命令會使用 New-PSSession 的 Session 參數指定儲存在 $s 變數中的 PSSession。它會使用 Domain1\Admin01 使用者的認證來完成命令。

C:\PS>$global:s = new-pssession -computername server1.domain44.corpnet.fabrikam.com -credential domain01\admin01

描述
-----------
在這個範例中，會示範如何在不同網域的電腦上，建立具有全域範圍的 PSSession。

根據預設，在命令列建立的 PSSession 都具有本機範圍，而在指令碼中建立的 PSSession 則具有指令碼範圍。

若要建立具有全域範圍的 PSSession，請建立新的 PSSession，然後將 PSSession 儲存在轉換為全域範圍的變數中。在本例中，$ 變數已轉換為全域範圍。

此命令會使用 ComputerName 參數來指定遠端電腦。由於電腦所在的網域與使用者帳戶不同，故同時指定了電腦的完整名稱與使用者的認證。

C:\PS>$rs = get-content c:\test\servers.txt | new-PSsession -throttleLimit 50

描述
-----------
這個命令會在 Servers.txt 檔案中列出的每一部電腦 (共 200 部) 上建立 PSSession，並將產生的 PSSession 儲存到 $rs 變數。PSSession 的節流閥限制為 50。

當電腦的名稱儲存成資料庫、試算表、文字檔或其他文字可轉換格式時，您就可以使用這個命令格式。

C:\PS>$s = new-PSSession -URI http://Server01:91/NewSession -credential domain01\user01

描述
-----------
這個命令會在 Server01 電腦建立 PSSession，並將其儲存到 $s 變數。它會使用 URI 參數指定傳輸通訊協定、遠端電腦、連接埠和其他工作階段設定。它也會使用 Credential 參數，指定具有在遠端電腦建立工作階段之權限的使用者帳戶。

C:\PS>$s = new-PSSession -computername (import-csv servers.csv) -credential domain01\admin01 -throttlelimit 16

C:\PS> invoke-command -session $s -scriptblock {get-process powershell} -AsJob

描述
-----------
這些命令會建立一組 PSSession，接著在每個 PSSession 中執行背景工作。

第一個命令會在 Servers.csv 檔案列出的每台電腦建立新的 PSSession。它會使用 New-PSSession Cmdlet 建立 PSSession。ComputerName 參數的值是一個命令，這個命令會使用 Import-Csv Cmdlet 匯入 Servers.csv 檔案並讀取其內容。

這個命令會使用 Credential 參數，利用網域系統管理員的權限來建立 PSSession，並使用 ThrottleLimit 將命令限制為 16 個同時連線。此命令會將 PSSession 儲存在 $s 變數中。
   
第二個命令會使用 Invoke-Command 的 AsJob 參數啟動背景工作，此工作會對 $s 中的每個 PSSession 執行 "Get-Process PowerShell" 命令。

如需背景工作的詳細資訊，請參閱 about_Jobs 和 about_Remote_Jobs。

C:\PS>new-PSSession -ConnectionURI https://management.exchangelabs.com/Management

描述
-----------
這個命令會建立新的 PSSession，以便連線到由 URI (而非電腦名稱) 所指定的電腦。

C:\PS>$so = New-WSManSessionOption -SkipCACheck

PS C:\> new-pssession -ConnectionUri https://management.exchangelabs.com/Management -SessionOption $so -credential server01\admin01

描述
-----------
在這個範例中，會示範如何建立及使用 SessionOption 參數。

第一個命令會使用 New-WSManSessionOption Cmdlet 建立工作階段選項，並會將產生的 SessionOption 物件儲存在 $so 參數中。

第二個命令會在新的工作階段中使用該選項。這個命令會使用 New-PSSession Cmdlet 建立新的工作階段。SessionOption 參數的值是 $so 變數中的 SessionOption 物件。