Set-EntraUserExtension

Modul:
Microsoft.Entra.Users Module v1.3

Uppdaterar en användares tillägg.

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

Description

Cmdleten Set-EntraUserExtension uppdaterar en användares tillägg i Microsoft Entra ID.

Update-EntraUserExtension är ett alias för Set-EntraUserExtension.

Exempel

Exempel 1: Ange värdet för ett tilläggsattribut för en användare

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

Det här exemplet visar hur du uppdaterar en användares tilläggsattribut för en angiven användare. Använd (Get-EntraApplicationExtensionProperty -ApplicationId '{ApplicationId}').Name | Select-Object -First 1 för att hämta tilläggsnamnet.

  • -UserId parameter anger användar-ID (användarens huvudnamn eller UserId).
  • -ExtensionName parameter anger namnet på ett tillägg.
  • -ExtensionValue parametern anger tilläggsnamnvärdena.

Exempel 2: Uppdatera flera värden med parametern 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

Det här exemplet visar hur du uppdaterar en användares tilläggsattribut. Använd (Get-EntraApplicationExtensionProperty -ApplicationId '{ApplicationId}').Name | Select-Object -First 1 för att hämta tilläggsnamnet.

  • -UserId parameter anger användar-ID (användarens huvudnamn eller UserId).
  • -ExtensionNameValues parameter anger en ordlista med nyckel/värde-par för tilläggets namn och värdepar.

Parametrar

-ExtensionName

Anger namnet på ett tillägg.

Parameteregenskaper

Typ:System.String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SetSingle
Position:Named
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-ExtensionNameValues

Anger namnvärden för tillägg.

Parameteregenskaper

Typ:

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

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SetMultiple
Position:Named
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-ExtensionValue

Anger ett tilläggsvärde.

Parameteregenskaper

Typ:System.String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SetSingle
Position:Named
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-UserId

Anger den unika identifieraren för användaren (användarens huvudnamn eller UserId).

Parameteregenskaper

Typ:System.String
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:Objekt-ID, UPN, Identitet, Användarens huvudnamn

Parameteruppsättningar

SetSingle
Position:Named
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False
SetMultiple
Position:Named
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Kommentarer

Update-EntraUserExtension är ett alias för Set-EntraUserExtension.