다음을 통해 공유

Get-AzureADUser

  • 참조
모듈:
AzureAD

사용자를 가져옵니다.

구문

Get-AzureADUser
   [-All <Boolean>]
   [-Top <Int32>]
   [-Filter <String>]
   [<CommonParameters>]
Get-AzureADUser
   [-SearchString <String>]
   [-All <Boolean>]
   [<CommonParameters>]
Get-AzureADUser
   -ObjectId <String>
   [-All <Boolean>]
   [<CommonParameters>]

Description

Get-AzureADUser cmdlet은 Microsoft Entra ID에서 사용자를 가져옵니다.

예제

예제 1: 상위 10명의 사용자 가져오기

PS C:\>Get-AzureADUser -Top 10

이 명령은 10명의 사용자를 가져옵니다.

예제 2: ID로 사용자 가져오기

PS C:\>Get-AzureADUser -ObjectId "testUpn@tenant.com"

이 명령은 지정된 사용자를 가져옵니다.

예제 3: 검색된 사용자 간 검색

PS C:\> Get-AzureADUser -SearchString "New"

ObjectId                             DisplayName UserPrincipalName                   UserType
--------                             ----------- -----------------                   --------
5e8b0f4d-2cd4-4e17-9467-b0f6a5c0c4d0 New user    NewUser@contoso.onmicrosoft.com     Member
2b450b8e-1db6-42cb-a545-1b05eb8a358b New user    NewTestUser@contoso.onmicrosoft.com Member

이 cmdlet은 DisplayName 또는 UserPrincipalName의 첫 번째 문자에 대해 SearchString 값과 일치하는 모든 사용자를 가져옵니다.

예제 4: userPrincipalName으로 사용자 가져오기

PS C:\>Get-AzureADUser -Filter "userPrincipalName eq 'jondoe@contoso.com'"

이 명령은 지정된 사용자를 가져옵니다.

예제 5: JobTitle로 사용자 가져오기

PS C:\>Get-AzureADUser -Filter "startswith(JobTitle,'Sales')"

이 명령은 작업 제목이 영업으로 시작하는 모든 사용자(예: Sales Manager 및 Sales Assistant)를 가져옵니다.

매개 변수

-All

true이면 모든 사용자를 반환합니다. false이면 Top 매개 변수에 지정된 개체 수를 반환합니다.

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

-Filter

OData v3.0 필터 문을 지정합니다. 이 매개 변수는 반환되는 개체를 제어합니다. OData를 사용하여 쿼리하는 방법은 여기에서 확인할 수 있습니다. http://www.odata.org/documentation/odata-version-3-0/odata-version-3-0-core-protocol/#queryingcollections. 현재 모든 OData v3.0 함수 및 연산자가 지원되지는 않습니다.

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

-ObjectId

Microsoft Entra ID에서 사용자의 ID(UPN 또는 ObjectId)를 지정합니다.

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

-SearchString

검색 문자열을 지정합니다.

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

-Top

반환할 최대 레코드 수를 지정합니다.

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

참고

Get-AzureADUser에서 Microsoft Graph PowerShell로 마이그레이션 가이드를 참조하세요.