Get-ConnectionInformation
此 Cmdlet 僅適用於 Exchange Online PowerShell 模組版本 3.0.0 或更新版本。 如需詳細資訊，請參閱關於 Exchange Online PowerShell 模組。
使用 Get-ConnectionInformation Cmdlet 取得目前 PowerShell 執行個體中具有 Exchange Online 的所有 REST 型連線的相關資訊。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
語法
Default (預設值)
Get-ConnectionInformation
[<CommonParameters>]
ConnectionId
Get-ConnectionInformation
-ConnectionId <String[]>
[<CommonParameters>]
ModulePrefix
Get-ConnectionInformation
-ModulePrefix <String[]>
[<CommonParameters>]
Description
Get-ConnectionInformation Cmdlet 會傳回目前 PowerShell 執行個體中與Exchange Online的所有作用中 REST 連線的相關資訊。 此 Cmdlet 相當於用於遠端 PowerShell 工作階段的 Get-PSSession Cmdlet。
Cmdlet 的輸出包含下列屬性：
- ConnectionId：連線的唯一 GUID 值。 例如，8b632b3a-a2e2-8ff3-adcd-6d119d07694b。
- 狀態：例如，已連線。
- 識別碼：在 PowerShell 視窗中識別工作階段的整數。 第一個連線是 1，第二個連線是 2，依此類推。
- 名稱：根據 PowerShell 環境和識別碼值的唯一名稱。 例如，ExchangeOnline_1 for Exchange Online PowerShell 或 ExchangeOnlineProtection_1 for Security & Compliance PowerShell。
- 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：連線權杖到期時。 例如，9/30/2023 6：42：24 PM +00：00。
- CertificateAuthentication：是否使用憑證型驗證 (也稱為 CBA 或僅限應用程式驗證) 進行連線。 值為 True 或 False。
- ModuleName：工作階段暫存資料的檔名和路徑。 例如，C：\Users\laura\AppData\Local\Temp\tmpEXO_a54z135k.qgv
- ModulePrefix：在 Connect-ExchangeOnline 或 Connect-IPPSSession 命令中使用 Prefix 參數指定的值。
- 組織：在 CBA 或受控識別連線的 Connect-ExchangeOnline 或 Connect-IPPSSession 命令中使用組織參數指定的值。
- DelegatedOrganization：在 Connect-ExchangeOnline 或 Connect-IPPSSession 命令中使用 DelegatedOrganization 參數指定的值。
- AppId：在 CBA 連線的 Connect-ExchangeOnline 或 Connect-IPPSSession 命令中使用 AppId 參數指定的值。
- PageSize：連線中每頁的預設最大項目數。 預設值為 1000，或者您也可以使用 Connect-ExchangeOnline 命令中的 PageSize 參數來指定較低的數字。 個別 Cmdlet 可能也會有 PageSize 參數。
- TenantID：租用戶識別碼 GUID 值。 例如，3750b40b-a68b-4632-9fb3-5b1aff664079。
- TokenStatus：例如，使用中。
- 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-Preview2 或更新版本中使用。
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-Preview2 或更新版本中使用。
ModulePrefix 參數會依 ModulePrefix 篩選連線。 當您搭配 Connect-ExchangeOnline Cmdlet 使用 Prefix 參數時，指定的文字會新增至所有 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。