Get-EntraUserAdministrativeUnit

Modul:
Microsoft.Entra.Users Module v1.3

Mengambil daftar unit administratif milik pengguna.

Sintaks

GetQuery (Default) 

Get-EntraUserAdministrativeUnit

    -UserId <String>
    [-All]
    [-Top <Int32>]
    [-Property <String[]>]
    [-Filter <String>]
    [<CommonParameters>]

GetById 

Get-EntraUserAdministrativeUnit

    -UserId <String>
    -AdministrativeUnitId <String>
    [-Property <String[]>]
    [<CommonParameters>]

Deskripsi

Get-EntraUserAdministrativeUnit Cmdlet mengambil daftar unit administratif tempat pengguna berada.

Contoh

Contoh 1: Mendapatkan daftar unit administratif tempat pengguna tertentu berada

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 ini mengambil daftar unit administratif tempat pengguna tertentu berada.

Contoh 2: Dapatkan daftar unit administratif tempat pengguna tertentu berada menggunakan parameter Semua

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 ini mengambil daftar unit administratif tempat pengguna tertentu menggunakan parameter Semua.

Contoh 3: Mendapatkan unit administratif tempat pengguna tertentu berada

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 ini mengambil unit administratif tempat pengguna tertentu berada. Anda dapat menggunakan -Limit sebagai alias untuk -Top.

Contoh 4: Dapatkan daftar unit administratif tempat pengguna tertentu berada menggunakan parameter ID Unit Administratif

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 ini mengambil daftar unit administratif tempat pengguna tertentu berada menggunakan parameter ID Unit Administratif.

  • -AdministrativeUnitId parameter menentukan ID unit administratif.

Contoh 5: Mendapatkan unit administratif tempat pengguna tertentu berada

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 ini mengambil unit administratif tempat pengguna tertentu berada.

Parameter

-AdministrativeUnitId

ID unik unit administratif.

Properti parameter

Jenis:System.String
Nilai default:None
Mendukung wildcard:False
DontShow:False
Alias:DirectoryObjectId

Kumpulan parameter

GetQuery
Position:Named
Wajib:True
Nilai dari alur:True
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-All

Cantumkan semua halaman.

Properti parameter

Jenis:System.Management.Automation.SwitchParameter
Nilai default:False
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Filter

Menentukan pernyataan filter OData v4.0. Parameter ini mengontrol objek mana yang dikembalikan.

Properti parameter

Jenis:System.String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

GetQuery
Position:Named
Wajib:False
Nilai dari alur:True
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-Property

Menentukan properti yang akan dikembalikan

Properti parameter

Jenis:

System.String[]

Nilai default:None
Mendukung wildcard:False
DontShow:False
Alias:Pilih

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Top

Jumlah maksimum unit administratif milik pengguna.

Properti parameter

Jenis:System.Int32
Nilai default:None
Mendukung wildcard:False
DontShow:False
Alias:Limit

Kumpulan parameter

GetQuery
Position:Named
Wajib:False
Nilai dari alur:True
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-UserId

Menentukan ID pengguna (sebagai UserPrincipalName atau ObjectId) di Microsoft Entra ID.

Properti parameter

Jenis:System.String
Nilai default:None
Mendukung wildcard:False
DontShow:False
Alias:ObjectId, UPN, Identity, Nama Pokok Pengguna

Kumpulan parameter

GetQuery
Position:Named
Wajib:True
Nilai dari alur:True
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

Output

System.Object