New-EntraAdministrativeUnit

New-EntraAdministrativeUnit

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

O New-EntraAdministrativeUnit cmdlet cria uma unidade administrativa no Microsoft Entra ID. Especifique DisplayName o parâmetro para criar uma unidade administrativa.

Em cenários delegados, o utilizador iniciado deve ser atribuído a um papel Microsoft Entra suportado ou a um papel personalizado que inclua a microsoft.directory/administrativeUnits/allProperties/allTasks permissão. Os seguintes papéis de menor privilégio são suportados para esta operação:

• Administrador de Função Privilegiada

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

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

Este exemplo demonstra como criar uma unidade administrativa.

• -DisplayName o parâmetro especifica o nome de exibição para o objeto da unidade Administrativa.

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

Este exemplo demonstra como criar uma unidade administrativa.

• -DisplayName o parâmetro especifica o nome de exibição para o objeto da unidade Administrativa.
• -Description o parâmetro especifica uma descrição para o objeto da unidade administrativa.

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

Este exemplo demonstra como criar uma unidade administrativa com informações detalhadas de configuração.

• -DisplayName o parâmetro especifica o nome de exibição para o objeto da unidade Administrativa.
• -Description o parâmetro especifica uma descrição para o objeto da unidade administrativa.
• -MembershipRule O parâmetro especifica a regra dinâmica de adesão aplicada à unidade administrativa.
• -MembershipType O parâmetro especifica o tipo de pertença à unidade administrativa. Os valores possíveis são: dinâmicos e atribuídos. Se não for definido, o valor padrão é nulo, e o tipo de membro é atribuído por defeito.
• -MembershipRuleProcessingState parâmetros controla se a regra dinâmica de pertença está ativa. Defina para On ativar ou Paused parar atualizações.
• -Visibility o parâmetro especifica a visibilidade da unidade administrativa. O valor padrão é public caso não esteja definido. Definido para HiddenMembership ocultar a adesão a não membros.

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.