다음을 통해 공유

Get-MsolServicePrincipal

  • 참조
모듈:
MSOnline

Azure Active Directory에서 서비스 주체를 가져옵니다.

구문

Get-MsolServicePrincipal
   [-SearchString <String>]
   [-MaxResults <Int32>]
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipal
   -ObjectId <Guid>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipal
   -AppPrincipalId <Guid>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipal
   -ServicePrincipalName <String>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipal
   [-SearchString <String>]
   [-All]
   [-TenantId <Guid>]
   [<CommonParameters>]

Description

Get-MsolServicePrincipal cmdlet은 Azure Active Directory에서 서비스 주체 또는 서비스 주체 목록을 가져옵니다.

예제

예제 1: 모든 서비스 주체 표시

PS C:\> Get-MsolServicePrincipal

이 명령은 조직의 테넌트의 모든 기존 서비스 주체를 표시합니다.

예제 2: 이름을 사용하여 서비스 주체 가져오기

PS C:\> Get-MsolServicePrincipal -ServicePrincipalName "MyApp"

이 명령은 MyApp으로 시작하는 서비스 주체 이름이 있는 모든 기존 서비스 주체를 가져옵니다. 이는 서비스 주체 이름에서 슬래시까지의 appClass 부분과 정확히 일치합니다.

예제 3: 서비스 주체 가져오기

PS C:\> Get-MsolServicePrincipal -AppPrincipalId 5e964d2f-e384-4292-ae55-dd24c89cc53b

이 명령은 특정 애플리케이션 보안 주체 ID가 있는 서비스 주체를 가져옵니다.

매개 변수

-All

이 cmdlet이 모든 결과를 반환한다는 것을 나타냅니다. MaxResults 매개 변수와 함께 지정하지 마세요.

형식:SwitchParameter
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-AppPrincipalId

가져올 서비스 주체의 고유 애플리케이션 ID를 지정합니다.

형식:Guid
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-MaxResults

이 cmdlet이 반환하는 최대 결과 수를 지정합니다. 기본값은 500입니다.

형식:Int32
Position:Named
Default value:500
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ObjectId

가져올 서비스 주체의 고유 개체 ID를 지정합니다.

형식:Guid
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-SearchString

서비스 주체 이름과 일치하는 문자열을 지정합니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-ServicePrincipalName

가져올 서비스 주체 또는 서비스 주체의 이름을 지정합니다. SPN은 다음 형식 중 하나를 사용해야 합니다.

  • appName
  • appName/hostname
  • 유효한 URL

AppName은 애플리케이션의 이름을 나타내고 호스트 이름은 애플리케이션에 대한 URI 기관을 나타냅니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-TenantId

작업을 수행할 테넌트 고유 ID를 지정합니다. 기본값은 현재 사용자의 테넌트입니다. 이 매개 변수는 파트너 사용자에게만 적용됩니다.

형식:Guid
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

출력

Microsoft.Online.Administration.ServicePrincipal[]

이 cmdlet은 Azure Active Directory에서 서비스 주체 또는 서비스 주체 목록을 반환합니다. 각 서비스 사용자에는 다음 정보가 포함됩니다.

  • Objectid. 서비스 주체의 고유 식별자입니다.
  • AppPrincipalId. 서비스 주체의 애플리케이션 식별자입니다.
  • DisplayName. 서비스 주체의 이름입니다.
  • ServicePrincipalName. 서비스 주체와 연결된 SPN(서비스 사용자 이름) 목록입니다.
  • AccountEnabled. 계정을 사용할 수 있는지 여부를 나타내는 값입니다.