Enter-PSSession
启动与远程计算机的交互式会话。
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>]
Enter-PSSession
cmdlet 可启动与单台远程计算机的交互式会话。 在会话期间,你键入的命令将在远程计算机上运行,就像你直接在远程计算机上进行键入一样。 一次只可以进行一个交互式会话。
通常,你可以使用 ComputerName 参数来指定远程计算机的名称。
不过,也可以将通过 New-PSSession
cmdlet 创建的会话用于交互式会话。 但是,不能使用 Disconnect-PSSession
Connect-PSSession
cmdlet Receive-PSSession
断开或重新连接到交互式会话的连接。
从 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
传递给可执行文件。
PS> Enter-PSSession
[localhost]: PS>
此命令将在本地计算机上启动交互式会话。 命令提示符将发生更改,以指示你现在正在不同的会话中运行命令。
你输入的命令将在该新会话中运行,而结果将以文本形式返回到默认会话中。
第一个命令使用 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
此命令显示了如何在与远程计算机的交互式会话中进行工作。
PS> $s = New-PSSession -ComputerName Server01
PS> Enter-PSSession -Session $s
[Server01]: PS>
这些命令使用 Enter-PSSession
的 Session 参数在现有 PowerShell 会话 (PSSession) 中运行交互式会话。
PS> Enter-PSSession -ComputerName Server01 -Port 90 -Credential Domain01\User01
[Server01]: PS>
此命令启动与 Server01 计算机的交互式会话。 它使用 Port 参数指定端口,并使用 Credential 参数指定有权连接到远程计算机的用户帐户。
PS> Enter-PSSession -ComputerName Server01
[Server01]: PS> Exit-PSSession
PS>
此示例显示了如何启动和停止交互式会话。 第一个命令使用 Enter-PSSession
cmdlet 来启动与 Server01 计算机的交互式会话。
第二个命令使用 Exit-PSSession
cmdlet 来结束该会话。 还可以使用 Exit 关键字来结束该交互式会话。 Exit-PSSession
和 Exit 具有相同的效果。
PS> Enter-PSSession -HostName UserA@LinuxServer01
此示例演示如何使用安全外壳 (SSH) 启动交互式会话。 如果在远程计算机上配置 SSH 以使用密码,系统会提示输入密码。 否则,必须使用基于密钥的用户身份验证。
PS> Enter-PSSession -HostName UserA@LinuxServer02:22 -KeyFilePath c:\sshkeys\userAKey_rsa
此示例演示如何使用 SSH 启动交互式会话。 用户名和 SSH 端口号指定为 HostName 参数值的一部分。 KeyFilePath 参数指定用于对远程计算机上的用户进行身份验证的 RSA 密钥的位置。
$options = @{
Port=22
User = 'UserA'
Host = 'LinuxServer02'
}
Enter-PSSession -KeyFilePath c:\sshkeys\userAKey_rsa -Options $options
此示例演示如何使用 SSH 启动交互式会话。 Options 参数采用值的哈希表,这些值作为选项传递到与远程系统建立连接的基础 ssh
命令。
允许将此连接重定向到备用统一资源标识符 (URI)。 默认情况下,不允许重定向。
使用 ConnectionURI 参数时,远程目标将返回一个指令,以重定向到不同的 URI。 默认情况下,PowerShell 不会重定向连接,但你可以使用此参数允许它重定向连接。
也可以通过更改 MaximumConnectionRedirectionCount 会话选项值,限制重定向连接的次数。 使用 New-PSSessionOption
cmdlet 的 MaximumRedirection 参数或设置 $PSSessionOption
首选项变量的 MaximumConnectionRedirectionCount 属性。 默认值为 5。
类型: | SwitchParameter |
Position: | Named |
默认值: | False |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
指定连接 URI 的应用程序名称段。 当命令中未使用 ConnectionURI 参数时,请使用此参数指定应用程序名称。
默认值为本地计算机上的 $PSSessionApplicationName
首选项变量的值。 如果未定义此首选项变量,则默认值为“WSMAN”。 该值适用于大多数使用情况。 有关详细信息,请参阅 about_Preference_Variables。
WinRM 服务使用应用程序名称来选择为连接请求提供服务的侦听器。 此参数的值应与远程计算机上的侦听器的 URLPrefix 属性值相匹配。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | True |
接受通配符: | False |
指定用于对用户的凭据进行身份验证的机制。 此参数的可接受值为:
- 默认值
- 基本
- Credssp
- 摘要
- Kerberos
- Negotiate
- 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 |
指定有权执行此操作的用户帐户的数字公钥证书 (X509)。 输入证书的证书指纹。
在基于客户端证书的身份验证中使用证书。 证书只能映射到本地用户帐户,而不适用于域帐户。
若要获取证书,请在 PowerShell Cert: 驱动器中使用 Get-Item
或 Get-ChildItem
命令。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
指定计算机名称。 此 cmdlet 将启动与指定远程计算机的交互式会话。 仅输入一个计算机名称。 默认为本地计算机。
键入计算机的 NetBIOS 名称、IP 地址或完全限定的域名。 还可以通过管道将计算机名称传递给 Enter-PSSession
。
若要在 ComputerName 参数的值中使用 IP 地址,该命令必须包括 Credential 参数。 此外,必须为计算机配置 HTTPS 传输,或者必须在本地计算机上的 WinRM TrustedHosts 列表中包含远程计算机的 IP 地址。 有关将计算机名称添加到 TrustedHosts 列表的说明,请参阅 about_Remote_Troubleshooting 中的“如何将计算机添加到受信任主机列表中”。
备注
在 Windows 操作系统上,要将本地计算机包含在 ComputerName 参数的值中,必须使用“以管理员身份运行”选项启动 PowerShell。
类型: | String |
别名: | Cn |
Position: | 0 |
默认值: | None |
必需: | True |
接受管道输入: | True |
接受通配符: | False |
指定用于交互式会话的会话配置。
输入会话配置的配置名称或完全限定的资源 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 |
指定初始 SSH 连接完成所允许的时间(以毫秒为单位)。 如果连接未在指定时间内完成,则会返回错误。
此参数是在 PowerShell 7.2 中引入的
类型: | Int32 |
Position: | Named |
默认值: | unlimited |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
指定定义会话的连接终结点的 URI。 URI 必须完全限定。 此字符串的格式如下:
<Transport>://<ComputerName>:<Port>/<ApplicationName>
默认值如下:
http://localhost:5985/WSMAN
如果未指定 ConnectionURI,可以使用 UseSSL、ComputerName、Port 和 ApplicationName 参数来指定 ConnectionURI 值。
URI 的 Transport 段的有效值为 HTTP 和 HTTPS。 如果使用传输段指定连接 URI,但未指定端口,则会话是使用标准端口创建的:80 for HTTP,对于 HTTPS 为 443。 若要使用 PowerShell 远程处理的默认端口,请指定 HTTP 端口 5985 或 HTTPS 端口 5986。
如果目标计算机将连接重定向到另一个 URI,PowerShell 将阻止重定向,除非在命令中使用 AllowRedirection 参数。
类型: | Uri |
别名: | URI, CU |
Position: | 1 |
默认值: | None |
必需: | False |
接受管道输入: | True |
接受通配符: | False |
指定容器 ID。
类型: | String |
Position: | 0 |
默认值: | None |
必需: | True |
接受管道输入: | True |
接受通配符: | False |
指定有权执行此操作的用户帐户。 默认为当前用户。
键入用户名,如 User01 或 Domain01\User01;或输入 Get-Credential
cmdlet 生成的 PSCredential 对象。 如果键入用户名,系统会提示输入密码。
凭据存储在 PSCredential 对象中,密码存储为 SecureString。
备注
有关 SecureString 数据保护的详细信息,请参阅 SecureString 的安全性如何?。
类型: | PSCredential |
Position: | 1 |
默认值: | Current user |
必需: | False |
接受管道输入: | True |
接受通配符: | False |
指示此 cmdlet 将交互式安全令牌添加到环回会话。 通过交互式令牌,你可以在环回会话中运行用于获取其他计算机中的数据的命令。 例如,你可以在该会话中运行用于将 XML 文件从远程计算机复制到本地计算机的命令。
环回会话是在同一计算机上开始并终止的 PSSession。 若要创建环回会话,请省略 ComputerName 参数,或将其值设置为 . (点)、localhost 或本地计算机的名称。
默认情况下,使用网络令牌创建环回会话,该令牌提供的权限可能不足以对远程计算机进行身份验证。
EnableNetworkAccess 参数仅在环回会话中有效。 如果在远程计算机上创建会话时使用 EnableNetworkAccess,该命令将成功,但会忽略此参数。
通过用于将会话凭据委派给其他计算机的 Authentication 参数的 CredSSP 值,还可以在环回会话中进行远程访问。
已在 Windows PowerShell 3.0 中引入了此参数。
类型: | SwitchParameter |
Position: | Named |
默认值: | False |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
为基于安全外壳 (SSH) 的连接指定计算机名称。 这与 ComputerName 参数类似,只不过与远程计算机的连接是使用 SSH 而不是 Windows WinRM 建立的。 此参数支持使用 user@hostname:port
形式将用户名和/或端口指定为主机名参数值的一部分。 作为主机名一部分指定的用户名和/或端口优先于 -UserName
和 -Port
参数(如果指定)。 这允许将多个计算机名称传递给此参数,其中一些计算机名称具有特定的用户名和/或端口,而其他计算机名称则使用 -UserName
和 -Port
参数中的用户名和/或端口。
此参数是在 PowerShell 6.0 中引入的。
类型: | String |
Position: | 0 |
默认值: | None |
必需: | True |
接受管道输入: | True |
接受通配符: | False |
指定现有会话的 ID。 Enter-PSSession
使用指定会话进行交互式会话。
若要查找某个会话的 ID,请使用 Get-PSSession
cmdlet。
类型: | Int32 |
Position: | 0 |
默认值: | None |
必需: | False |
接受管道输入: | True |
接受通配符: | False |
指定现有会话的实例 ID。 Enter-PSSession
使用指定会话进行交互式会话。
实例 ID 是一个 GUID。 若要查找某个会话的 ID,请使用 Get-PSSession
cmdlet。 也可以使用 Session、Name 或 ID 参数来指定现有会话。 或者,可以使用 ComputerName 参数来启动临时会话。
类型: | Guid |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | True |
接受通配符: | False |
指定安全外壳 (SSH) 用于对远程计算机上的用户进行身份验证的密钥文件路径。
SSH 允许通过私钥/公钥执行用户身份验证,作为基本密码身份验证的替代方案。 如果远程计算机配置为密钥身份验证,则此参数可用于提供标识用户的密钥。
此参数是在 PowerShell 6.0 中引入的。
类型: | String |
别名: | IdentityFilePath |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
指定现有会话的友好名称。 Enter-PSSession
使用指定会话进行交互式会话。
如果你指定的名称与多个会话相匹配,则该命令会失败。 也可以使用 Session、InstanceID 或 ID 参数来指定现有会话。 或者,可以使用 ComputerName 参数来启动临时会话。
若要为会话建立友好名称,请使用 New-PSSession
的 Name 参数。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | True |
接受通配符: | False |
指定连接到基于 SSH 的远程会话时使用的 SSH 选项的哈希表。 可能的选项是基于 Unix 版本的 ssh 命令支持的任何值。
由参数显式传递的任何值都优先于在 Options 哈希表中传递的值。 例如,使用端口参数会覆盖在选项哈希表中传递的任何 Port
键值对。
类型: | Hashtable |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
指定用于此命令的远程计算机上的网络端口。
在 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\>"}
除非必要,否则不要使用端口参数。 命令中的端口设置适用于运行该命令的所有计算机或会话。 备用端口设置可能会阻止在所有计算机上运行该命令。
SSH(HostName 参数集)
若要连接到远程计算机,远程计算机必须配置 SSH 服务 (SSHD),并且必须侦听连接使用的端口。 SSH 的默认端口为 22。
类型: | Int32 |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
指示 PSSession 以管理员身份运行。
类型: | SwitchParameter |
Position: | Named |
默认值: | False |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
指定要用于交互式会话的 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 对象(例如使用 New-PSSessionOption
cmdlet 创建的对象),或输入哈希表,其中的键是会话选项名称,而值是会话选项值。
这些选项的默认值由 $PSSessionOption
首选项变量的值(如果已设置)确定。 否则,通过在会话配置中设置的选项创建默认值。
会话选项值优先于在 $PSSessionOption
首选项变量和会话配置中设置的会话的默认值。 但是,它们不优先于会话配置中设置的最大值、配额或限制。
有关会话选项(包括默认值)的说明,请参阅 New-PSSessionOption
。
有关 $PSSessionOption
首选项变量的信息,请参阅 about_Preference_Variables。 有关会话配置的详细信息,请参阅 about_Session_Configurations。
类型: | PSSessionOption |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
指示使用安全外壳 (SSH) 建立远程连接。
默认情况下,PowerShell 使用 Windows WinRM 连接到远程计算机。 此开关强制 PowerShell 使用 HostName 参数集建立基于 SSH 的远程连接。
此参数是在 PowerShell 6.0 中引入的。
类型: | SwitchParameter |
接受的值: | true |
Position: | Named |
默认值: | False |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
指定用于新 PSSession 的 SSH 子系统。
这会指定要在 sshd_config 中定义的目标上使用的子系统。 该子系统使用预定义的参数启动特定版本的 PowerShell。 如果远程计算机上不存在指定的子系统,该命令将失败。
如果未使用此参数,则默认值为 powershell
子系统。
类型: | String |
Position: | Named |
默认值: | Powershell |
必需: | False |
接受管道输入: | True |
接受通配符: | False |
指定用于在远程计算机上创建会话的帐户的用户名。 用户身份验证方法取决于在远程计算机上配置安全外壳(SSH)的方式。
如果 SSH 配置为基本密码身份验证,系统会提示输入用户密码。
如果为基于密钥的用户身份验证配置 SSH,则系统不会提示输入密码。 必须提供 SSH 密钥文件的路径。 如果用户密钥文件位于 SSH 已知位置, 则不需要 KeyFilePath 参数。 用户身份验证根据用户名自动进行。 有关详细信息,请参阅有关基于密钥的用户身份验证的 SSH 文档。
如果未指定 UserName 参数,则使用当前登录的用户名。
此参数是在 PowerShell 6.0 中引入的。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
指示此 cmdlet 使用安全套接字层 (SSL) 协议来建立与远程计算机的连接。 默认情况下,不使用 SSL。
WS-Management 对通过网络传输的所有 PowerShell 内容进行加密。 UseSSL 参数是一种额外的保护措施,它通过 HTTPS 连接而不是 HTTP 连接来发送数据。
如果使用此参数,但 SSL 在用于命令的端口上不可用,该命令将失败。
类型: | SwitchParameter |
Position: | Named |
默认值: | False |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
指定虚拟机的 ID。
类型: | Guid |
别名: | VMGuid |
Position: | 0 |
默认值: | None |
必需: | True |
接受管道输入: | True |
接受通配符: | False |
指定虚拟机的名称。
类型: | String |
Position: | 0 |
默认值: | None |
必需: | True |
接受管道输入: | True |
接受通配符: | 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。
从 PowerShell 6.0 开始,包含了 HostName 参数集。 添加它是为了提供基于安全外壳 (SSH) 的 PowerShell 远程处理。 多个平台(Windows、Linux、macOS)均支持 SSH 和 PowerShell,并且 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)。