다음을 통해 공유

Get-ConnectionInformation

모듈:
Exchange PowerShell

이 cmdlet은 Exchange Online PowerShell 모듈 버전 3.0.0 이상에서만 사용할 수 있습니다. 자세한 내용은 Exchange Online PowerShell 모듈 정보를 참조하세요.

Get-ConnectionInformation cmdlet을 사용하여 현재 PowerShell instance 있는 모든 REST 기반 연결에 대한 정보를 Exchange Online.

아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.

구문

Default (기본값) 

Get-ConnectionInformation
    [<CommonParameters>]

ConnectionId 

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

ModulePrefix 

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

Description

Get-ConnectionInformation cmdlet은 현재 PowerShell instance 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 매개 변수를 사용하여 지정된 값입니다.
  • 조직: CBA 또는 관리 ID 연결에 대한 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: 예를 들어 활성입니다.
  • ConnectionUsedForInbuiltCmdlets
  • IsEopSession: Exchange Online PowerShell 연결의 경우 값은 False입니다. 보안 & 준수 PowerShell 연결의 경우 값은 True입니다.

예제

예 1

Get-ConnectionInformation

다음은 현재 PowerShell instance 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[]

Default value:None
와일드카드 지원:False
DontShow: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[]

Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

ModulePrefix
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.