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 и значении идентификатора. Например, 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 для обеспечения соответствия требованиям безопасности & PowerShell.
• AzureAdAuthorizationEndpointUri: конечная точка Microsoft Entra авторизации для подключения. Например, https://login.microsoftonline.com/organizations для Exchange Online PowerShell или https://login.microsoftonline.com/organizations для обеспечения соответствия требованиям безопасности & 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 в команде Connect-ExchangeOnline или Connect-IPPSSession для подключений КБУ или управляемых удостоверений.
• 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: например, активный.
• ConnectionUsedForInbuiltCmdlets
• IsEopSession: для подключений PowerShell Exchange Online значение равно 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[]
Default value:	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[]
Default value:	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.