다음을 통해 공유


Get-ServicePrincipal

이 cmdlet은 클라우드 기반 서비스에서만 사용할 수 있습니다.

Get-ServicePrincipal cmdlet을 사용하여 클라우드 기반 조직의 서비스 주체에 대한 정보를 볼 수 있습니다.

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

Syntax

Get-ServicePrincipal
   [[-Identity] <ServicePrincipalIdParameter>]
   [-Organization <OrganizationIdParameter>]
   [<CommonParameters>]

Description

서비스 주체는 Azure Active Directory에 존재하여 앱이 수행할 수 있는 작업, 앱에 액세스할 수 있는 사용자 및 앱이 액세스할 수 있는 리소스를 정의합니다. Exchange Online 서비스 주체는 Azure AD 서비스 주체에 대한 참조입니다. Azure AD 서비스 주체에 Exchange Online RBAC(역할 기반 액세스 제어) 역할을 할당하려면 Exchange Online 서비스 주체 참조를 사용합니다. Exchange Online PowerShell의 *-ServicePrincipal cmdlet을 사용하면 이러한 서비스 주체 참조를 보고, 만들고, 제거할 수 있습니다.

자세한 내용은 Azure Active Directory의 애플리케이션 및 서비스 주체 개체를 참조하세요.

이 cmdlet을 실행하려면 먼저 사용 권한을 할당받아야 합니다. 이 항목에는 해당 cmdlet의 모든 매개 변수가 나열되지만 사용자에게 할당된 사용 권한에 포함되지 않은 일부 매개 변수에는 액세스할 수 없습니다. 조직에서 cmdlet 또는 매개 변수를 실행하는 데 필요한 사용 권한을 확인하려면 Find the permissions required to run any Exchange cmdlet를 참조하세요.

예제

예 1

Get-ServicePrincipal

이 예제에서는 모든 서비스 주체의 요약 목록을 반환합니다.

예 2

Get-ServicePrincipal -Identity ca73fffa-cedb-4b84-860f-d7fb8aa8a6c1 | Format-List

이 예제에서는 ServiceId 값이 ca73fffa-cedb-4b84-860f-d7fb8aa8a6c1인 서비스 주체에 대한 자세한 정보를 반환합니다.

매개 변수

-Identity

Identity 매개 변수는 보려는 서비스 주체를 지정합니다. 서비스 주체를 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예시:

  • 이름
  • DN(고유 이름)
  • GUID
  • Appid
  • ServiceId
Type:ServicePrincipalIdParameter
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance, Exchange Online Protectionn

-Organization

이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.

Type:OrganizationIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance, Exchange Online Protection