Get-AzADUser

모듈:

Az.Resources

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

Syntax

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' 매개 변수에서만 작동합니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ConsistencyLevel

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Count

항목 수 포함

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CountVariable

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

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

Type:	PSObject
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisplayName

사용자 표시 이름

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Expand

관련 엔터티 확장

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Filter

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-First

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

Type:	UInt64
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Mail

사용자 메일 주소

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ObjectId

key: 사용자 ID

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Orderby

속성 값별로 항목 정렬

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Search

검색 구별 항목 검색

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Select

반환할 속성 선택

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SignedIn

사용자 메일 주소

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Skip

첫 번째 'n' 개체를 무시한 다음 다시 기본 개체를 가져옵니다.

Type:	UInt64
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-StartsWith

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

Type:	String
Aliases:	SearchString
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-UserPrincipalName

사용자 계정 이름

Type:	String
Aliases:	UPN
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

출력

IMicrosoftGraphUser

참고

별칭