通过

Get-ConnectionInformation

模块:
Exchange PowerShell

此 cmdlet 在 Exchange Online PowerShell 模块 v3.0.0 或更高版本中可用。 有关详细信息，请参阅关于 Exchange Online PowerShell 模块。

使用 Get-ConnectionInformation cmdlet 获取有关当前 PowerShell 实例中所有基于 REST 的连接的信息，Exchange Online。

有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。

语法

Default （默认值） 

Get-ConnectionInformation
    [<CommonParameters>]

ConnectionId 

Get-ConnectionInformation
    -ConnectionId <String[]>
    [<CommonParameters>]

ModulePrefix 

Get-ConnectionInformation
    -ModulePrefix <String[]>
    [<CommonParameters>]

说明

Get-ConnectionInformation cmdlet 返回有关当前 PowerShell 实例中Exchange Online的所有基于 REST 的活动连接的信息。 此 cmdlet 等效于用于远程 PowerShell 会话的 Get-PSSession cmdlet。

cmdlet 的输出包含以下属性：

  • ConnectionId：连接的唯一 GUID 值。 例如，8b632b3a-a2e2-8ff3-adcd-6d119d07694b。
  • 状态：例如“已连接”。
  • Id：标识 PowerShell 窗口中的会话的整数。 第一个连接为 1，第二个连接为 2，以此类推。
  • 名称：基于 PowerShell 环境和 ID 值的唯一名称。 例如，Exchange Online PowerShell 的ExchangeOnline_1或安全 & 符合性 PowerShell 的ExchangeOnlineProtection_1。
  • UserPrincipalName：用于连接的帐户。 例如，laura@contoso.onmicrosoft.com。
  • ConnectionUri：使用的连接终结点。 例如，https://outlook.office365.com对于 Exchange Online PowerShell 或https://nam12b.ps.compliance.protection.outlook.com安全 & 符合性 PowerShell。
  • AzureAdAuthorizationEndpointUri：连接的Microsoft Entra授权终结点。 例如，https://login.microsoftonline.com/organizations对于 Exchange Online PowerShell 或https://login.microsoftonline.com/organizations安全 & 符合性 PowerShell。
  • TokenExpiryTimeUTC：连接令牌过期时。 例如，2023/9/30 下午 6：42：24 +00：00。
  • CertificateAuthentication：基于证书的身份验证 (也称为 CBA 或仅限应用的身份验证) 用于连接。 值为 True 或 False。
  • ModuleName：会话的临时数据的文件名和路径。 例如，C：\Users\laura\AppData\Local\Temp\tmpEXO_a54z135k.qgv
  • ModulePrefix：使用 Connect-ExchangeOnline 或 Connect-IPPSSession 命令中的 Prefix 参数指定的值。
  • Organization：使用 CBA 或托管标识连接的 Connect-ExchangeOnline 或 Connect-IPPSSession 命令中的 Organization 参数指定的值。
  • DelegatedOrganization：使用 Connect-ExchangeOnline 或 Connect-IPPSSession 命令中的 DelegatedOrganization 参数指定的值。
  • AppId：使用 CBA 连接的 Connect-ExchangeOnline 或 Connect-IPPSSession 命令中的 AppId 参数指定的值。
  • PageSize：连接中每页的默认最大条目数。 默认值为 1000，或者可以使用 Connect-ExchangeOnline 命令中的 PageSize 参数指定较小的数字。 单个 cmdlet 可能还具有 PageSize 参数。
  • TenantID：租户 ID GUID 值。 例如，3750b40b-a68b-4632-9fb3-5b1aff664079。
  • TokenStatus：例如 Active。
  • ConnectionUsedForInbuiltCmdlets
  • IsEopSession：对于Exchange Online PowerShell 连接，值为 False。 对于安全性 & 符合性 PowerShell 连接，值为 True。

示例

示例 1

Get-ConnectionInformation

此示例返回当前 PowerShell 实例中具有Exchange Online的所有活动基于 REST 的连接的列表。

示例 2

Get-ConnectionInformation -ConnectionId 1a9e45e8-e7ec-498f-9ac3-0504e987fa85

此示例返回具有指定 ConnectionId 值的活动基于 REST 的连接。

示例 3

Get-ConnectionInformation -ModulePrefix Contoso,Fabrikam

此示例返回使用指定前缀值的基于 REST 的活动连接的列表。

参数

-ConnectionId

适用：Exchange Online

注意：此参数在模块的 3.2.0 或更高版本中可用。

ConnectionId 参数按 ConnectionId 筛选连接。 ConnectionId 是 Get-ConnectionInformation cmdlet 输出中的 GUID 值，用于唯一标识连接，即使打开了多个连接也是如此。 可以指定以逗号分隔的多个 ConnectionId 值。

不要将此参数与 ModulePrefix 参数一起使用。

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

ConnectionId
Position:Named
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-ModulePrefix

适用：Exchange Online

注意：此参数在模块的 3.2.0 或更高版本中可用。

ModulePrefix 参数按 ModulePrefix 筛选连接。 将 Prefix 参数与 Connect-ExchangeOnline cmdlet 一起使用时，指定的文本将添加到所有Exchange Online cmdlet 的名称 (例如，Get-InboundConnector 变为 Get-ContosoInboundConnector) 。 ModulePrefix 值在 Get-ConnectionInformation cmdlet 的输出中可见。 可以指定多个用逗号分隔的 ModulePrefix 值。

此参数仅对使用 Prefix 参数创建的连接有意义。

不要将此参数与 ConnectionId 参数一起使用。

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

ModulePrefix
Position:Named
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

CommonParameters

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