Get-EntraUserAdministrativeUnit
사용자가 속한 관리 단위 목록을 검색합니다.
구문
GetQuery (기본값)
Get-EntraUserAdministrativeUnit
-UserId <String>
[-All]
[-Top <Int32>]
[-Property <String[]>]
[-Filter <String>]
[<CommonParameters>]
GetById
Get-EntraUserAdministrativeUnit
-UserId <String>
-AdministrativeUnitId <String>
[-Property <String[]>]
[<CommonParameters>]
Description
cmdlet은 Get-EntraUserAdministrativeUnit 사용자가 속한 관리 단위 목록을 검색합니다.
예제
예제 1: 특정 사용자가 속한 관리 단위 목록 가져오기
Connect-Entra -Scopes 'AdministrativeUnit.Read.All'
Get-EntraUserAdministrativeUnit -UserId 'SawyerM@contoso.com'
DeletedDateTime Id Description DisplayName Visibility
--------------- -- ----------- ----------- ----------
dddddddd-3333-4444-5555-eeeeeeeeeeee Pacific Administrative Unit Pacific Admin Unit
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Engineering Administrative Unit Engineering Admin Unit
이 cmdlet은 특정 사용자가 속한 관리 단위 목록을 검색합니다.
예제 2: All 매개 변수를 사용하여 특정 사용자가 속한 관리 단위 목록 가져오기
Connect-Entra -Scopes 'AdministrativeUnit.Read.All'
Get-EntraUserAdministrativeUnit -UserId 'SawyerM@contoso.com' -All
DeletedDateTime Id Description DisplayName Visibility
--------------- -- ----------- ----------- ----------
dddddddd-3333-4444-5555-eeeeeeeeeeee Pacific Administrative Unit Pacific Admin Unit
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Engineering Administrative Unit Engineering Admin Unit
이 cmdlet은 All 매개 변수를 사용하여 특정 사용자가 속한 관리 단위 목록을 검색합니다.
예제 3: 특정 사용자가 속한 관리 단위 가져오기
Connect-Entra -Scopes 'AdministrativeUnit.Read.All'
Get-EntraUserAdministrativeUnit -UserId 'SawyerM@contoso.com' -Top 1
DeletedDateTime Id Description DisplayName Visibility
--------------- -- ----------- ----------- ----------
dddddddd-3333-4444-5555-eeeeeeeeeeee Pacific Administrative Unit Pacific Admin Unit
이 cmdlet은 특정 사용자가 속한 관리 단위를 검색합니다.
-Limit
-Top별칭으로 사용할 수 있습니다.
예제 4: 관리 단위 ID 매개 변수를 사용하여 특정 사용자가 속한 관리 단위 목록 가져오기
Connect-Entra -Scopes 'AdministrativeUnit.Read.All'
$administrativeUnit = Get-EntraAdministrativeUnit -Filter "DisplayName eq 'Pacific Admin Unit'"
Get-EntraUserAdministrativeUnit -UserId 'SawyerM@contoso.com' -AdministrativeUnitId $administrativeUnit.Id
DeletedDateTime Id Description DisplayName Visibility
--------------- -- ----------- ----------- ----------
dddddddd-3333-4444-5555-eeeeeeeeeeee Pacific Administrative Unit Pacific Admin Unit
이 cmdlet은 관리 단위 ID 매개 변수를 사용하여 특정 사용자가 속한 관리 단위 목록을 검색합니다.
-
-AdministrativeUnitId매개 변수는 관리 단위 ID를 지정합니다.
예제 5: 특정 사용자가 속한 관리 단위 가져오기
Connect-Entra -Scopes 'AdministrativeUnit.Read.All'
Get-EntraUserAdministrativeUnit -UserId 'SawyerM@contoso.com' -Filter "Id eq 'dddddddd-3333-4444-5555-eeeeeeeeeeee'"
DeletedDateTime Id Description DisplayName Visibility
--------------- -- ----------- ----------- ----------
dddddddd-3333-4444-5555-eeeeeeeeeeee Pacific Administrative Unit Pacific Admin Unit
이 cmdlet은 특정 사용자가 속한 관리 단위를 검색합니다.
매개 변수
-AdministrativeUnitId
관리 단위의 고유 ID입니다.
매개 변수 속성
| 형식: | System.String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | DirectoryObjectId |
매개 변수 집합
GetQuery
| Position: | Named |
| 필수: | True |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-All
모든 페이지를 나열합니다.
매개 변수 속성
| 형식: | System.Management.Automation.SwitchParameter |
| Default value: | False |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Filter
OData v4.0 필터 문을 지정합니다. 이 매개 변수는 반환되는 개체를 제어합니다.
매개 변수 속성
| 형식: | System.String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
GetQuery
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-Property
반환할 속성을 지정합니다.
매개 변수 속성
| 형식: | System.String[] |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | 선택 |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Top
사용자가 속한 최대 관리 단위 수입니다.
매개 변수 속성
| 형식: | System.Int32 |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | Limit |
매개 변수 집합
GetQuery
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-UserId
Microsoft Entra ID 사용자의 ID(UserPrincipalName 또는 ObjectId)를 지정합니다.
매개 변수 속성
| 형식: | System.String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | ObjectId (오브젝트아이디), UPN, 아이덴티티, 사용자 주 이름 |
매개 변수 집합
GetQuery
| Position: | Named |
| 필수: | True |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
CommonParameters
이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.