Set-EntraUserExtension

Module:
Microsoft.Entra.Users Module v1.3

Met à jour l’extension d’un utilisateur.

Syntaxe

SetSingle (Par défaut) 

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

LSet-EntraUserExtension'applet de commande met à jour l'extension d'un utilisateur dans Microsoft Entra ID.

Update-EntraUserExtension est un alias pour Set-EntraUserExtension.

Exemples

Exemple 1 : Définir la valeur d’un attribut d’extension pour un utilisateur

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

Cet exemple montre comment mettre à jour l’attribut d’extension d’un utilisateur pour un utilisateur spécifié. Permet (Get-EntraApplicationExtensionProperty -ApplicationId '{ApplicationId}').Name | Select-Object -First 1 de récupérer le nom de l’extension.

  • -UserId spécifie l’ID utilisateur (nom d’utilisateur principal ou UserId).
  • -ExtensionName spécifie le nom d’une extension.
  • -ExtensionValue spécifie les valeurs de nom d’extension.

Exemple 2 : Mettre à jour plusieurs valeurs à l’aide du paramètre 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

Cet exemple montre comment mettre à jour l’attribut d’extension d’un utilisateur. Permet (Get-EntraApplicationExtensionProperty -ApplicationId '{ApplicationId}').Name | Select-Object -First 1 de récupérer le nom de l’extension.

  • -UserId spécifie l’ID utilisateur (nom d’utilisateur principal ou UserId).
  • -ExtensionNameValues spécifie un dictionnaire de paires clé-valeur pour la paire nom d’extension et valeur.

Paramètres

-ExtensionName

Spécifie le nom d’une extension.

Propriétés du paramètre

Type:System.String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

SetSingle
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-ExtensionNameValues

Spécifie les valeurs de nom d’extension.

Propriétés du paramètre

Type:

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

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

SetMultiple
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-ExtensionValue

Spécifie une valeur d’extension.

Propriétés du paramètre

Type:System.String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

SetSingle
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-UserId

Spécifie l’identificateur unique de l’utilisateur (nom d’utilisateur principal ou UserId).

Propriétés du paramètre

Type:System.String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Identifiant d'objet (ObjectId), UPN, Identité, Nom Principal de l'Utilisateur

Jeux de paramètres

SetSingle
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False
SetMultiple
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Notes

Update-EntraUserExtension est un alias pour Set-EntraUserExtension.