Get-EntraBetaAdministrativeUnit

Pobiera jednostkę administracyjną.

Składnia

GetQuery (domyślnie)

Get-EntraBetaAdministrativeUnit

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

GetById

Get-EntraBetaAdministrativeUnit

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

Opis

Polecenie Get-EntraBetaAdministrativeUnit cmdlet pobiera Microsoft Entra ID jednostkę administracyjną. Określ AdministrativeUnitId parametr, aby uzyskać określoną jednostkę administracyjną.

Przykłady

Przykład 1. Pobieranie wszystkich jednostek administracyjnych

Connect-Entra -Scopes 'AdministrativeUnit.Read.All'
Get-EntraBetaAdministrativeUnit
DeletedDateTime Id                                   Description          DisplayName         IsMemberManagementRestricted Visibility
--------------- --                                   -----------          -----------         ---------------------------- ----------
                aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Updated Description  Updated DisplayName
                bbbbbbbb-1111-2222-3333-cccccccccccc test111              test111
                cccccccc-2222-3333-4444-dddddddddddd                      TestAU
                dddddddd-3333-4444-5555-eeeeeeeeeeee                      test_130624_09
                eeeeeeee-4444-5555-6666-ffffffffffff test111              test111
                ffffffff-5555-6666-7777-aaaaaaaaaaaa                      test66
                aaaaaaaa-6666-7777-8888-bbbbbbbbbbbb test111              test111             True

To polecenie pobiera wszystkie jednostki administracyjne.

Przykład 2. Pobieranie wszystkich jednostek administracyjnych przy użyciu parametru "-All"

Connect-Entra -Scopes 'AdministrativeUnit.Read.All'
Get-EntraBetaAdministrativeUnit -All
DeletedDateTime Id                                   Description          DisplayName         IsMemberManagementRestricted Visibility
--------------- --                                   -----------          -----------         ---------------------------- ----------
                aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Updated Description  Updated DisplayName
                bbbbbbbb-1111-2222-3333-cccccccccccc test111              test111
                cccccccc-2222-3333-4444-dddddddddddd                      TestAU
                dddddddd-3333-4444-5555-eeeeeeeeeeee                      test_130624_09
                eeeeeeee-4444-5555-6666-ffffffffffff test111              test111
                ffffffff-5555-6666-7777-aaaaaaaaaaaa                      test66
                aaaaaaaa-6666-7777-8888-bbbbbbbbbbbb test111              test111             True

To polecenie pobiera wszystkie jednostki administracyjne.

Przykład 3. Uzyskiwanie określonej jednostki administracyjnej

Connect-Entra -Scopes 'AdministrativeUnit.Read.All'
Get-EntraBetaAdministrativeUnit -AdministrativeUnitId 'aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb'
DeletedDateTime Id                                   Description          DisplayName         IsMemberManagementRestricted Visibility
--------------- --                                   -----------          -----------         ---------------------------- ----------
                aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Updated Description  Updated DisplayName

Ten przykład zwraca szczegóły określonej jednostki administracyjnej.

  • -AdministrativeUnitId parametr określa identyfikator jednostki administracyjnej.

Przykład 4. Pobieranie jednostek administracyjnych filtruj według nazwy wyświetlanej

Connect-Entra -Scopes 'AdministrativeUnit.Read.All'
Get-EntraBetaAdministrativeUnit -Filter "DisplayName eq 'Updated DisplayName'"
DeletedDateTime Id                                   Description          DisplayName         IsMemberManagementRestricted Visibility
--------------- --                                   -----------          -----------         ---------------------------- ----------
                aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Updated Description  Updated DisplayName

Ta przykładowa lista jednostek administracyjnych zawierających nazwę wyświetlaną o określonej nazwie.

Przykład 5. Uzyskiwanie pierwszej jednostki administracyjnej

Connect-Entra -Scopes 'AdministrativeUnit.Read.All'
Get-EntraBetaAdministrativeUnit -Top 1
DeletedDateTime Id                                   Description          DisplayName         IsMemberManagementRestricted Visibility
--------------- --                                   -----------          -----------         ---------------------------- ----------
                aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Updated Description  Updated DisplayName

Ten przykład zwraca określone najwyższe jednostki administracyjne. Możesz użyć -Limit jako aliasu dla -Top.

Parametry

-AdministrativeUnitId

Określa identyfikator jednostki administracyjnej w Microsoft Entra ID.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Id

Zestawy parametrów

GetById
Position:Named
Obowiązkowe:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-All

Wyświetl listę wszystkich stron.

Właściwości parametru

Typ:System.Management.Automation.SwitchParameter
Domyślna wartość:False
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Filter

Określa instrukcję filtru OData w wersji 4.0. Ten parametr filtruje zwracane obiekty.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

GetQuery
Position:Named
Obowiązkowe:False
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-Property

Określa właściwości, które mają być zwracane.

Właściwości parametru

Typ:

System.String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Select

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Top

Określa maksymalną liczbę rekordów do zwrócenia.

Właściwości parametru

Typ:System.Int32
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Ograniczenie

Zestawy parametrów

GetQuery
Position:Named
Obowiązkowe:False
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.