New-EntraAdministrativeUnit

New-EntraAdministrativeUnit

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

De New-EntraAdministrativeUnit cmdlet maakt een beheereenheid in Microsoft Entra ID. Geef DisplayName de parameter op om een beheereenheid te maken.

In gedelegeerde scenario's moet aan de aangemelde gebruiker een ondersteunde Microsoft Entra-rol of een aangepaste rol met de microsoft.directory/administrativeUnits/allProperties/allTasks machtiging worden toegewezen. De volgende rollen met minimale bevoegdheden worden ondersteund voor deze bewerking:

• Bevoorrechte Rollenbeheerder

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

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

In dit voorbeeld ziet u hoe u een beheereenheid maakt.

• -DisplayName parameter geeft de weergavenaam voor het object Beheereenheid.

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 dit voorbeeld ziet u hoe u een beheereenheid maakt.

• -DisplayName parameter geeft de weergavenaam voor het object Beheereenheid.
• -Description parameter geeft een beschrijving voor het object Beheereenheid.

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 dit voorbeeld ziet u hoe u een beheereenheid maakt met gedetailleerde configuratiegegevens.

• -DisplayName parameter geeft de weergavenaam voor het object Beheereenheid.
• -Description parameter geeft een beschrijving voor het object Beheereenheid.
• -MembershipRule parameter geeft de dynamische lidmaatschapsregel die wordt toegepast op de beheereenheid.
• -MembershipType parameter geeft het lidmaatschapstype van de beheereenheid. Mogelijke waarden zijn: dynamisch en toegewezen. Als deze niet is ingesteld, is de standaardwaarde null en wordt het lidmaatschapstype standaard toegewezen.
• -MembershipRuleProcessingState parameter bepaalt of de dynamische lidmaatschapsregel actief is. Ingesteld om On deze in te schakelen of Paused updates te stoppen.
• -Visibility parameter geeft de zichtbaarheid van de beheereenheid. Wordt standaard op public ingesteld als niet anders ingesteld. Ingesteld op HiddenMembership het verbergen van lidmaatschap van niet-leden.

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.