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-EntraUserExtension は Set-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-EntraUserExtension は Set-EntraUserExtension の別名です。