Set-EntraUserExtension

Modulo:
Microsoft.Entra.Users Module v1.3

Aggiorna l'estensione di un utente.

Sintassi

SetSingle (Impostazione predefinita) 

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

Descrizione

Il Set-EntraUserExtension cmdlet aggiorna l'estensione di un utente in Microsoft Entra ID.

Update-EntraUserExtension è un alias per Set-EntraUserExtension.

Esempio

Esempio 1: Impostare il valore di un attributo di estensione per un utente

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

In questo esempio viene illustrato come aggiornare l'attributo di estensione di un utente per un utente specificato. Usare (Get-EntraApplicationExtensionProperty -ApplicationId '{ApplicationId}').Name | Select-Object -First 1 per recuperare il nome dell'estensione.

  • -UserId parametro specifica l'ID utente (Nome entità utente o UserId).
  • -ExtensionName parametro specifica il nome di un'estensione.
  • -ExtensionValue parametro specifica i valori del nome dell'estensione.

Esempio 2: Aggiornare più valori usando il parametro 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

Questo esempio illustra come aggiornare l'attributo di estensione di un utente. Usare (Get-EntraApplicationExtensionProperty -ApplicationId '{ApplicationId}').Name | Select-Object -First 1 per recuperare il nome dell'estensione.

  • -UserId parametro specifica l'ID utente (Nome entità utente o UserId).
  • -ExtensionNameValues parametro specifica un dizionario di coppie chiave-valore per la coppia nome e valore dell'estensione.

Parametri

-ExtensionName

Specifica il nome di un'estensione.

Proprietà dei parametri

Tipo:System.String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

SetSingle
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-ExtensionNameValues

Specifica i valori del nome dell'estensione.

Proprietà dei parametri

Tipo:

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

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

SetMultiple
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-ExtensionValue

Specifica un valore di estensione.

Proprietà dei parametri

Tipo:System.String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

SetSingle
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-UserId

Specifica l'identificatore univoco per l'utente (Nome entità utente o UserId).

Proprietà dei parametri

Tipo:System.String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:ObjectId, UPN, Identità, NomePrincipaleUtente

Set di parametri

SetSingle
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False
SetMultiple
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Note

Update-EntraUserExtension è un alias per Set-EntraUserExtension.