New-PSWorkflowSession

指定連線 URI 的應用程式名稱區段。

預設值是本機電腦上的喜好設定變數值 $PSSessionApplicationName 。 如果未定義此喜好設定變數，預設值為 WSMAN。 此值適用於大部分使用。 如需詳細資訊，請參閱 about_Preference_Variables。

WinRM 服務會使用應用程式名稱來選取接聽程式以服務連線要求。 此參數的值應該符合 遠端電腦上接聽程式的 URLPrefix 屬性值。

指定用來驗證使用者認證的機制。 此參數可接受的值為：

• Default
• Basic
• Credssp
• Digest
• Kerberos
• Negotiate
• NegotiateWithImplicitCredential

預設值是 Default。

CredSSP 驗證僅適用於 Windows Vista、Windows Server 2008 和更新版本的 Windows 操作系統。

如需此參數值的詳細資訊，請參閱 AuthenticationMechanism 列舉。

指定具有執行此動作許可權之用戶帳戶的數位公鑰憑證 （X509）。 輸入憑證的憑證指紋。

憑證將用於用戶端憑證式驗證。 它們只能對應至本機用戶帳戶;它們不適用於網域帳戶。

若要取得憑證指紋，請使用 Get-Item Windows PowerShell Cert: 磁碟驅動器中的 Cmdlet 或 Get-ChildItem Cmdlet。

建立與指定計算機的持續連線（PSSession）。 如果您輸入多個計算機名稱，Windows PowerShell 會建立多個 PSSession，每部計算機各一個。 預設是本機電腦。

輸入 NetBIOS 名稱、IP 位址或一或多部遠端電腦的完整功能變數名稱。 若要指定本機計算機，請輸入計算機名稱 、 localhost或點 （.）。 當計算機位於與使用者不同的網域時，需要完整功能變數名稱。 您也可以使用管線將計算機名稱以引號括住 New-PSWorkflowSession。

若要在 ComputerName 參數的值中使用 IP 位址，命令必須包含 Credential 參數。 此外，計算機必須針對 HTTPS 傳輸進行設定，或遠端電腦的 IP 位址必須包含在本機電腦上的 WinRM TrustedHosts 清單中。 如需將計算機名稱新增至 TrustedHosts 清單的指示，請參閱 about_Remote_Troubleshooting 中的。

指定具有執行此動作許可權的用戶帳戶。 預設為目前使用者。 輸入使用者名稱，例如 User01、、 或 User@Domain.com，或輸入 PSCredential 物件，例如 Cmdlet 所傳回的用戶Get-CredentialDomain01\User01名稱。

當您輸入使用者名稱時，此 Cmdlet 會提示您輸入密碼。

指出此 Cmdlet 會將互動式安全性令牌新增至回送會話。 互動式令牌可讓您在從其他電腦取得數據的回送會話中執行命令。 例如，您可以在會話中執行命令，將 XML 檔案從遠端電腦複製到本機電腦。

回送會話是一種 PSSession，源自同一部計算機並結束。 若要建立回送會話，請勿指定 ComputerName 參數，或將其值設定為 dot （.）， localhost或本機計算機的名稱。

根據預設，會建立具有網路令牌的回送會話，可能無法提供足夠的許可權來向遠端計算機進行驗證。

EnableNetworkAccess 參數只在回送會話中有效。 如果您在遠端電腦上建立會話時指定 EnableNetworkAccess 參數，命令會成功，但會忽略 參數。

您也可以使用 Authentication 參數的 CredSSP 值，在回送會話中允許遠端訪問，此參數會將會話認證委派給其他電腦。

若要保護計算機免於惡意存取，具有互動式令牌的已中斷聯機回送會話，使用 EnableNetworkAccess 參數所建立的會話只能從建立會話的計算機重新連線。 使用 CredSSP 驗證的已中斷聯機會話可以從其他電腦重新連線。 如需詳細資訊，請參閱 Disconnect-PSSession Cmdlet。

此參數是在 Windows PowerShell 3.0 中引進的。

指定工作流程會話的易記名稱。 您可以將名稱與其他 Cmdlet 搭配使用，例如 Get-PSSession 與 Enter-PSSession。 名稱不一定是計算機或目前會話的唯一名稱。

指定用於此連線之遠端電腦上的網路埠。 若要連線到遠端電腦，遠端計算機必須接聽連線所使用的埠。 默認埠為 5985 （適用於 HTTP 的 WinRM 連接埠） 和 5986 （適用於 HTTPS 的 WinRM 連接埠）。

使用另一個埠之前，您必須在遠端電腦上設定 WinRM 接聽程式，以在該埠上接聽。 使用下列命令來設定接聽程式：

winrm delete winrm/config/listener?Address=*+Transport=HTTP

winrm create winrm/config/listener?Address=*+Transport=HTTP @{Port="\<port-number\>"}

除非您必須，否則請勿使用 Port 參數。 命令中的埠設定會套用至命令執行所在的所有計算機或會話。 替代埠設定可能會防止命令在所有計算機上執行。

指定工作階段的進階選項。 輸入 SessionOption 物件，例如您使用 Cmdlet 建立的物件New-PSSessionOption。

如果設定選項，選項的 $PSSessionOption 預設值取決於喜好設定變數的值。 否則，預設值是由會話組態中設定的選項所建立。

會話選項值優先於喜好設定變數和會話組態中 $PSSessionOption 設定之會話的預設值。 不過，它們不會優先於會話設定中設定的最大值、配額或限制。 如需工作階段設定的詳細資訊，請參閱 about_Session_Configurations。

如需工作階段選項的描述，包括預設值，請參閱 New-PSSessionOption。 如需喜好設定變數的相關信息 $PSSessionOption ，請參閱 about_Preference_Variables。

指定可以建立以執行此命令的並行連線數目上限。 如果您省略此參數或輸入 值 0 （零），則會使用 Microsoft.PowerShellWorkflow 工作階段組態100的預設值 。

節流限制僅適用於目前的命令，不適用於會話或計算機。

指出此 Cmdlet 會使用安全套接字層 （SSL） 通訊協定來建立與遠端電腦的連線。 預設不會使用 SSL。

WS-Management 會加密透過網路傳輸的所有 Windows PowerShell 內容。 UseSSL 參數是額外的保護，可跨 HTTPS 連線傳送數據，而不是 HTTP 連線。

如果您指定此參數，但在用於命令的埠上無法使用 SSL，則命令會失敗。