Get-AzADGroup

모듈:

Az.Resources

그룹의 엔터티를 나열하거나 키별로 그룹에서 엔터티 가져오기

구문

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

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

Get-AzADGroup
   [-Expand <String[]>]
   [-Select <String[]>]
   [-ConsistencyLevel <String>]
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   -DisplayNameStartsWith <String>
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzADGroup
   [-Expand <String[]>]
   [-Select <String[]>]
   [-ConsistencyLevel <String>]
   [-AppendSelected]
   -ObjectId <Guid>
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Description

그룹의 엔터티를 나열하거나 키별로 그룹에서 엔터티 가져오기

예제

예제 1: 표시 이름별 그룹 가져오기

Get-AzADGroup -DisplayName $gname

표시 이름별 그룹 가져오기

예제 2: 그룹 나열

Get-AzADGroup -First 10

처음 10개 그룹 나열

예제 3: 개체 ID별 그룹 가져오기

Get-AzADGroup -ObjectId $id -Select groupTypes -AppendSelected

개체 ID별로 그룹을 가져오고 기본 속성인 'DisplayName', 'Id', 'DeletedDateTime', 'SecurityEnabled', 'MailEnabled', 'MailNickname', 'Description' 다음 속성 'groupTypes'를 추가합니다.

예제 4: 필터를 사용하여 그룹 가져오기

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

필터를 사용하여 그룹 가져오기

예제 5: 변수에 OdataCount 할당

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

변수에 OdataCount 할당

매개 변수

-AppendSelected

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

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	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

그룹의 표시 이름입니다.

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

-DisplayNameStartsWith

제공된 문자열로 시작하는 그룹을 찾는 데 사용됩니다.

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

-Expand

관련 엔터티 확장

형식:	String[]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	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: 그룹의 ID

형식:	Guid
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

-Skip

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

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

출력

IMicrosoftGraphGroup

참고

별칭