Get-EntraBetaAdministrativeUnit

Modul:
Microsoft.Entra.Beta.DirectoryManagement Module v1.3

Ruft eine administrative Einheit ab.

Syntax

GetQuery (Standard) 

Get-EntraBetaAdministrativeUnit

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

GetById 

Get-EntraBetaAdministrativeUnit

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

Beschreibung

Das Get-EntraBetaAdministrativeUnit Cmdlet ruft eine Microsoft Entra ID administrative Einheit ab. Geben Sie AdministrativeUnitId den Parameter an, um eine bestimmte administrative Einheit abzurufen.

Beispiele

Beispiel 1: Abrufen aller administrativen Einheiten

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

Dieser Befehl ruft alle administrativen Einheiten ab.

Beispiel 2: Abrufen aller administrativen Einheiten mit dem Parameter "-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

Dieser Befehl ruft alle administrativen Einheiten ab.

Beispiel 3: Abrufen einer bestimmten Administrativen Einheit

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

In diesem Beispiel werden die Details der angegebenen Administrativen Einheit zurückgegeben.

  • -AdministrativeUnitId der Parameter gibt die ID einer administrativen Einheit an.

Beispiel 4: Abrufen des Filters für administrative Einheiten nach Anzeigename

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

In diesem Beispiel werden administrative Einheiten aufgeführt, die den Anzeigenamen mit dem angegebenen Namen enthalten.

Beispiel 5: Abrufen der obersten Administrativen Einheit

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

In diesem Beispiel werden die angegebenen obersten administrativen Einheiten zurückgegeben. Sie können -Limit als Alias für -Top verwenden.

Parameter

-AdministrativeUnitId

Gibt die ID einer administrativen Einheit in Microsoft Entra ID an.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Id

Parametersätze

GetById
Position:Named
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-All

Alle Seiten auflisten.

Parametereigenschaften

Typ:System.Management.Automation.SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Filter

Gibt eine OData v4.0-Filter-Anweisung an. Dieser Parameter filtert, welche Objekte zurückgegeben werden.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

GetQuery
Position:Named
Obligatorisch:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Property

Gibt eigenschaften an, die zurückgegeben werden sollen.

Parametereigenschaften

Typ:

System.String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Select

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Top

Gibt die maximale Anzahl der zurückzugebenden Datensätze an.

Parametereigenschaften

Typ:System.Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Begrenzung

Parametersätze

GetQuery
Position:Named
Obligatorisch:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.