Set-EntraUserExtension

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

Atualiza a extensão do utilizador.

Sintaxe

SetSingle (Predefinição) 

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>]

Descrição

O Set-EntraUserExtension cmdlet atualiza a extensão do utilizador no Microsoft Entra ID.

Update-EntraUserExtension é um alias para Set-EntraUserExtension.

Exemplos

Exemplo 1: Definir o valor de um atributo de extensão para um utilizador

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

Este exemplo demonstra como atualizar o atributo de extensão de um utilizador para um utilizador especificado. Use (Get-EntraApplicationExtensionProperty -ApplicationId '{ApplicationId}').Name | Select-Object -First 1 para recuperar o nome da extensão.

  • -UserId o parâmetro especifica o ID do utilizador (Nome Principal do Utilizador ou UserId).
  • -ExtensionName parâmetro especifica o nome de uma extensão.
  • -ExtensionValue O parâmetro especifica os valores do nome da extensão.

Exemplo 2: Atualizar múltiplos valores usando o 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

Este exemplo demonstra como atualizar o atributo de extensão de um utilizador. Use (Get-EntraApplicationExtensionProperty -ApplicationId '{ApplicationId}').Name | Select-Object -First 1 para recuperar o nome da extensão.

  • -UserId o parâmetro especifica o ID do utilizador (Nome Principal do Utilizador ou UserId).
  • -ExtensionNameValues Parameter especifica um dicionário de pares-chave-valor para o par de nome e valor da extensão.

Parâmetros

-ExtensionName

Especifica o nome de uma extensão.

Propriedades dos parâmetros

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

Conjuntos de parâmetros

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

-ExtensionNameValues

Especifica os valores do nome da extensão.

Propriedades dos parâmetros

Tipo:

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

Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

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

-ExtensionValue

Especifica um valor de extensão.

Propriedades dos parâmetros

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

Conjuntos de parâmetros

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

-UserId

Especifica o identificador único do utilizador (Nome Principal do Utilizador ou UserId).

Propriedades dos parâmetros

Tipo:System.String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:IdentificadorDoObjeto, UPN, Identidade, Nome Principal do Utilizador

Conjuntos de parâmetros

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

Notas

Update-EntraUserExtension é um alias para Set-EntraUserExtension.