New-EntraAdministrativeUnit

New-EntraAdministrativeUnit

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

Cmdleten New-EntraAdministrativeUnit skapar en administrativ enhet i Microsoft Entra ID. Ange DisplayName parameter för att skapa en administrativ enhet.

I delegerade scenarier måste den inloggade användaren tilldelas en Microsoft Entra roll som stöds eller en anpassad roll som innehåller behörighetenmicrosoft.directory/administrativeUnits/allProperties/allTasks. Följande minst privilegierade roller stöds för den här åtgärden:

• Privilegierad rolladministratör

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

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

Det här exemplet visar hur du skapar en administrativ enhet.

• -DisplayName parameter anger visningsnamnet för objektet Administrationsenhet.

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

Det här exemplet visar hur du skapar en administrativ enhet.

• -DisplayName parameter anger visningsnamnet för objektet Administrationsenhet.
• -Description parameter anger en beskrivning för objektet Administrationsenhet.

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

Det här exemplet visar hur du skapar en administrativ enhet med detaljerad konfigurationsinformation.

• -DisplayName parameter anger visningsnamnet för objektet Administrationsenhet.
• -Description parameter anger en beskrivning för objektet Administrationsenhet.
• -MembershipRule parameter anger regeln för dynamiskt medlemskap som tillämpas på den administrativa enheten.
• -MembershipType parameter anger medlemskapstypen för den administrativa enheten. Möjliga värden är: dynamiska och tilldelade. Om det inte anges är standardvärdet null och medlemskapstypen tilldelas som standard.
• -MembershipRuleProcessingState parameterkontroller om regeln för dynamiskt medlemskap är aktiv. Ange till On för att aktivera eller Paused stoppa uppdateringar.
• -Visibility parametern anger synligheten för den administrativa enheten. Standardvärdet är public om det inte har angetts. Ange till för att HiddenMembership dölja medlemskap från icke-medlemmar.

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.