New-EntraAdministrativeUnit

New-EntraAdministrativeUnit

    -DisplayName <String>
    [-Description <String>]
    [-MembershipType <String>]
    [-MembershipRule <String>]
    [-MembershipRuleProcessingState <String>]
    [-Visibility <String>]
    [<CommonParameters>]

Das New-EntraAdministrativeUnit Cmdlet erstellt eine administrative Einheit in Microsoft Entra ID. Geben Sie DisplayName den Parameter an, um eine administrative Einheit zu erstellen.

In delegierten Szenarien muss dem angemeldeten Benutzer eine unterstützte Microsoft Entra Rolle oder eine benutzerdefinierte Rolle zugewiesen werden, die die microsoft.directory/administrativeUnits/allProperties/allTasks Berechtigung enthält. Für diesen Vorgang werden die folgenden Rollen mit den geringsten Rechten unterstützt:

• Administrator für privilegierte Rollen

Connect-Entra -Scopes 'AdministrativeUnit.ReadWrite.All'
New-EntraAdministrativeUnit -DisplayName 'TestAU'

DeletedDateTime Id                                   Description DisplayName Visibility
--------------- --                                   ----------- ----------- ----------
                bbbbbbbb-1111-2222-3333-cccccccccccc             TestAU

In diesem Beispiel wird das Erstellen einer administrativen Einheit veranschaulicht.

• -DisplayName der Parameter gibt den Anzeigenamen für das Objekt der Administrativen Einheit an.

Connect-Entra -Scopes 'AdministrativeUnit.ReadWrite.All'
New-EntraAdministrativeUnit -DisplayName 'Pacific Administrative Unit' -Description 'Administrative Unit for Pacific region'

DeletedDateTime Id                                   Description DisplayName IsMemberManagementRestricted Visibility
--------------- --                                   ----------- ----------- ---------------------------- ----------
                bbbbbbbb-1111-2222-3333-cccccccccccc Pacific Administrative Unit     test111     False

In diesem Beispiel wird das Erstellen einer administrativen Einheit veranschaulicht.

• -DisplayName der Parameter gibt den Anzeigenamen für das Objekt der Administrativen Einheit an.
• -Description der Parameter gibt eine Beschreibung für das Objekt der Administrativen Einheit an.

Connect-Entra -Scopes 'AdministrativeUnit.ReadWrite.All'
$displayName = 'Seattle District Technical Schools'
$description = 'Seattle district technical schools administration'
$membershipRule = '(user.country -eq "United States")'

New-EntraAdministrativeUnit `
    -DisplayName $displayName `
    -Description $description `
    -MembershipType 'Dynamic' `
    -MembershipRule $membershipRule `
    -MembershipRuleProcessingState 'On' `
    -Visibility 'HiddenMembership'

DeletedDateTime Id                                   Description                                       DisplayName                        Visibility
--------------- --                                   -----------                                       -----------                        ----------
                bbbbbbbb-1111-2222-3333-cccccccccccc Seattle district technical schools administration Seattle District Technical Schools HiddenMembership

In diesem Beispiel wird veranschaulicht, wie Sie eine Administrative Einheit mit detaillierten Konfigurationsinformationen erstellen.

• -DisplayName der Parameter gibt den Anzeigenamen für das Objekt der Administrativen Einheit an.
• -Description der Parameter gibt eine Beschreibung für das Objekt der Administrativen Einheit an.
• -MembershipRule der Parameter gibt die dynamische Mitgliedschaftsregel an, die auf die administrative Einheit angewendet wird.
• -MembershipType der Parameter gibt den Mitgliedschaftstyp der administrativen Einheit an. Mögliche Werte sind: dynamisch und zugewiesen. Wenn sie nicht festgelegt ist, ist der Standardwert NULL, und der Mitgliedschaftstyp ist standardmäßig zugewiesen.
• -MembershipRuleProcessingState Parameter steuert, ob die Dynamische Mitgliedschaftsregel aktiv ist. Legen Sie diese Einstellung fest, On um updates zu aktivieren oder Paused zu beenden.
• -Visibility der Parameter gibt die Sichtbarkeit der administrativen Einheit an. Wenn nicht festgelegt, wird public standardmäßig festgelegt. Legen Sie diesen Fest, HiddenMembership um die Mitgliedschaft von Nicht-Mitgliedern auszublenden.

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.