Set-EntraUserExtension

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

Actualiza la extensión de un usuario.

Sintaxis

SetSingle (valor predeterminado) 

Set-EntraUserExtension

    -UserId <String>
    -ExtensionName <String>
    -ExtensionValue <String>
    [<CommonParameters>]

SetMultiple 

Set-EntraUserExtension

    -UserId <String>
    -ExtensionNameValues <System.Collections.Generic.Dictionary`2[System.String,System.String]>
    [<CommonParameters>]

Description

El Set-EntraUserExtension cmdlet actualiza la extensión de un usuario en Microsoft Entra ID.

Update-EntraUserExtension es un alias de Set-EntraUserExtension.

Ejemplos

Ejemplo 1: Establecimiento del valor de un atributo de extensión para un usuario

Connect-Entra -Scopes 'User.ReadWrite.All'
$extensionName = 'extension_e5e29b8a85d941eab8d12162bd004528_JobGroup'
$extensionValue = 'Job Group D'
Set-EntraUserExtension -UserId 'SawyerM@contoso.com' -ExtensionName $extensionName -ExtensionValue $extensionValue

En este ejemplo se muestra cómo actualizar el atributo de extensión de un usuario para un usuario especificado. Use (Get-EntraApplicationExtensionProperty -ApplicationId '{ApplicationId}').Name | Select-Object -First 1 para recuperar el nombre de la extensión.

  • -UserId el parámetro especifica el identificador de usuario (nombre principal de usuario o UserId).
  • -ExtensionName parameter especifica el nombre de una extensión.
  • -ExtensionValue parameter especifica los valores de nombre de extensión.

Ejemplo 2: Actualización de varios valores mediante el parámetro ExtensionNameValues

Connect-Entra -Scopes 'User.ReadWrite.All'
$userExtensionValues = New-Object 'System.Collections.Generic.Dictionary[String,String]'
$userExtensionValues.Add("extension_d2ba83696c3f45429fbabb363ae391a0_Benefits", "Pension")
$userExtensionValues.Add("extension_d2ba83696c3f45429fbabb363ae391a0_JobGroup", "D")
Set-EntraUserExtension -UserId 'SawyerM@contoso.com' -ExtensionNameValues $userExtensionValues

En este ejemplo se muestra cómo actualizar el atributo de extensión de un usuario. Use (Get-EntraApplicationExtensionProperty -ApplicationId '{ApplicationId}').Name | Select-Object -First 1 para recuperar el nombre de la extensión.

  • -UserId el parámetro especifica el identificador de usuario (nombre principal de usuario o UserId).
  • -ExtensionNameValues parameter especifica un diccionario de pares clave-valor para el nombre de extensión y el par de valores.

Parámetros

-ExtensionName

Especifica el nombre de una extensión.

Propiedades de parámetro

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

Conjuntos de parámetros

SetSingle
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

-ExtensionNameValues

Especifica valores de nombre de extensión.

Propiedades de parámetro

Tipo:

System.Collections.Generic.Dictionary`2[System.String,System.String]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

SetMultiple
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

-ExtensionValue

Especifica un valor de extensión.

Propiedades de parámetro

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

Conjuntos de parámetros

SetSingle
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

-UserId

Especifica el identificador único del usuario (Nombre principal de usuario o UserId).

Propiedades de parámetro

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

Conjuntos de parámetros

SetSingle
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
SetMultiple
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

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.

Notas

Update-EntraUserExtension es un alias de Set-EntraUserExtension.