Set-EntraAdministrativeUnit

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

Actualiza las propiedades de una unidad administrativa.

Sintaxis

Default (valor predeterminado) 

Set-EntraAdministrativeUnit

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

Description

El Set-EntraAdministrativeUnit cmdlet actualiza las propiedades de una unidad administrativa en Microsoft Entra ID. Especifique AdministrativeUnitId el parámetro para actualizar una unidad administrativa específica.

En escenarios delegados, al usuario que ha iniciado sesión se le debe asignar un rol de Microsoft Entra compatible o un rol personalizado con el microsoft.directory/administrativeUnits/allProperties/allTasks permiso.

Se admiten los siguientes roles con privilegios mínimos para esta operación:

  • Administrador de roles con privilegios

Ejemplos

Ejemplo 1: Actualizar DisplayName y descripción

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 actualiza DisplayName de una unidad administrativa específica.

  • -AdministrativeUnitId parameter especifica el identificador de una unidad administrativa.
  • -DisplayName el parámetro especifica el nombre para mostrar de la unidad administrativa.
  • -Description el parámetro especifica la descripción de la unidad administrativa.

Parámetros

-AdministrativeUnitId

Especifica el identificador de una unidad administrativa en Microsoft Entra ID.

Propiedades de parámetro

Tipo:System.String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:ObjectId (identificador de objeto)

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Description

Especifica una descripción de la unidad administrativa.

Propiedades de parámetro

Tipo:System.String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DisplayName

Especifica un nombre para mostrar para la unidad administrativa.

Propiedades de parámetro

Tipo:System.String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-MembershipRule

Especifica la regla de pertenencia dinámica aplicada a la unidad administrativa. Los valores posibles son: dynamic, assigned. Si no se establece, el valor predeterminado es null y el comportamiento predeterminado es assigned. Este parámetro es opcional.

Propiedades de parámetro

Tipo:System.String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-MembershipRuleProcessingState

Controla si la regla de pertenencia dinámica está activa. Establézcalo en On para habilitarlo o Paused detener las actualizaciones. Este parámetro es opcional.

Propiedades de parámetro

Tipo:System.String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-MembershipType

Especifica el tipo de pertenencia de la unidad administrativa. Los valores posibles son: dynamic y assigned. Si no se establece, el valor predeterminado es nully el tipo de pertenencia tiene assignedcomo valor predeterminado . Este parámetro es opcional.

Propiedades de parámetro

Tipo:System.String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Visibility

Especifica la visibilidad de la unidad administrativa. El valor predeterminado es public si no se establece. Establézcalo en HiddenMembership para ocultar la pertenencia de miembros que no son miembros. Este parámetro es opcional.

Propiedades de parámetro

Tipo:System.String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.