Get-PSSession

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

Get-PSSession
    [-ComputerName] <String[]>
    [-ApplicationName <String>]
    [-ConfigurationName <String>]
    [-Name <String[]>]
    [-Credential <PSCredential>]
    [-Authentication <AuthenticationMechanism>]
    [-CertificateThumbprint <String>]
    [-Port <Int32>]
    [-UseSSL]
    [-ThrottleLimit <Int32>]
    [-State <SessionFilterState>]
    [-SessionOption <PSSessionOption>]
    [<CommonParameters>]

Get-PSSession
    [-ComputerName] <String[]>
    -InstanceId <Guid[]>
    [-ApplicationName <String>]
    [-ConfigurationName <String>]
    [-Credential <PSCredential>]
    [-Authentication <AuthenticationMechanism>]
    [-CertificateThumbprint <String>]
    [-Port <Int32>]
    [-UseSSL]
    [-ThrottleLimit <Int32>]
    [-State <SessionFilterState>]
    [-SessionOption <PSSessionOption>]
    [<CommonParameters>]

Get-PSSession
    [-ConnectionUri] <Uri[]>
    [-ConfigurationName <String>]
    [-AllowRedirection]
    [-Name <String[]>]
    [-Credential <PSCredential>]
    [-Authentication <AuthenticationMechanism>]
    [-CertificateThumbprint <String>]
    [-ThrottleLimit <Int32>]
    [-State <SessionFilterState>]
    [-SessionOption <PSSessionOption>]
    [<CommonParameters>]

Get-PSSession
    [-ConnectionUri] <Uri[]>
    -InstanceId <Guid[]>
    [-ConfigurationName <String>]
    [-AllowRedirection]
    [-Credential <PSCredential>]
    [-Authentication <AuthenticationMechanism>]
    [-CertificateThumbprint <String>]
    [-ThrottleLimit <Int32>]
    [-State <SessionFilterState>]
    [-SessionOption <PSSessionOption>]
    [<CommonParameters>]

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

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

Get-PSSession cmdlet 在本地和远程计算机上获取用户管理的 PowerShell 会话（PSSessions）。

从 Windows PowerShell 3.0 开始，会话存储在每个连接的远程端的计算机上。 可以使用 ComputerName 或 ConnectionUriGet-PSSession 的参数来获取连接到本地计算机或远程计算机的会话，即使这些会话未在当前会话中创建。

如果没有参数，Get-PSSession 获取在当前会话中创建的所有会话。

使用筛选参数（包括 名称、ID、InstanceID、State、ApplicationName，以及 ConfigurationName 从 Get-PSSession 返回的会话中进行选择。

使用其余参数配置使用 ComputerName 或 ConnectionUri 参数时运行 Get-PSSession 命令的临时连接。

注意：在 Windows PowerShell 2.0 中，Get-PSSession 获取在当前会话中创建的所有会话。 ComputerName 参数获取在当前会话中创建并连接到指定计算机的会话。

有关 PowerShell 会话的详细信息，请参阅 about_PSSessions。

Get-PSSession

此命令获取在当前会话中创建的所有 PSSessions。 它不会 在其他会话或其他计算机上创建的 PSSessions，即使它们连接到此计算机也是如此。

Get-PSSession -ComputerName "localhost"

此命令获取连接到本地计算机的 PSSessions。 若要指示本地计算机，请键入计算机名称、localhost 或点（.）

该命令将返回本地计算机上的所有会话，即使这些会话是在不同会话或不同计算机上创建的。

Get-PSSession -ComputerName "Server02"

 Id Name            ComputerName    State         ConfigurationName     Availability
 -- ----            ------------    -----         -----------------     ------------
  2 Session3        Server02       Disconnected  ITTasks                       Busy
  1 ScheduledJobs   Server02       Opened        Microsoft.PowerShell     Available
  3 Test            Server02       Disconnected  Microsoft.PowerShell          Busy

此命令获取连接到 Server02 计算机的 PSSessions。

该命令返回 Server02 上的所有会话，即使这些会话是在不同会话或不同计算机上创建的。

输出显示两个会话的状态为“已断开连接”和“忙碌”可用性。 它们在不同的会话中创建，当前正在使用中。 已打开和可用的 ScheduledJobs 会话是在当前会话中创建的。

New-PSSession -ComputerName Server01, Server02, Server03
$s1, $s2, $s3 = Get-PSSession

此示例演示如何将 Get-PSSession 命令的结果保存在多个变量中。

第一个命令使用 New-PSSession cmdlet 在三台远程计算机上创建 PSSessions。

第二个命令使用 Get-PSSession cmdlet 来获取三 PSSessions。 然后，它将每个 PSSessions 保存在单独的变量中。

当 PowerShell 向变量数组分配对象数组时，它将第一个对象分配给第一个变量、第二个对象分配给第二个变量，依此类说。 如果对象多于变量，则会将所有剩余对象分配给数组中的最后一个变量。 如果变量多于对象，则不会使用额外的变量。

Get-PSSession | Format-Table -Property ComputerName, InstanceID
$s = Get-PSSession -InstanceID a786be29-a6bb-40da-80fb-782c67f7db0f
Remove-PSSession -Session $s

此示例演示如何使用其实例 ID 获取 PSSession，然后删除 PSSession。

第一个命令获取在当前会话中创建的所有 PSSessions。 它将 PSSessions 发送到 Format-Table cmdlet，该 cmdlet 显示每个 PSSession的 ComputerName 和 InstanceID 属性。

第二个命令使用 Get-PSSession cmdlet 获取特定的 PSSession，并将其保存在$s变量中。 该命令使用 InstanceID 参数来标识 PSSession。

第三个命令使用 Remove-PSSession cmdlet 删除$s变量中的 PSSession。

此示例中的命令查找具有特定名称格式的会话，并使用特定的会话配置，然后连接到会话。 可以使用这样的命令来查找同事在其中启动任务并连接到完成任务的会话。

Get-PSSession -ComputerName Server02, Server12 -Name BackupJob* -ConfigurationName ITTasks -SessionOption @{OperationTimeout=240000}

 Id Name            ComputerName    State         ConfigurationName     Availability
 -- ----            ------------    -----         -----------------     ------------
  3 BackupJob04     Server02        Disconnected        ITTasks                  None

$s = Get-PSSession -ComputerName Server02 -Name BackupJob04 -ConfigurationName ITTasks | Connect-PSSession
$s

Id Name            ComputerName    State         ConfigurationName     Availability
-- ----            ------------    -----         -----------------     ------------
 5 BackupJob04     Server02        Opened        ITTasks                  Available

第一个命令获取 Server02 和 Server12 远程计算机上的会话，这些计算机的名称以 BackupJob 开头，并使用 ITTasks 会话配置。该命令使用 Name 参数指定名称模式和 ConfigurationName 参数来指定会话配置。 SessionOption 参数的值是一个哈希表，用于将 OperationTimeout 的值设置为 240000 毫秒（4 分钟）。 此设置为命令提供了更多完成时间。ConfigurationName 和 SessionOption 参数用于配置在每台计算机上运行 Get-PSSession cmdlet 的临时会话。输出显示命令返回 BackupJob04 会话。 会话已断开连接，可用性 为 None，指示它未使用。

第二个命令使用 Get-PSSession cmdlet 访问 BackupJob04 会话，并使用 Connect-PSSession cmdlet 连接到会话。 该命令将会话保存在$s变量中。

第三个命令获取$s变量中的会话。 输出显示 Connect-PSSession 命令成功。 会话处于 打开 状态，可供使用。

Get-PSSession -Id 2

此命令获取 ID 为 2 的 PSSession。 由于 ID 属性的值仅在当前会话中是唯一的，因此 ID 参数仅对本地命令有效。

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

不能通过管道将输入传递给此 cmdlet。

• 此 cmdlet 获取用户管理的会话 PSSession 对象“，例如使用 New-PSSession 创建的会话、Enter-PSSession和 Invoke-Command cmdlet。 它不会获取启动 PowerShell 时创建的系统托管会话。
• 从 Windows PowerShell 3.0 开始，PSSession 对象存储在位于服务器端或接收连接的末尾的计算机上。 若要获取存储在本地计算机或远程计算机上的会话，PowerShell 会建立到指定计算机的临时会话，并在会话中运行查询命令。
• 若要获取连接到远程计算机的会话，请使用 ComputerName 或 ConnectionUri 参数来指定远程计算机。 若要筛选 Get-PSSession 获取的会话，请使用 名称、ID、InstanceID和 State 参数。 使用其余参数配置 Get-PSSession 使用的临时会话。
• 使用 ComputerName 或 ConnectionUri 参数时，Get-PSSession 仅从运行 Windows PowerShell 3.0 及更高版本的 PowerShell 的计算机获取会话。
• PSSession 的 State 属性的值相对于当前会话。 因此，断开连接 值表示 PSSession 未连接到当前会话。 但是，这并不意味着 PSSession 已与所有会话断开连接。 它可能连接到另一个会话。 若要确定是否可以从当前会话连接到 PSSession，请使用 Availability 属性。

可用性 值 None 指示可以连接到会话。 忙碌 的值指示无法连接到 PSSession，因为它已连接到另一个会话。

有关会话的 State 属性的值的详细信息，请参阅 RunspaceState 枚举。

有关会话 可用性 属性的值的详细信息，请参阅 RunspaceAvailability 枚举。