Set-EntraUserExtension

Set-EntraUserExtension

    -UserId <String>
    -ExtensionName <String>
    -ExtensionValue <String>
    [<CommonParameters>]

Set-EntraUserExtension

    -UserId <String>
    -ExtensionNameValues <System.Collections.Generic.Dictionary`2[System.String,System.String]>
    [<CommonParameters>]

該 Set-EntraUserExtension cmdlet 會更新使用者在 Microsoft Entra ID 中的擴充功能。

Update-EntraUserExtension 是 Set-EntraUserExtension 的別名。

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

此範例示範如何更新特定使用者的擴充屬性。 用 (Get-EntraApplicationExtensionProperty -ApplicationId '{ApplicationId}').Name | Select-Object -First 1 來取得擴充功能名稱。

• -UserId 參數指定使用者 ID（使用者主體名稱或 UserID）。
• -ExtensionName 參數指定擴充名稱。
• -ExtensionValue 參數指定擴充名稱的值。

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

此範例示範如何更新使用者的擴充屬性。 用 (Get-EntraApplicationExtensionProperty -ApplicationId '{ApplicationId}').Name | Select-Object -First 1 來取得擴充功能名稱。

• -UserId 參數指定使用者 ID（使用者主體名稱或 UserID）。
• -ExtensionNameValues 參數指定擴充名稱與值對的鍵值對字典。

此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。

Update-EntraUserExtension 是 Set-EntraUserExtension 的別名。