Get-EntraBetaAdministrativeUnitMember

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

Ruft ein Mitglied einer Verwaltungseinheit ab.

Syntax

Default (Standard) 

Get-EntraBetaAdministrativeUnitMember

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

Beschreibung

Das Get-EntraBetaAdministrativeUnitMember Cmdlet ruft ein Mitglied einer Microsoft Entra ID administrativen Einheit ab. Geben Sie AdministrativeUnitId Parameter an, um ein Mitglied einer Administrativen Einheit abzurufen.

In delegierten Szenarien mit Geschäfts-, Schul- oder Unikonten muss der angemeldete Benutzer entweder mitglied sein oder einer unterstützten Microsoft Entra Rolle oder einer benutzerdefinierten Rolle mit den erforderlichen Berechtigungen zugewiesen werden. Für diesen Vorgang werden die folgenden Rollen mit den geringsten Berechtigungen unterstützt:

  • Verzeichnisleser: Grundlegende Eigenschaften für administrative Einheiten lesen
  • Globaler Reader: Lesen aller Eigenschaften administrativer Einheiten, einschließlich Mitglieder
  • Administrator für privilegierte Rollen: Erstellen und Verwalten administrativer Einheiten (einschließlich Mitglieder)

Beispiele

Beispiel 1: Abrufen eines Administrativen Einheitenmitglieds durch AdministrativeUnitId

Connect-Entra -Scopes 'AdministrativeUnit.ReadWrite.All'
$administrativeUnit = Get-EntraBetaAdministrativeUnit -Filter "DisplayName eq '<administrativeunit-display-name>'"
Get-EntraBetaAdministrativeUnitMember -AdministrativeUnitId $administrativeUnit.Id |
Select-Object Id, DisplayName, '@odata.type', createdDateTime

id                                   DisplayName         @odata.type              CreatedDateTime
--                                   -----------         -----------              ---------------
bbbbbbbb-1111-2222-3333-cccccccccccc Alex Wilber        #microsoft.graph.user    10/7/2024 12:31:51 AM
cccccccc-2222-3333-4444-dddddddddddd Adele Miller      #microsoft.graph.user    10/7/2024 12:32:17 AM
dddddddd-3333-4444-5555-eeeeeeeeeeee Sales and Marketing #microsoft.graph.group  10/7/2024 12:43:47 AM
ffffffff-5555-6666-7777-aaaaaaaaaaaa Contoso Global     #microsoft.graph.group   10/27/2024 6:48:09 AM

In diesem Beispiel wird die Liste der Administrativen Einheitenmitglieder aus der angegebenen Objekt-ID der Administrativen Einheit zurückgegeben.

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

Beispiel 2: Abrufen aller Administrativen Einheitenmitglieder durch AdministrativeUnitId

Connect-Entra -Scopes 'AdministrativeUnit.ReadWrite.All'
$administrativeUnit = Get-EntraBetaAdministrativeUnit -Filter "DisplayName eq '<administrativeunit-display-name>'"
Get-EntraBetaAdministrativeUnitMember -AdministrativeUnitId $administrativeUnit.Id -All |
Select-Object Id, DisplayName, '@odata.type', createdDateTime

id                                   DisplayName         @odata.type              CreatedDateTime
--                                   -----------         -----------              ---------------
bbbbbbbb-1111-2222-3333-cccccccccccc Alex Wilber        #microsoft.graph.user    10/7/2024 12:31:51 AM
cccccccc-2222-3333-4444-dddddddddddd Adele Miller      #microsoft.graph.user    10/7/2024 12:32:17 AM
dddddddd-3333-4444-5555-eeeeeeeeeeee Sales and Marketing #microsoft.graph.group  10/7/2024 12:43:47 AM
ffffffff-5555-6666-7777-aaaaaaaaaaaa Contoso Global     #microsoft.graph.group   10/27/2024 6:48:09 AM

In diesem Beispiel wird die Liste aller Administrativen Einheitenmitglieder aus der angegebenen ObjectId der Administrativen Einheit zurückgegeben.

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

Beispiel 3: Abrufen der drei wichtigsten Administrativen Einheitenmitglieder durch AdministrativeUnitId

Connect-Entra -Scopes 'AdministrativeUnit.ReadWrite.All'
$administrativeUnit = Get-EntraBetaAdministrativeUnit -Filter "DisplayName eq '<administrativeunit-display-name>'"
Get-EntraBetaAdministrativeUnitMember -AdministrativeUnitId $administrativeUnit.Id -Top 3 |
Select-Object Id, DisplayName, '@odata.type', createdDateTime

id                                   DisplayName         @odata.type              CreatedDateTime
--                                   -----------         -----------              ---------------
bbbbbbbb-1111-2222-3333-cccccccccccc Alex Wilber        #microsoft.graph.user    10/7/2024 12:31:51 AM
cccccccc-2222-3333-4444-dddddddddddd Adele Miller      #microsoft.graph.user    10/7/2024 12:32:17 AM
dddddddd-3333-4444-5555-eeeeeeeeeeee Sales and Marketing #microsoft.graph.group  10/7/2024 12:43:47 AM

In diesem Beispiel werden die drei wichtigsten Administrativen Einheitenmmber aus der angegebenen Objekt-ID der Administrativen Einheit zurückgegeben. Sie können -Limit als Alias für -Top verwenden.

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

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:Objekt-ID

Parametersätze

(All)
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

-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

(All)
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.