Set-EntraAdministrativeUnit

Módulo:
Microsoft.Entra.DirectoryManagement Module v1.3

Atualiza as propriedades de uma unidade administrativa.

Sintaxe

Default (Default) 

Set-EntraAdministrativeUnit

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

Description

O Set-EntraAdministrativeUnit cmdlet atualiza as propriedades de uma unidade administrativa em Microsoft Entra ID. Especifique AdministrativeUnitId o parâmetro para atualizar uma unidade administrativa específica.

Em cenários delegados, o usuário conectado deve receber uma função de Microsoft Entra com suporte ou uma função personalizada com 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

Exemplos

Exemplo 1: Atualizar DisplayName e descrição

Connect-Entra -Scopes 'AdministrativeUnit.ReadWrite.All'
$administrativeUnit = Get-EntraAdministrativeUnit -Filter "DisplayName eq 'Pacific Administrative Unit'"
Set-EntraAdministrativeUnit -AdministrativeUnitId $administrativeUnit.Id -DisplayName 'Pacific Admin Unit' -Description 'Pacific Admin Unit Description' -MembershipType 'Assigned'

Este comando atualiza DisplayName de uma unidade administrativa específica.

  • -AdministrativeUnitId o parâmetro especifica a ID de uma unidade administrativa.
  • -DisplayName o parâmetro especifica o nome de exibição da unidade administrativa.
  • -Description o parâmetro especifica a descrição da unidade administrativa.

Parâmetros

-AdministrativeUnitId

Especifica a ID de uma unidade administrativa em Microsoft Entra ID.

Propriedades do parâmetro

Tipo:System.String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:IdentificadorDeObjeto

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Description

Especifica uma descrição para a unidade administrativa.

Propriedades do parâmetro

Tipo:System.String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DisplayName

Especifica um nome de exibição para a unidade administrativa.

Propriedades do parâmetro

Tipo:System.String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-MembershipRule

Especifica a regra de associação dinâmica aplicada à unidade administrativa. Os valores possíveis são: dynamic, assigned. Se não for definido, o valor padrão será null e o comportamento padrão será assigned. Esse parâmetro é opcional.

Propriedades do parâmetro

Tipo:System.String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-MembershipRuleProcessingState

Controla se a regra de associação dinâmica está ativa. Defina para On habilitá-lo ou Paused parar atualizações. Esse parâmetro é opcional.

Propriedades do parâmetro

Tipo:System.String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-MembershipType

Especifica o tipo de associação da unidade administrativa. Os valores possíveis são: dynamic e assigned. Se não for definido, o valor padrão será nulle o tipo de associação será padrão .assigned Esse parâmetro é opcional.

Propriedades do parâmetro

Tipo:System.String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Visibility

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. Esse parâmetro é opcional.

Propriedades do parâmetro

Tipo:System.String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

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.