다음을 통해 공유


Get-AzADUser

사용자의 엔터티를 나열하거나 키별로 사용자로부터 엔터티 가져오기

구문

Get-AzADUser
   [-Count]
   [-Expand <String[]>]
   [-Select <String[]>]
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-Filter <String>]
   [-Orderby <String[]>]
   [-Search <String>]
   [-ConsistencyLevel <String>]
   [-DefaultProfile <PSObject>]
   [-CountVariable <String>]
   [<CommonParameters>]
Get-AzADUser
   [-Expand <String[]>]
   [-Select <String[]>]
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   -Mail <String>
   [<CommonParameters>]
Get-AzADUser
   [-Expand <String[]>]
   [-Select <String[]>]
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   -DisplayName <String>
   [<CommonParameters>]
Get-AzADUser
   [-Expand <String[]>]
   [-Select <String[]>]
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   -StartsWith <String>
   [<CommonParameters>]
Get-AzADUser
   [-Expand <String[]>]
   [-Select <String[]>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   -ObjectId <String>
   [<CommonParameters>]
Get-AzADUser
   [-Expand <String[]>]
   [-Select <String[]>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   -UserPrincipalName <String>
   [<CommonParameters>]
Get-AzADUser
   [-Expand <String[]>]
   [-Select <String[]>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   [-SignedIn]
   [<CommonParameters>]

Description

사용자의 엔터티를 나열하거나 키별로 사용자로부터 엔터티 가져오기

예제

예제 1: 로그인 사용자 가져오기

Get-AzADUser -SignedIn

로그인 사용자 가져오기

예제 2: 사용자 나열

Get-AzADUser -First 10 -Select 'City' -AppendSelected

'DisplayName', 'Id', 'DeletedDateTime', 'UserPrincipalName', 'UsageLocation', 'GivenName', 'SurName', 'AccountEnabled', 'MailNickName', 'Mail' 등의 기본 속성 후 처음 10명의 사용자를 나열하고 속성 'City'를 추가합니다.

예제 3: 표시 이름으로 사용자 가져오기

Get-AzADUser -DisplayName $name

표시 이름으로 사용자 가져오기

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

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

필터를 사용하여 사용자 가져오기

예제 5: 변수에 OdataCount 할당

Get-AzADUser -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

-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

-Mail

사용자 메일 주소

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

-ObjectId

key: 사용자 ID

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

-Orderby

속성 값별로 항목 정렬

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

검색 구별 항목 검색

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

-Select

반환할 속성 선택

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

-SignedIn

사용자 메일 주소

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

-Skip

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

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

-StartsWith

사용자 표시 이름이 로 시작됩니다.

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

-UserPrincipalName

사용자 계정 이름

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

출력

IMicrosoftGraphUser

참고

별칭