Set-EntraUserExtension

ユーザーの拡張機能を更新します。

構文

SetSingle (既定)

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

説明

Set-EntraUserExtension コマンドレットは、Microsoft Entra IDでユーザーの拡張機能を更新します。

Update-EntraUserExtensionSet-EntraUserExtension の別名です。

例 1: ユーザーの拡張属性の値を設定する

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 パラメーターは拡張名の値を指定します。

例 2: 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

この例では、ユーザーの拡張機能属性を更新する方法を示します。 (Get-EntraApplicationExtensionProperty -ApplicationId '{ApplicationId}').Name | Select-Object -First 1を使用して拡張機能名を取得します。

  • -UserId パラメーターは、ユーザー ID (ユーザー プリンシパル名または UserId) を指定します。
  • -ExtensionNameValues パラメーターは、拡張名と値のペアのキーと値のペアのディクショナリを指定します。

パラメーター

-ExtensionName

拡張機能の名前を指定します。

パラメーターのプロパティ

型:System.String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

SetSingle
配置:Named
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-ExtensionNameValues

拡張名の値を指定します。

パラメーターのプロパティ

型:

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

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

SetMultiple
配置:Named
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-ExtensionValue

拡張値を指定します。

パラメーターのプロパティ

型:System.String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

SetSingle
配置:Named
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-UserId

ユーザーの一意識別子 (ユーザー プリンシパル名または UserId) を指定します。

パラメーターのプロパティ

型:System.String
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:オブジェクト識別子, UPN, アイデンティティ, ユーザープリンシパルネーム

パラメーター セット

SetSingle
配置:Named
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
SetMultiple
配置:Named
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

CommonParameters

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

メモ

Update-EntraUserExtensionSet-EntraUserExtension の別名です。