Enter-PSSession
啟動遠端電腦的互動式工作階段。
Syntax
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
。
範例
範例 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。
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ApplicationName
指定連線 URI 的應用程式名稱區段。 當您沒有在命令中使用 ConnectionURI 參數時,請使用這個參數來指定應用程式名稱。
預設值是本機電腦上的喜好設定變數值 $PSSessionApplicationName
。 若未定義此喜好設定變數,則預設值是 WSMAN。 這個值適用於大部分用途。 如需詳細資訊,請參閱 about_Preference_Variables。
WinRM 服務會使用應用程式名稱來選取接聽程式來服務連線要求。 此參數的值應該符合遠端電腦上接聽程式之 URLPrefix 屬性的值。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Authentication
指定用來驗證使用者認證的機制。 此參數可接受的值為:
- Default
- 基本資訊
- Credssp
- Digest
- Kerberos
- 交涉
- NegotiateWithImplicitCredential
預設值為 Default。
CredSSP 驗證僅適用於 Windows Vista、Windows Server 2008 和更新版本的 Windows 操作系統。
如需此參數值的詳細資訊,請參閱 AuthenticationMechanism 列舉。
警告
使用者認證會傳遞至要驗證之遠端電腦的「認證安全性支援提供者 (CredSSP)」驗證,是設計用於需要在一個以上資源進行驗證的命令,例如存取遠端網路共用。 此機制會使得遠端作業的安全性風險變高。 若遠端電腦遭到入侵,傳遞給它的認證便可用來控制網路工作階段。
Type: | AuthenticationMechanism |
Accepted values: | Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CertificateThumbprint
對於具有執行此動作之權限的使用者帳戶,指定其數位公開金鑰憑證 (X509)。 請輸入憑證的憑證指紋。
憑證將用於用戶端憑證式驗證。 這些憑證只能對應至本機使用者帳戶,無法用於網域帳戶。
若要取得憑證,請在PowerShell憑證:磁碟驅動器中使用 Get-Item
或 Get-ChildItem
命令。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ComputerName
指定計算機名稱。 此 Cmdlet 會啟動具有指定遠端電腦的互動式工作階段。 僅輸入電腦名稱。 預設是本機電腦。
輸入電腦的 NetBIOS 名稱、IP 位址或完整網域名稱。 您也可以使用管線將電腦名稱傳送至 Enter-PSSession
。
若要在 ComputerName 參數的值中使用 IP 位址,命令必須包含 Credential 參數。 此外,必須將電腦設定為使用 HTTPS 傳輸,或必須在本機電腦的 WinRM TrustedHosts 清單中包含遠端電腦的 IP 位址。 如需將計算機名稱新增至 TrustedHosts 清單的指示,請參閱 about_Remote_Troubleshooting中的。
注意
在 Windows 作業系統上,若要在 ComputerName 參數的值中包含本機電腦,您必須使用 [以系統管理員身分執行] 選項啟動 PowerShell。
Type: | String |
Aliases: | Cn |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ConfigurationName
指定用於互動式工作階段的工作階段設定。
輸入工作階段設定的設定名稱或完整資源 URI。 如果您只指定組態名稱,則前面會加上下列架構 URI: http://schemas.microsoft.com/powershell
。
搭配 SSH 使用時,這會指定要在目標上使用的子系統,如sshd_config中所定義。 SSH 的預設值是 powershell
子系統。
工作階段的工作階段設定是位於遠端電腦上。 如果遠端電腦上沒有指定的工作階段設定,則命令會失敗。
預設值是本機電腦上的喜好設定變數值 $PSSessionConfigurationName
。 若未設定此喜好設定變數,則預設為 Microsoft.PowerShell。 如需詳細資訊,請參閱 about_Preference_Variables。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ConnectingTimeout
指定允許初始 SSH 連線完成的毫秒時間量。 如果連線未在指定時間內完成,則會傳回錯誤。
此參數是在 PowerShell 7.2 中引進的
Type: | Int32 |
Position: | Named |
Default value: | unlimited |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ConnectionUri
指定 URI,定義工作階段的連接端點。 此 URI 必須是完整的 URI。 這個字串的格式如下所示:
<Transport>://<ComputerName>:<Port>/<ApplicationName>
預設值如下:
http://localhost:5985/WSMAN
如果您未指定 ConnectionURI,可以使用 UseSSL、ComputerName、Port 及 ApplicationName 參數來指定 ConnectionURI 值。
URI 的 Transport 區段有效值為 HTTP 與 HTTPS。 如果您使用傳輸區段指定連線 URI,但未指定埠,則會使用標準埠來建立會話:80 用於 HTTP,而 HTTPS 則為 443。 若要使用PowerShell遠端處理的預設埠,請指定 HTTP 的埠 5985 或 HTTPS 的埠 5986。
如果目的地計算機將連線重新導向至不同的 URI,除非您在 命令中使用 AllowRedirection 參數,否則 PowerShell 會防止重新導向。
Type: | Uri |
Aliases: | URI, CU |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ContainerId
指定容器的識別碼。
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Credential
指定具有執行此動作權限的使用者帳戶。 預設為目前使用者。
輸入用戶名稱,例如User01或Domain01\User01,或輸入 Cmdlet 所產生的 Get-Credential
PSCredential 物件。 如果您輸入使用者名稱,系統會提示您輸入密碼。
認證會儲存在 PSCredential 物件中,密碼會儲存為 SecureString。
注意
如需 SecureString 數據保護的詳細資訊,請參閱 SecureString 有多安全?。
Type: | PSCredential |
Position: | 1 |
Default value: | Current user |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-EnableNetworkAccess
指出此 Cmdlet 會將互動式安全性令牌新增至回送會話。 互動式權杖可讓您在會從其他電腦取得資料的回送工作階段中執行命令。 例如,您可以在會將 XML 檔案從遠端電腦複製到本機電腦的工作階段中執行命令。
回送會話是源自於同一部計算機上的 PSSession 。 若要建立回送工作階段,請省略 ComputerName 參數,或將其值設定為 。 (點) 、localhost 或本機計算機的名稱。
根據預設,會使用網路令牌來建立回送會話,這可能無法提供足夠的許可權來向遠端計算機進行驗證。
EnableNetworkAccess 參數只在回送工作階段中有效。 如果您在遠端電腦上建立會話時使用 EnableNetworkAccess ,命令會成功,但會忽略 參數。
您也可以允許回送工作階段中的遠端存取,方式是使用 CredSSP 參數的 Authentication 值,這樣會把工作階段認證委派給其他電腦。
此參數是在 Windows PowerShell 3.0 引進。
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-HostName
指定安全殼層 (SSH) 型連線的計算機名稱。 這類似於 ComputerName 參數,不同之處在於遠端電腦的連線是使用 SSH 而非 Windows WinRM 進行。 此參數支援使用 格式 user@hostname:port
,將用戶名稱和/或埠指定為主機名參數值的一部分。 指定為主機名一部分的用戶名稱和/或埠優先於 -UserName
和 -Port
參數。如果指定的話。 這允許將多個計算機名稱傳遞至此參數,其中有些有特定的用戶名稱和/或埠,而其他則使用 和 -Port
參數的用戶-UserName
名稱和/或埠。
此參數是在 PowerShell 6.0 中引進。
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Id
指定現有工作階段的識別碼。 Enter-PSSession
會針對互動式會話使用指定的會話。
若要尋找會話的標識碼,請使用 Get-PSSession
Cmdlet。
Type: | Int32 |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-InstanceId
指定現有工作階段的執行個體識別碼。 Enter-PSSession
會針對互動式會話使用指定的會話。
執行個體識別碼是 GUID。 若要尋找會話的實例標識碼,請使用 Get-PSSession
Cmdlet。 您也可以使用 工作階段、 名稱或 識別子 參數來指定現有的工作階段。 或者,您可以使用 ComputerName 參數來啟動暫存會話。
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-KeyFilePath
指定安全殼層 (SSH) 用來驗證遠端電腦上的使用者所使用的金鑰檔案路徑。
SSH 可讓使用者透過私人/公鑰執行驗證,做為基本密碼驗證的替代方案。 如果遠端電腦設定為進行金鑰驗證,則可以使用此參數來提供識別使用者的密鑰。
此參數是在 PowerShell 6.0 中引進。
Type: | String |
Aliases: | IdentityFilePath |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
指定現有工作階段的好記名稱。 Enter-PSSession
會針對互動式會話使用指定的會話。
如果您指定的名稱符合多個工作階段,此命令會失敗。 您也可以使用 Session、 InstanceID 或 ID 參數來指定現有的作業階段。 或者,您可以使用 ComputerName 參數來啟動暫存會話。
若要建立會話的易記名稱,請使用 Cmdlet 的 New-PSSession
Name 參數。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Options
指定連線到遠端 SSH 型工作階段時所使用的 SSH 選項哈希表。 可能的選項是 Unix 型 ssh 命令版本所支援的任何值。
參數明確傳遞的任何值都優先於 選項 哈希表中傳遞的值。 例如,使用 Port 參數會覆寫在 Options 哈希表中傳遞的任何Port
機碼/值組。
Type: | Hashtable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Port
指定遠端電腦上用於此命令的網路埠。
在 PowerShell 6.0 中,此參數包含在 HostName 參數集中,其支援安全殼層 (SSH) 連線。
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。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunAsAdministrator
表示 PSSession 以系統管理員身分執行。
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Session
指定要用於互動式會話的 PowerShell工作階段 (PSSession) 。 這個參數接受工作階段物件。 您也可以使用 Name、 InstanceID 或 ID 參數來指定 PSSession。
輸入包含會話物件的變數,或建立或取得會話物件的命令,例如 New-PSSession
或 Get-PSSession
命令。 您也可以使用管線將會話物件傳送至 Enter-PSSession
。 您只能使用此參數提交一個 PSSession 。 如果您輸入的變數包含多個 PSSession,命令會失敗。
當您使用 Exit-PSSession
或 EXIT 關鍵詞時,互動式會話會結束,但您所建立的 PSSession 會保持開啟且可供使用。
Type: | PSSession |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SessionOption
設定工作階段的進階選項。 輸入 SessionOption 物件,例如您使用 New-PSSessionOption
Cmdlet 建立的物件,或索引鍵為會話選項名稱的哈希表,以及值是會話選項值。
如果已設定,選項的預設值取決於喜好設定變數的值 $PSSessionOption
。 否則,將以工作階段設定中設定的選項建立預設值。
會話選項值優先於喜好設定變數和會話組態中所設定 $PSSessionOption
會話的預設值。 不過,它們的優先順序不會高於工作階段設定中設定的最大值、配額或限制。
如需工作階段選項的描述,包括預設值,請參閱 New-PSSessionOption
。
如需喜好設定變數的相關信息 $PSSessionOption
,請參閱 about_Preference_Variables。 如需會話設定的詳細資訊,請參閱 about_Session_Configurations。
Type: | PSSessionOption |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SSHTransport
表示使用安全殼層 (SSH) 建立遠端連線。
根據預設,PowerShell 會使用 Windows WinRM 連線到遠端電腦。 此參數會強制 PowerShell 使用 HostName 參數集來建立 SSH 型遠端連線。
此參數是在 PowerShell 6.0 中引進。
Type: | SwitchParameter |
Accepted values: | true |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Subsystem
指定用於新 PSSession 的 SSH 子系統。
這會指定要在目標上使用的子系統,如sshd_config中所定義。 子系統會使用預先定義的參數來啟動特定版本的PowerShell。 如果遠端電腦上沒有指定的子系統,命令就會失敗。
如果未使用此參數,預設值為 『powershell』 子系統。
Type: | String |
Position: | Named |
Default value: | Powershell |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-UserName
指定用來在遠端電腦上建立工作階段之帳戶的用戶名稱。 使用者驗證方法將取決於遠端電腦上設定安全殼層 (SSH) 的方式。
如果 SSH 設定為基本密碼驗證,系統會提示您輸入用戶密碼。
如果 SSH 設定為金鑰型使用者驗證,則可以透過 KeyFilePath 參數提供金鑰檔案路徑,而且不會發生密碼提示。 請注意,如果用戶端使用者密鑰檔案位於 SSH 已知位置,則密鑰型驗證不需要 KeyFilePath 參數,而且使用者驗證會根據使用者名稱自動發生。 如需詳細資訊,請參閱有關密鑰型使用者驗證的 SSH 檔。
這不是必要的參數。 如果未指定 UserName 參數,則會將目前的登入使用者名稱用於連線。
此參數是在 PowerShell 6.0 中引進。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseSSL
表示此 Cmdlet 會使用安全套接字層 (SSL) 通訊協定來建立遠端電腦的連線。 預設不會使用 SSL。
WS-Management 會加密透過網路傳輸的所有PowerShell內容。 UseSSL 參數是額外的保護,可跨 HTTPS 連線傳送數據,而不是 HTTP 連線。
如果您使用此參數,但在用於命令的埠上無法使用 SSL,命令會失敗。
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VMId
指定虛擬機的識別碼。
Type: | Guid |
Aliases: | VMGuid |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-VMName
指定虛擬機器的名稱。
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
輸入
您可以使用管線將電腦名稱當作字串傳送至此 Cmdlet。
您可以使用管線將工作階段物件傳送至此 Cmdlet。
輸出
None
此 Cmdlet 不會傳回任何輸出。
備註
PowerShell 包含下列的 Enter-PSSession
別名:
- 所有平台:
etsn
若要連線遠端電腦,您必須是遠端電腦上 Administrators 群組的成員。 若要在本機計算機上啟動互動式會話,您必須使用 [ 以系統管理員身 分執行] 選項啟動 PowerShell。
當您使用 Enter-PSSession
時,遠端電腦上的使用者配置檔會用於互動式會話。 遠端使用者設定檔中的命令,包括新增 PowerShell 模組的命令,以及變更命令提示字元,在顯示遠端提示字元之前執行。
Enter-PSSession
會在本機電腦上針對互動式會話使用UI文化特性設定。 若要尋找本機 UI 文化特性,請使用 $UICulture
自動變數。
Enter-PSSession
Get-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> |
參數明確傳遞的任何值都優先於 選項 哈希表中傳遞的值。 如需檔案的詳細資訊 ssh_config
,請參閱 ssh_config (5) 。