New-EntraBetaAdministrativeUnit

New-EntraBetaAdministrativeUnit

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

Das New-EntraBetaAdministrativeUnit 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-EntraBetaAdministrativeUnit -DisplayName 'TestAU'

id                            : bbbbbbbb-1111-2222-3333-cccccccccccc
displayName                   : TestAU
description                   :
isMemberManagementRestricted  :
membershipRule                :
membershipRuleProcessingState :
membershipType                :
visibility                    :

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-EntraBetaAdministrativeUnit -DisplayName 'Pacific Administrative Unit' -Description 'Administrative Unit for Pacific region'

id                            : bbbbbbbb-1111-2222-3333-cccccccccccc
displayName                   : Pacific Administrative Unit
description                   : Administrative Unit for Pacific region
isMemberManagementRestricted  :
membershipRule                :
membershipRuleProcessingState :
membershipType                :
visibility                    :

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-EntraBetaAdministrativeUnit `
    -DisplayName $displayName `
    -Description $description `
    -MembershipType 'Dynamic' `
    -MembershipRule $membershipRule `
    -MembershipRuleProcessingState 'On' `
    -Visibility 'HiddenMembership'

id                            : bbbbbbbb-1111-2222-3333-cccccccccccc
displayName                   : Chester District Schools
description                   : Chester District schools administration
isMemberManagementRestricted  :
membershipRule                : (user.country -eq "Australia")
membershipRuleProcessingState : On
membershipType                : Dynamic
visibility                    : 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.