Get-ConnectionInformation

Модуль:
Exchange PowerShell

Этот командлет доступен только в модуле PowerShell Exchange Online версии 3.0.0 или более поздней. Дополнительные сведения см. в статье О модуле PowerShell Exchange Online.

Используйте командлет Get-ConnectionInformation, чтобы получить сведения обо всех подключениях на основе REST в текущем экземпляре PowerShell с Exchange Online.

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

Default (По умолчанию) 

Get-ConnectionInformation
    [<CommonParameters>]

ConnectionId 

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

ModulePrefix 

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

Описание

Командлет Get-ConnectionInformation возвращает сведения обо всех активных подключениях на основе REST с Exchange Online в текущем экземпляре PowerShell. Этот командлет аналогичен командлету Get-PSSession, который используется в удаленных сеансах PowerShell.

Выходные данные командлета содержат следующие свойства:

  • ConnectionId: уникальное значение GUID для подключения. Например, 8b632b3a-a2e2-8ff3-adcd-6d119d07694b.
  • Состояние: например "Подключено".
  • Идентификатор: целое число, определяющее сеанс в окне PowerShell. Первое соединение - 1, второе - 2 и т.д.
  • Имя: уникальное имя, основанное на среде PowerShell и значении Id. Например, ExchangeOnline_1 для Exchange Online PowerShell или ExchangeOnlineProtection_1 для обеспечения безопасности & соответствия требованиям PowerShell.
  • UserPrincipalName: учетная запись, которая использовалась для подключения. Например, laura@contoso.onmicrosoft.com.
  • ConnectionUri: используемая конечная точка подключения. Например, https://outlook.office365.com для Exchange Online PowerShell или https://nam12b.ps.compliance.protection.outlook.com для Security & Compliance PowerShell.
  • AzureAdAuthorizationEndpointUri : конечная точка авторизации Microsoft Entra для подключения. Например, https://login.microsoftonline.com/organizations для Exchange Online PowerShell или https://login.microsoftonline.com/organizations для Security & Compliance PowerShell.
  • TokenExpiryTimeUTC: время истечения срока действия маркера подключения. Например, 30.09.2023 18:42:24 +00:00.
  • CertificateAuthentication: использовалась ли для подключения проверка подлинности на основе сертификатов (также известная как CBA или проверка подлинности только приложения). Доступны значения True и False.
  • ModuleName: имя файла и путь к временным данным для сеанса. Например, C:\Users\laura\AppData\Local\Temp\tmpEXO_a54z135k.qgv
  • ModulePrefix: значение, указанное с помощью параметра Prefix в команде Connect-ExchangeOnline или Connect-IPPSSession.
  • Organization. Значение, указанное с помощью параметра Organization в команде Connect-ExchangeOnline или Connect-IPPSSession для подключений CBA или управляемых удостоверений.
  • DelegatedOrganization. Значение, указанное с помощью параметра DelegatedOrganization в команде Connect-ExchangeOnline или Connect-IPPSSession.
  • AppId: значение, указанное с помощью параметра AppId в команде Connect-ExchangeOnline или Connect-IPPSSession для подключений CBA.
  • PageSize: максимальное количество записей на страницу в соединении по умолчанию. Значение по умолчанию — 1000, либо вы можете использовать параметр PageSize в команде Connect-ExchangeOnline, чтобы указать меньшее число. Отдельные командлеты также могут иметь параметр PageSize.
  • TenantID: значение GUID идентификатора клиента. Например, 3750b40b-a68b-4632-9fb3-5b1aff664079.
  • TokenStatus: например, Active.
  • ConnectionUsedForInbuiltCmdlets
  • IsEopSession: для подключений Exchange Online PowerShell значение равно False. Для подключений PowerShell с & безопасностью это значение равно True.

Примеры

Пример 1

Get-ConnectionInformation

В этом примере возвращается список всех активных подключений на основе REST к Exchange Online в текущем экземпляре PowerShell.

Пример 2

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

В этом примере возвращается активное подключение на основе REST с указанным значением ConnectionId.

Пример 3

Get-ConnectionInformation -ModulePrefix Contoso,Fabrikam

В этом примере возвращается список активных подключений на основе REST, использующих указанные значения префиксов.

Параметры

-ConnectionId

Применимо: Exchange Online

Примечание: Этот параметр доступен в модуле версии 3.2.0-Preview2 или более поздней.

Параметр ConnectionId фильтрует подключения по ConnectionId. ConnectionId — это значение GUID в выходных данных командлета Get-ConnectionInformation, которое однозначно идентифицирует подключение, даже если открыто несколько соединений. Вы можете указать несколько значений ConnectionId, разделенных запятыми.

Не используйте этот параметр с параметром ModulePrefix.

Свойства параметров

Тип:

String[]

Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

ConnectionId
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ModulePrefix

Применимо: Exchange Online

Примечание: Этот параметр доступен в модуле версии 3.2.0-Preview2 или более поздней.

Параметр ModulePrefix фильтрует подключения по ModulePrefix. При использовании параметра Prefix с командлетом Connect-ExchangeOnline указанный текст добавляется к именам всех командлетов Exchange Online (например, Get-InboundConnector преобразуется в Get-ContosoInboundConnector). Значение ModulePrefix отображается в выводе командлета Get-ConnectionInformation. Вы можете указать несколько значений ModulePrefix, разделенных запятыми.

Этот параметр имеет смысл только для соединений, созданных с помощью параметра Prefix.

Не используйте этот параметр с параметром ConnectionId.

Свойства параметров

Тип:

String[]

Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

ModulePrefix
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.