New-EntraBetaAdministrativeUnit

New-EntraBetaAdministrativeUnit

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

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

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

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-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 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-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 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.