Set-EntraUserExtension

Hiermee werkt u de extensie van een gebruiker bij.

Syntax

SetSingle (Standaard)

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

De Set-EntraUserExtension cmdlet werkt de extensie van een gebruiker bij in Microsoft Entra ID.

Update-EntraUserExtension is een alias voor Set-EntraUserExtension.

Voorbeelden

Voorbeeld 1: De waarde van een extensiekenmerk voor een gebruiker instellen

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 dit voorbeeld ziet u hoe u het extensiekenmerk van een gebruiker voor een opgegeven gebruiker bijwerkt. Gebruik (Get-EntraApplicationExtensionProperty -ApplicationId '{ApplicationId}').Name | Select-Object -First 1 dit om de extensienaam op te halen.

  • -UserId parameter geeft de gebruikers-id (User Principal Name of UserId).
  • -ExtensionName parameter geeft de naam van een extensie.
  • -ExtensionValue parameter geeft de waarden voor de extensienaam op.

Voorbeeld 2: Meerdere waarden bijwerken met de parameter 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

In dit voorbeeld ziet u hoe u het extensiekenmerk van een gebruiker bijwerkt. Gebruik (Get-EntraApplicationExtensionProperty -ApplicationId '{ApplicationId}').Name | Select-Object -First 1 dit om de extensienaam op te halen.

  • -UserId parameter geeft de gebruikers-id (User Principal Name of UserId).
  • -ExtensionNameValues parameter geeft een woordenlijst van sleutel-waardeparen voor de extensienaam en waardepaar.

Parameters

-ExtensionName

Hiermee geeft u de naam van een extensie.

Parametereigenschappen

Type:System.String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

SetSingle
Position:Named
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-ExtensionNameValues

Hiermee geeft u extensienaamwaarden.

Parametereigenschappen

Type:

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

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

SetMultiple
Position:Named
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-ExtensionValue

Hiermee geeft u een extensiewaarde op.

Parametereigenschappen

Type:System.String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

SetSingle
Position:Named
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-UserId

Hiermee geeft u de unieke id voor de gebruiker (User Principal Name of UserId).

Parametereigenschappen

Type:System.String
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:ObjectId, UPN, Identity, Hoofdgebruikersnaam

Parametersets

SetSingle
Position:Named
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False
SetMultiple
Position:Named
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Notities

Update-EntraUserExtension is een alias voor Set-EntraUserExtension.