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 em Microsoft Entra ID. Especifique DisplayName o parâmetro para criar uma unidade administrativa.

Em cenários delegados, o usuário conectado deve receber uma função de Microsoft Entra com suporte ou uma função personalizada que inclua a microsoft.directory/administrativeUnits/allProperties/allTasks permissão. As seguintes funções com menos privilégios são suportadas para esta operação:

• Administrador de Função Privilégiada

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 do objeto de 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 do objeto de unidade administrativa.
• -Description o parâmetro especifica uma descrição para o objeto de 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 do objeto de unidade administrativa.
• -Description o parâmetro especifica uma descrição para o objeto de unidade administrativa.
• -MembershipRule O parâmetro especifica a regra de associação dinâmica aplicada à unidade administrativa.
• -MembershipType o parâmetro especifica o tipo de associação da unidade administrativa. Os valores possíveis são: dinâmicos e atribuídos. Se não for definido, o valor padrão será nulo e o tipo de associação será atribuído.
• -MembershipRuleProcessingState o parâmetro controlará se a regra de associação dinâmica estiver ativa. Defina para On habilitá-lo ou Paused parar atualizações.
• -Visibility o parâmetro especifica a visibilidade da unidade administrativa. O padrão é public se não for definido. Definido para HiddenMembership ocultar a associação de 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.