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.
-
-UserIdparameter geeft de gebruikers-id (User Principal Name of UserId). -
-ExtensionNameparameter geeft de naam van een extensie. -
-ExtensionValueparameter 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.
-
-UserIdparameter geeft de gebruikers-id (User Principal Name of UserId). -
-ExtensionNameValuesparameter 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.