Enter-PSSession

參考

模組:: Microsoft.PowerShell.Core

使用遠端電腦啟動互動式會話。

語法

Enter-PSSession
     [-ComputerName] <String>
     [-EnableNetworkAccess]
     [[-Credential] <PSCredential>]
     [-ConfigurationName <String>]
     [-Port <Int32>]
     [-UseSSL]
     [-ApplicationName <String>]
     [-SessionOption <PSSessionOption>]
     [-Authentication <AuthenticationMechanism>]
     [-CertificateThumbprint <String>]
     [<CommonParameters>]

Enter-PSSession
     [-HostName] <String>
     [-Options <Hashtable>]
     [-Port <Int32>]
     [-UserName <String>]
     [-KeyFilePath <String>]
     [-Subsystem <String>]
     [-ConnectingTimeout <Int32>]
     [-SSHTransport]
     [<CommonParameters>]

Enter-PSSession
     [[-Session] <PSSession>]
     [<CommonParameters>]

Enter-PSSession
     [[-ConnectionUri] <Uri>]
     [-EnableNetworkAccess]
     [[-Credential] <PSCredential>]
     [-ConfigurationName <String>]
     [-AllowRedirection]
     [-SessionOption <PSSessionOption>]
     [-Authentication <AuthenticationMechanism>]
     [-CertificateThumbprint <String>]
     [<CommonParameters>]

Enter-PSSession
     [-InstanceId <Guid>]
     [<CommonParameters>]

Enter-PSSession
     [[-Id] <Int32>]
     [<CommonParameters>]

Enter-PSSession
     [-Name <String>]
     [<CommonParameters>]

Enter-PSSession
     [-VMId] <Guid>
     [-Credential] <PSCredential>
     [-ConfigurationName <String>]
     [<CommonParameters>]

Enter-PSSession
     [-VMName] <String>
     [-Credential] <PSCredential>
     [-ConfigurationName <String>]
     [<CommonParameters>]

Enter-PSSession
     [-ContainerId] <String>
     [-ConfigurationName <String>]
     [-RunAsAdministrator]
     [<CommonParameters>]

Description

Cmdlet Enter-PSSession 會啟動具有單一遠端電腦的互動式會話。在工作階段期間，您輸入的命令會在遠端電腦上執行，就如同您直接在遠端電腦上輸入一樣。您一次只能有一個互動式會話。

一般而言，您可以使用 ComputerName 參數來指定遠端電腦的名稱。不過，您也可以使用互動式會話的 New-PSSession Cmdlet 建立的會話。不過，您無法使用 Disconnect-PSSession、 Connect-PSSession或 Receive-PSSession Cmdlet 來中斷連線，或重新連線到互動式作業階段。

從 PowerShell 6.0 開始，您可以使用安全殼層（SSH）來建立遠端電腦的連線。您必須在本機計算機上具有SSH，而且遠端電腦必須設定PowerShell SSH 端點。 SSH 型 PowerShell 遠端工作階段的優點是其可跨多個平台運作（Windows、Linux、macOS）。針對 SSH 型遠端，您可以使用 HostName 參數設定來指定遠端電腦和相關連線資訊。如需如何設定PowerShell SSH 遠端的詳細資訊，請參閱透過SSH進行PowerShell遠端處理。

若要結束互動式工作階段並從遠端電腦中斷連線，請使用 Exit-PSSession Cmdlet，或輸入 exit。

重要

Enter-PSSession 設計成將目前的互動式會話取代為新的互動式遠程會話。您不應該從函式或腳本內呼叫它，或將它當做命令傳遞至 pwsh 可執行檔。

範例

範例 1：啟動互動式會話

PS> Enter-PSSession
[localhost]: PS>

此命令會在本機電腦上啟動互動式會話。命令提示字元會變更，表示您現在在不同的會話中執行命令。

您在新會話中輸入的命令會執行，結果會以文字的形式傳回預設會話。

範例 2：使用互動式會話

第一個命令會 Enter-PSSession 使用 Cmdlet 來啟動遠端電腦 Server01 的互動式作業階段。工作階段啟動時，命令提示字元會變更為包含計算機名稱。

第二個命令會取得 PowerShell 程式，並將輸出重新導向至 Process.txt 檔案。命令會提交至遠端電腦，並將檔案儲存在遠端電腦上。

第三個命令會使用 Exit 關鍵詞結束互動式工作階段並關閉連線。第四個命令會確認Process.txt檔案位於遠端電腦上。 Get-ChildItem 本機電腦上的（“dir”）命令找不到檔案。

PS C:\> Enter-PSSession -ComputerName Server01
[Server01]: PS C:\>
[Server01]: PS C:\> Get-Process PowerShell > C:\ps-test\Process.txt
[Server01]: PS C:\> exit
PS C:\>
PS C:\> dir C:\ps-test\Process.txt
Get-ChildItem : Cannot find path 'C:\ps-test\Process.txt' because it does not exist.
At line:1 char:4
+ dir <<<<  c:\ps-test\Process.txt

此命令示範如何使用遠端電腦在互動式會話中工作。

範例 3：使用 Session 參數

PS> $s = New-PSSession -ComputerName Server01
PS> Enter-PSSession -Session $s
[Server01]: PS>

這些命令會使用的 Enter-PSSession Session 參數，在現有的 PowerShell 工作階段中執行互動式會話（PSSession）。

範例 4：啟動互動式會話，並指定埠和認證參數

PS> Enter-PSSession -ComputerName Server01 -Port 90 -Credential Domain01\User01
[Server01]: PS>

此命令會啟動與 Server01 計算機的互動式作業階段。它會使用 Port 參數來指定埠和 Credential 參數，以指定有權連線到遠端電腦之使用者的帳戶。

範例 5：停止互動式會話

PS> Enter-PSSession -ComputerName Server01
[Server01]: PS> Exit-PSSession
PS>

此範例示範如何啟動和停止互動式會話。第一個命令會 Enter-PSSession 使用 Cmdlet 來啟動與 Server01 計算機的互動式會話。

第二個命令會 Exit-PSSession 使用 Cmdlet 結束會話。您也可以使用 Exit 關鍵詞結束互動式作業階段。 Exit-PSSession 和 Exit 具有相同的效果。

範例 6：使用 SSH 啟動互動式工作階段

PS> Enter-PSSession -HostName UserA@LinuxServer01

此範例示範如何使用安全殼層（SSH）啟動互動式會話。如果遠端電腦上的 SSH 設定為使用密碼，系統會提示您輸入密碼。否則，您必須使用金鑰型使用者驗證。

範例 7：使用 SSH 搭配埠和使用者驗證金鑰來啟動互動式工作階段

PS> Enter-PSSession -HostName UserA@LinuxServer02:22 -KeyFilePath c:\sshkeys\userAKey_rsa

此範例示範如何使用SSH啟動互動式會話。用戶名稱和 SSH 埠號碼會指定為 HostName 參數值的一部分。 KeyFilePath 參數會指定用來驗證遠端電腦上使用者之 RSA 金鑰的位置。

範例 8：使用 SSH 選項啟動互動式工作階段

$options = @{
    Port=22
    User = 'UserA'
    Host = 'LinuxServer02'
}
Enter-PSSession -KeyFilePath c:\sshkeys\userAKey_rsa -Options $options

此範例示範如何使用SSH啟動互動式會話。 Options 參數會採用值哈希表，這些值會當做選項傳遞至基礎ssh命令，且已建立與遠端系統的連線。

參數

-AllowRedirection

允許將此連線重新導向至替代的統一資源標識碼（URI）。根據預設，不允許重新導向。

當您使用 ConnectionURI 參數時，遠端目的地可以傳回指示以重新導向至不同的 URI。根據預設，PowerShell 不會重新導向連線，但您可以使用此參數來允許它重新導向連線。

您也可以變更 MaximumConnectionRedirectionCount 會話選項值，以限制重新導向連線的次數。 使用 Cmdlet 的 New-PSSessionOption MaximumRedirection 參數，或設定喜好設定變數的 $PSSessionOption MaximumConnectionRedirectionCount 屬性。預設值是 5。

類型:	SwitchParameter
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ApplicationName

指定連線 URI 的應用程式名稱區段。當您不使用 命令中的 ConnectionURI 參數時，請使用此參數來指定應用程式名稱。

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

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

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-Authentication

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

預設
基本
Credssp
Digest
Kerberos
交涉
NegotiateWithImplicitCredential

預設值為 Default。

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

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

警告

認證安全性支援提供者（CredSSP）驗證，其中使用者的認證會傳遞至要驗證的遠端電腦，其設計訴求是在多個資源上要求驗證的命令，例如存取遠端網路共用。此機制會增加遠端作業的安全性風險。如果遠端電腦遭到入侵，傳遞給它的認證可用來控制網路會話。

類型:	AuthenticationMechanism
接受的值:	Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-CertificateThumbprint

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

憑證將用於用戶端憑證式驗證。它們只能對應至本機用戶帳戶;它們無法與網域帳戶搭配使用。

若要取得憑證，請使用 Get-Item PowerShell憑證：磁碟驅動器中的或 Get-ChildItem 命令。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ComputerName

指定計算機名稱。此 Cmdlet 會啟動具有指定遠端電腦的互動式工作階段。只輸入一個計算機名稱。預設是本機電腦。

輸入 NetBIOS 名稱、IP 位址或電腦的完整功能變數名稱。您也可以使用管線將電腦名稱傳送至 Enter-PSSession。

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

注意

在 Windows 作業系統上，若要在 ComputerName 參數的值中包含本機電腦，您必須使用 [以系統管理員身分執行] 選項啟動 PowerShell。

類型:	String
別名:	Cn
Position:	0
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-ConfigurationName

指定用於互動式工作階段的工作階段組態。

輸入工作階段組態的組態名稱或完整資源URI。如果您只指定組態名稱，則前面會加上下列架構 URI： http://schemas.microsoft.com/powershell。

搭配 SSH 使用時，這會指定要在目標上使用的子系統，如 sshd_config 中所定義。 SSH 的預設值是 powershell 子系統。

會話的會話組態位於遠端電腦上。如果遠端電腦上沒有指定的工作階段組態，命令會失敗。

預設值是本機電腦上的喜好設定變數值 $PSSessionConfigurationName 。如果未設定此喜好設定變數，則預設值為 Microsoft.PowerShell。如需詳細資訊，請參閱 about_Preference_Variables。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-ConnectingTimeout

指定允許初始 SSH 連線完成的毫秒時間量。如果連線未在指定時間內完成，則會傳回錯誤。

此參數已在 PowerShell 7.2 中引進

類型:	Int32
Position:	Named
預設值:	unlimited
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ConnectionUri

指定 URI，定義工作階段的連接端點。 URI 必須完整。此字串格式如下所示：

<Transport>://<ComputerName>:<Port>/<ApplicationName>

預設值如下：

http://localhost:5985/WSMAN

如果您未指定 ConnectionURI，您可以使用 UseSSL、 ComputerName、 Port 和 ApplicationName 參數來指定 ConnectionURI 值。

URI 傳輸區段的有效值為 HTTP 和 HTTPS。如果您使用傳輸區段指定連線 URI，但未指定埠，則會使用標準埠來建立會話：80 代表 HTTP，而 HTTPS 則為 443。若要使用PowerShell遠端的預設埠，請針對 HTTP 指定埠 5985，或針對 HTTPS 指定埠 5986。

如果目的地計算機將連線重新導向至不同的 URI，除非您在命令中使用 AllowRedirection 參數，否則 PowerShell 會防止重新導向。

類型:	Uri
別名:	URI, CU
Position:	1
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-ContainerId

指定容器的識別碼。

類型:	String
Position:	0
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-Credential

指定具有執行此動作許可權的用戶帳戶。預設為目前使用者。

輸入用戶名稱，例如User01或Domain01\User01，或輸入 Cmdlet 所產生的 Get-Credential PSCredential 物件。如果您輸入使用者名稱，系統會提示您輸入密碼。

認證會儲存在 PSCredential 物件中，密碼會儲存為 SecureString。

注意

如需 SecureString 數據保護的詳細資訊，請參閱 SecureString 有多安全？。

類型:	PSCredential
Position:	1
預設值:	Current user
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-EnableNetworkAccess

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

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

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

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

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

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

類型:	SwitchParameter
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-HostName

指定安全殼層（SSH）型連線的電腦名稱。這類似於 ComputerName 參數，不同之處在於遠端電腦的連線是使用 SSH 而不是 Windows WinRM 進行。此參數支援使用格式 user@hostname:port，將用戶名稱和/或埠指定為主機名參數值的一部分。指定為主機名一部分的用戶名稱和/或埠會優先於 -UserName 和 -Port 參數，如果指定的話。這允許將多個計算機名稱傳遞至此參數，其中有些計算機名稱具有特定的用戶名稱和/或埠，而其他則使用和 -Port 參數的用戶-UserName名稱和/或埠。

此參數是在 PowerShell 6.0 中引進的。

類型:	String
Position:	0
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-Id

指定現有工作階段的識別碼。 Enter-PSSession 會針對互動式會話使用指定的會話。

若要尋找會話的標識碼，請使用 Get-PSSession Cmdlet。

類型:	Int32
Position:	0
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-InstanceId

指定現有工作階段的實例識別碼。 Enter-PSSession 會針對互動式會話使用指定的會話。

實例標識碼是 GUID。若要尋找會話的實例標識碼，請使用 Get-PSSession Cmdlet。您也可以使用 工作階段、名稱或 識別子 參數來指定現有的工作階段。或者，您可以使用 ComputerName 參數來啟動暫存會話。

類型:	Guid
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-KeyFilePath

指定安全殼層（SSH）用來驗證遠端電腦上的使用者金鑰檔案路徑。

SSH 可透過私人/公鑰執行使用者驗證，作為基本密碼驗證的替代方案。如果遠端電腦已設定金鑰驗證，則可以使用此參數來提供識別使用者的密鑰。

此參數是在 PowerShell 6.0 中引進的。

類型:	String
別名:	IdentityFilePath
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Name

指定現有工作階段的易記名稱。 Enter-PSSession 會針對互動式會話使用指定的會話。

如果您指定的名稱符合一個以上的會話，命令就會失敗。您也可以使用 Session、 InstanceID 或 ID 參數來指定現有的作業階段。或者，您可以使用 ComputerName 參數來啟動暫存會話。

若要建立會話的易記名稱，請使用 Cmdlet 的 New-PSSession Name 參數。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-Options

指定連線到遠端 SSH 型工作階段時所使用的 SSH 選項哈希表。可能的選項是 Unix 型 ssh 命令版本所支援的任何值。

參數明確傳遞的任何值優先於Options哈希表中傳遞的值。例如，使用 Port 參數會覆寫在 Options 哈希表中傳遞的任何Port機碼/值組。

類型:	Hashtable
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Port

指定遠端電腦上用於此命令的網路埠。

在 PowerShell 6.0 中，此參數包含在支援安全殼層（SSH）連線的 HostName 參數集中。

WinRM （ComputerName 参数集）

若要連線到遠端電腦，遠端計算機必須接聽連線所使用的埠。默認埠為 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 參數。命令中的埠設定會套用至命令執行所在的所有計算機或會話。替代埠設定可能會防止命令在所有計算機上執行。

SSH （HostName 參數集）

若要連線到遠端電腦，遠端計算機必須設定為 SSH 服務（SSHD），而且必須接聽連線所使用的埠。 SSH 的預設埠為 22。

類型:	Int32
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-RunAsAdministrator

指出 PSSession 是以系統管理員身分執行。

類型:	SwitchParameter
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Session

指定要用於互動式會話的PowerShell工作階段（PSSession）。此參數會採用會話物件。您也可以使用 Name、InstanceID 或 ID 參數來指定 PSSession。

輸入包含會話物件的變數，或建立或取得會話物件的命令，例如 New-PSSession 或 Get-PSSession 命令。您也可以使用管線將會話物件傳送至 Enter-PSSession。您可以使用此參數只提交一個 PSSession 。如果您輸入包含多個 PSSession 的變數，命令會失敗。

當您使用 Exit-PSSession 或 EXIT 關鍵詞時，互動式會話會結束，但 您所建立的 PSSession 會保持開啟且可供使用。

類型:	PSSession
Position:	0
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-SessionOption

設定工作階段的進階選項。 輸入 SessionOption 物件，例如您使用 New-PSSessionOption Cmdlet 建立的物件，或索引鍵是會話選項名稱的哈希表，而值是會話選項值。

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

會話選項值優先於喜好設定變數和會話組態中 $PSSessionOption 設定之會話的預設值。不過，它們不會優先於會話設定中設定的最大值、配額或限制。

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

類型:	PSSessionOption
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-SSHTransport

指出遠端連線是使用安全殼層（SSH）建立的。

根據預設，PowerShell 會使用 Windows WinRM 連線到遠端電腦。此參數會強制 PowerShell 使用 HostName 參數集來建立 SSH 型遠端連線。

此參數是在 PowerShell 6.0 中引進的。

類型:	SwitchParameter
接受的值:	true
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Subsystem

指定用於新 PSSession 的 SSH 子系統。

這會指定要在目標上使用的子系統，如sshd_config中所定義。子系統會使用預先定義的參數啟動特定版本的 PowerShell。如果遠端電腦上沒有指定的子系統，命令會失敗。

如果未使用此參數，則預設值為 powershell 子系統。

類型:	String
Position:	Named
預設值:	Powershell
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-UserName

指定用來在遠端電腦上建立工作階段之帳戶的用戶名稱。使用者驗證方法取決於遠端電腦上的安全殼層（SSH）設定方式。

如果 SSH 已設定為基本密碼驗證，系統會提示您輸入用戶密碼。

如果 SSH 已針對金鑰型使用者驗證進行設定，則不會提示 uou 輸入密碼。您必須提供 SSH 金鑰檔案的路徑。如果使用者金鑰檔案位於 SSH 已知位置， 則不需要 KeyFilePath 參數。使用者驗證會根據使用者名稱自動發生。如需詳細資訊，請參閱有關密鑰型使用者驗證的 SSH 檔。

如果未指定 UserName 參數，則會使用目前登入的用戶名稱。

此參數是在 PowerShell 6.0 中引進的。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-UseSSL

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

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

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

類型:	SwitchParameter
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-VMId

指定虛擬機的識別碼。

類型:	Guid
別名:	VMGuid
Position:	0
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-VMName

指定虛擬機的名稱。

類型:	String
Position:	0
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

輸入

String

您可以使用管線將電腦名稱當做字串傳送至此 Cmdlet。

PSSession

您可以使用管線將會話物件傳送至此 Cmdlet。

輸出

None

此 Cmdlet 不會傳回任何輸出。

備註

PowerShell 包含下列的 Enter-PSSession別名：

所有平臺：
- etsn

若要連線到遠端電腦，您必須是遠端電腦上的 Administrators 群組成員。若要在本機計算機上啟動互動式會話，您必須使用 [ 以系統管理員 身分執行] 選項啟動 PowerShell。

當您使用 Enter-PSSession時，遠端電腦上的使用者配置檔會用於互動式會話。遠端使用者設定檔中的命令，包括新增 PowerShell 模組和變更命令提示字元的命令，在顯示遠端提示字元之前執行。

Enter-PSSession 會針對互動式會話使用本機電腦上的UI文化特性設定。若要尋找本機 UI 文化特性，請使用 $UICulture 自動變數。

Enter-PSSessionGet-Command需要、 Out-Default和 Exit-PSSession Cmdlet。如果遠端電腦上的會話設定中未包含這些 Cmdlet，則 Enter-PSSession 命令會失敗。

不同於 Invoke-Command，它會先剖析並解譯命令，再將命令傳送至遠端計算機， Enter-PSSession 而不需解譯即可直接將命令傳送至遠端電腦。

如果您想要輸入的會話正忙於處理命令，則 PowerShell 回應 Enter-PSSession 命令之前可能會有延遲。一旦會話可供使用，您就會連線。若要取消Enter-PSSession命令，請按 CTRL+C。

HostName 參數集從 PowerShell 6.0 開始包含。它已新增，以根據安全殼層（SSH）提供 PowerShell 遠端功能。在多個平臺（Windows、Linux、macOS）和 PowerShell 遠端處理上都支援 SSH 和 PowerShell 遠端處理，這些平臺會安裝並設定 PowerShell 和 SSH。這與先前的 Windows 只有以 WinRM 為基礎的遠端處理不同，而且大部分的 WinRM 特定功能和限制都不適用。例如，目前不支援 WinRM 型配額、工作階段選項、自定義端點設定和中斷連線/重新連線功能。如需如何設定PowerShell SSH 遠端的詳細資訊，請參閱透過SSH進行PowerShell遠端處理。

在 PowerShell 7.1 之前，透過 SSH 進行遠端處理不支援第二個躍點遠端會話。這項功能僅限於使用 WinRM 的會話。 PowerShell 7.1 允許 Enter-PSSession 及 Enter-PSHostProcess 從任何互動式遠端會話內運作。

可執行檔案 ssh 會依下列順序從下列來源取得組態資料：

命令行選項
使用者的組態檔（~/.ssh/config）
全系統組態檔（/etc/ssh/ssh_config）

下列 Cmdlet 參數會對應至 ssh 參數和選項：

Cmdlet 參數	ssh 參數	對等 ssh -o 選項
`-KeyFilePath`	`-i <KeyFilePath>`	`-o IdentityFile=<KeyFilePath>`
`-UserName`	`-l <UserName>`	`-o User=<UserName>`
`-Port`	`-p <Port>`	`-o Port=<Port>`
`-ComputerName -Subsystem`	`-s <ComputerName> <Subsystem>`	`-o Host=<ComputerName>`

參數明確傳遞的任何值優先於Options哈希表中傳遞的值。如需檔案的詳細資訊 ssh_config ，請參閱 ssh_config（5）。

共用方式為

Enter-PSSession

語法

Description

範例

範例 1：啟動互動式會話

範例 2：使用互動式會話

範例 3：使用 Session 參數

範例 4：啟動互動式會話，並指定埠和認證參數

範例 5：停止互動式會話

範例 6：使用 SSH 啟動互動式工作階段

範例 7：使用 SSH 搭配埠和使用者驗證金鑰來啟動互動式工作階段

範例 8：使用 SSH 選項啟動互動式工作階段

參數

-AllowRedirection

-ApplicationName

-Authentication

-CertificateThumbprint

-ComputerName

-ConfigurationName

-ConnectingTimeout

-ConnectionUri

-ContainerId

-Credential

-EnableNetworkAccess

-HostName

-Id

-InstanceId

-KeyFilePath

-Name

-Options

-Port

-RunAsAdministrator

-Session

-SessionOption

-SSHTransport

-Subsystem

-UserName

-UseSSL

-VMId

-VMName

輸入

輸出

備註

相關連結

其他資源