Set-EntraUserExtension

Modul:
Microsoft.Entra.Users Module v1.3

Aktualisiert die Erweiterung eines Benutzers.

Syntax

SetSingle (Standard) 

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

Beschreibung

Das Set-EntraUserExtension Cmdlet aktualisiert die Erweiterung eines Benutzers in Microsoft Entra ID.

Update-EntraUserExtension ist ein Alias für Set-EntraUserExtension.

Beispiele

Beispiel 1: Festlegen des Werts eines Erweiterungsattributs für einen Benutzer

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 diesem Beispiel wird veranschaulicht, wie das Erweiterungsattribut eines Benutzers für einen bestimmten Benutzer aktualisiert wird. Dient (Get-EntraApplicationExtensionProperty -ApplicationId '{ApplicationId}').Name | Select-Object -First 1 zum Abrufen des Erweiterungsnamens.

  • -UserId der Parameter gibt die Benutzer-ID an (Benutzerprinzipalname oder UserId).
  • -ExtensionName der Parameter gibt den Namen einer Erweiterung an.
  • -ExtensionValue der Parameter gibt die Werte für den Erweiterungsnamen an.

Beispiel 2: Aktualisieren mehrerer Werte mithilfe des ExtensionNameValues-Parameters

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

In diesem Beispiel wird veranschaulicht, wie das Erweiterungsattribut eines Benutzers aktualisiert wird. Dient (Get-EntraApplicationExtensionProperty -ApplicationId '{ApplicationId}').Name | Select-Object -First 1 zum Abrufen des Erweiterungsnamens.

  • -UserId der Parameter gibt die Benutzer-ID an (Benutzerprinzipalname oder UserId).
  • -ExtensionNameValues der Parameter gibt ein Wörterbuch mit Schlüsselwertpaaren für den Erweiterungsnamen und das Wertpaar an.

Parameter

-ExtensionName

Gibt den Namen einer Erweiterung an.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

SetSingle
Position:Named
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-ExtensionNameValues

Gibt Erweiterungsnamenwerte an.

Parametereigenschaften

Typ:

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

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

SetMultiple
Position:Named
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-ExtensionValue

Gibt einen Erweiterungswert an.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

SetSingle
Position:Named
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-UserId

Gibt den eindeutigen Bezeichner für den Benutzer an (Benutzerprinzipalname oder Benutzer-ID).

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Objekt-ID, UPN (Benutzerprinzipalname), Identity, Benutzerhauptname

Parametersätze

SetSingle
Position:Named
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False
SetMultiple
Position:Named
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Hinweise

Update-EntraUserExtension ist ein Alias für Set-EntraUserExtension.