New-EntraAdministrativeUnit

New-EntraAdministrativeUnit

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

Il New-EntraAdministrativeUnit cmdlet crea un'unità amministrativa in Microsoft Entra ID. Specificare il DisplayName parametro per creare un'unità amministrativa.

Negli scenari delegati, all'utente connesso deve essere assegnato un ruolo Microsoft Entra supportato o un ruolo personalizzato che include l'autorizzazionemicrosoft.directory/administrativeUnits/allProperties/allTasks. Per questa operazione sono supportati i ruoli con privilegi minimi seguenti:

• Amministratore di ruolo privilegiato

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

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

In questo esempio viene illustrato come creare un'unità amministrativa.

• -DisplayName parametro specifica il nome visualizzato per l'oggetto Unità amministrativa.

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 questo esempio viene illustrato come creare un'unità amministrativa.

• -DisplayName parametro specifica il nome visualizzato per l'oggetto Unità amministrativa.
• -Description parametro specifica una descrizione per l'oggetto unità amministrativa.

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 questo esempio viene illustrato come creare un'unità amministrativa con informazioni dettagliate sulla configurazione.

• -DisplayName parametro specifica il nome visualizzato per l'oggetto Unità amministrativa.
• -Description parametro specifica una descrizione per l'oggetto unità amministrativa.
• -MembershipRule parametro specifica la regola di appartenenza dinamica applicata all'unità amministrativa.
• -MembershipType parametro specifica il tipo di appartenenza dell'unità amministrativa. I valori possibili sono: dinamici e assegnati. Se non è impostato, il valore predefinito è Null e il tipo di appartenenza viene assegnato per impostazione predefinita.
• -MembershipRuleProcessingState il parametro controlla se la regola di appartenenza dinamica è attiva. Impostare su per On abilitarlo o Paused arrestare gli aggiornamenti.
• -Visibility parametro specifica la visibilità dell'unità amministrativa. L'impostazione predefinita è public se non impostata. Impostare su HiddenMembership per nascondere l'appartenenza da membri non membri.

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.