Set-EntraUserExtension

Moduł:
Microsoft.Entra.Users Module v1.3

Aktualizuje rozszerzenie użytkownika.

Składnia

SetSingle (domyślnie) 

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

Opis

Polecenie Set-EntraUserExtension cmdlet aktualizuje rozszerzenie użytkownika w Microsoft Entra ID.

Update-EntraUserExtension to alias dla elementu Set-EntraUserExtension.

Przykłady

Przykład 1: Ustawianie wartości atrybutu rozszerzenia dla użytkownika

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

W tym przykładzie pokazano, jak zaktualizować atrybut rozszerzenia użytkownika dla określonego użytkownika. Użyj (Get-EntraApplicationExtensionProperty -ApplicationId '{ApplicationId}').Name | Select-Object -First 1 polecenia , aby pobrać nazwę rozszerzenia.

  • -UserId parametr określa identyfikator użytkownika (główna nazwa użytkownika lub identyfikator użytkownika).
  • -ExtensionName parametr określa nazwę rozszerzenia.
  • -ExtensionValue parametr określa wartości nazwy rozszerzenia.

Przykład 2. Aktualizowanie wielu wartości przy użyciu parametru 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

W tym przykładzie pokazano, jak zaktualizować atrybut rozszerzenia użytkownika. Użyj (Get-EntraApplicationExtensionProperty -ApplicationId '{ApplicationId}').Name | Select-Object -First 1 polecenia , aby pobrać nazwę rozszerzenia.

  • -UserId parametr określa identyfikator użytkownika (główna nazwa użytkownika lub identyfikator użytkownika).
  • -ExtensionNameValues parametr określa słownik par klucz-wartość dla pary nazwy i wartości rozszerzenia.

Parametry

-ExtensionName

Określa nazwę rozszerzenia.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

SetSingle
Position:Named
Obowiązkowe:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-ExtensionNameValues

Określa wartości nazw rozszerzeń.

Właściwości parametru

Typ:

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

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

SetMultiple
Position:Named
Obowiązkowe:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-ExtensionValue

Określa wartość rozszerzenia.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

SetSingle
Position:Named
Obowiązkowe:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-UserId

Określa unikatowy identyfikator użytkownika (główna nazwa użytkownika lub identyfikator użytkownika).

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Identyfikator Obiektu, nazwa UPN, Identity, NazwaGłównaUżytkownika

Zestawy parametrów

SetSingle
Position:Named
Obowiązkowe:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False
SetMultiple
Position:Named
Obowiązkowe:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Notatki

Update-EntraUserExtension to alias dla elementu Set-EntraUserExtension.