Set-EntraAdministrativeUnit

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

Atualiza as propriedades de uma unidade administrativa.

Sintaxe

Default (Predefinição) 

Set-EntraAdministrativeUnit

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

Descrição

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

Em cenários delegados, o utilizador iniciado deve ser atribuído a um papel Microsoft Entra suportado ou a um papel personalizado com permissãomicrosoft.directory/administrativeUnits/allProperties/allTasks.

Os seguintes papéis de menor privilégio são suportados para esta operação:

  • Administrador de Função Privilegiada

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 o DisplayName de uma unidade administrativa específica.

  • -AdministrativeUnitId o parâmetro especifica o 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 o ID de uma unidade administrativa no Microsoft Entra ID.

Propriedades dos parâmetros

Tipo:System.String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:IdentificadorDoObjeto

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-Description

Especifica uma descrição para a unidade administrativa.

Propriedades dos parâmetros

Tipo:System.String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-DisplayName

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

Propriedades dos parâmetros

Tipo:System.String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-MembershipRule

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

Propriedades dos parâmetros

Tipo:System.String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-MembershipRuleProcessingState

Controla se a regra dinâmica de adesão está ativa. Defina para On ativar ou Paused parar atualizações. Este parâmetro é opcional.

Propriedades dos parâmetros

Tipo:System.String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-MembershipType

Especifica o tipo de membro da unidade administrativa. Os valores possíveis são: dynamic e assigned. Se não for definido, o valor padrão é null, e o tipo de pertença por defeito é assigned. Este parâmetro é opcional.

Propriedades dos parâmetros

Tipo:System.String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Visibility

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

Propriedades dos parâmetros

Tipo:System.String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.