Get-AzureADUser
사용자를 가져옵니다.
구문
GetQuery (기본값)
Get-AzureADUser
[-All <Boolean>]
[-Top <Int32>]
[-Filter <String>]
[<CommonParameters>]
GetVague
Get-AzureADUser
[-SearchString <String>]
[-All <Boolean>]
[<CommonParameters>]
GetById
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로 시작하는 모든 사용자(예: Sales Manager 및 Sales Assistant)를 가져옵니다.
매개 변수
-All
true이면 모든 사용자를 반환합니다. false인 경우 Top 매개 변수로 지정된 개체 수를 반환합니다
매개 변수 속성
| 형식: | Boolean |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | 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 |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
GetQuery
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-ObjectId
Microsoft Entra ID에서 사용자의 ID(UPN 또는 ObjectId)를 지정합니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
GetById
| Position: | Named |
| 필수: | True |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-SearchString
검색 문자열을 지정합니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
GetVague
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-Top
반환할 최대 레코드 수를 지정합니다.
매개 변수 속성
| 형식: | Int32 |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
GetQuery
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
CommonParameters
이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.
참고
Get-AzureADUser에 대한 마이그레이션 가이드를 Microsoft Graph PowerShell로 참조하세요.