Get-AzADServicePrincipal

참조

모듈:: Az.Resources

서비스 주체의 엔터티를 나열하거나 키별로 서비스 주체에서 엔터티를 가져옵니다.

구문

Get-AzADServicePrincipal
   [-Select <String[]>]
   [-Count]
   [-Filter <String>]
   [-Orderby <String[]>]
   [-Search <String>]
   [-ConsistencyLevel <String>]
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   [-CountVariable <String>]
   [<CommonParameters>]

Get-AzADServicePrincipal
   -ObjectId <String>
   [-Select <String[]>]
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzADServicePrincipal
   [-Select <String[]>]
   -DisplayNameBeginsWith <String>
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzADServicePrincipal
   [-Select <String[]>]
   -DisplayName <String>
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzADServicePrincipal
   [-Select <String[]>]
   -ApplicationId <Guid>
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzADServicePrincipal
   [-Select <String[]>]
   -ApplicationObject <IMicrosoftGraphApplication>
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzADServicePrincipal
   [-Select <String[]>]
   -ServicePrincipalName <String>
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Description

서비스 주체의 엔터티를 나열하거나 키별로 서비스 주체에서 엔터티를 가져옵니다.

예제

예제 1: 표시 이름으로 서비스 주체 가져오기

Get-AzADServicePrincipal -DisplayName $name

표시 이름으로 서비스 주체 가져오기

예제 2: 서비스 주체 표시 이름 검색 시작

Get-AzADServicePrincipal -DisplayNameStartsWith $prefix

서비스 주체 표시 이름 검색이 로 시작됩니다.

예제 3: 서비스 주체 나열

Get-AzADServicePrincipal -First 10 -Select Tags -AppendSelected

처음 10개의 서비스 주체를 나열하고 기본 속성인 'DisplayName', 'Id', 'DeletedDateTime', 'ServicePrincipalNames', 'AppId' 다음 속성 'Tags'를 추가합니다.

예제 4: 애플리케이션 ID별 서비스 주체 가져오기

Get-AzADServicePrincipal -ApplicationId $appId

애플리케이션 ID별 서비스 주체 가져오기

예제 5: 파이프라인 입력으로 서비스 주체 가져오기

Get-AzADApplication -DisplayName $name | Get-AzADServicePrincipal

파이프라인 입력으로 서비스 주체 가져오기

예제 6: 필터를 사용하여 서비스 주체 가져오기

Get-AzADServicePrincipal -Filter "startsWith(DisplayName,'some-name')"

필터를 사용하여 서비스 주체 가져오기

예제 7: 변수에 OdataCount 할당

Get-AzADServicePrincipal -First 10 -ConsistencyLevel eventual -Count -CountVariable 'result'
$result

변수에 OdataCount 할당

매개 변수

-AppendSelected

이 스위치가 켜져 있을 때 기본 속성으로 선택한 속성을 추가하면 '-Select' 매개 변수에서만 작동합니다.

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

-ApplicationId

serviceprincipal의 애플리케이션 ID

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

-ApplicationObject

서비스 주체 개체를 파이프라인 입력으로 사용할 수 있습니다.

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

-ConsistencyLevel

요청된 일관성 수준을 나타냅니다. 설명서 URL: https://developer.microsoft.com/en-us/office/blogs/microsoft-graph-advanced-queries-for-directory-objects-are-now-generally-available/

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

-Count

항목 수 포함

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

-CountVariable

컬렉션의 총 항목 수를 지정합니다. 기본적으로 이 변수는 전역 범위에서 설정됩니다.

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

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.

형식:	PSObject
별칭:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DisplayName

serviceprincipal 표시 이름

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

-DisplayNameBeginsWith

serviceprincipal 표시 이름이 로 시작됩니다.

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

-Filter

속성 값별로 항목을 필터링합니다. 필터 쿼리에 대한 자세한 내용은 다음을 참조하세요. https://learn.microsoft.com/en-us/graph/filter-query-parameter

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

-First

첫 번째 'n' 개체만 가져옵니다.

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

-ObjectId

key: servicePrincipal의 ID

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

-Orderby

속성 값별로 항목 정렬

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

-Search

검색 구별 항목 검색

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

-Select

반환할 속성 선택

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

-ServicePrincipalName

serviceprincipal 이름

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

-Skip

첫 번째 'n' 개체를 무시하고 나머지 개체를 가져옵니다.

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

입력

IMicrosoftGraphApplication

출력

IMicrosoftGraphServicePrincipal

다음을 통해 공유