New-EntraApplicationExtensionProperty
アプリケーション拡張機能プロパティを作成します。
構文
Default (既定)
New-EntraApplicationExtensionProperty
-ApplicationId <String>
[-Name <String>]
[-DataType <String>]
[-TargetObjects <System.Collections.Generic.List`1[System.String]>]
[-IsMultiValued <Boolean>]
[<CommonParameters>]
説明
New-EntraApplicationExtensionProperty コマンドレットは、Microsoft Entra ID内のオブジェクトのアプリケーション拡張プロパティを作成します。
例
例 1: 拡張プロパティを作成する
Connect-Entra -Scopes 'Application.ReadWrite.All','Application.ReadWrite.OwnedBy'
$application = Get-EntraApplication -Filter "DisplayName eq 'Contoso Helpdesk Application'"
New-EntraApplicationExtensionProperty -ApplicationId $application.Id -Name 'NewAttribute'
DeletedDateTime Id AppDisplayName DataType IsSyncedFromOnPremises Name TargetObjects
--------------- -- -------------- -------- ---------------------- ---- -------------
11112222-bbbb-3333-cccc-4444dddd5555 My new test app String False extension_11112222-bbbb-3333-cccc-4444dddd5555_NewAttribute {}
このコマンドは、指定したオブジェクトの文字列型のアプリケーション拡張プロパティを作成します。
-
-ApplicationIdパラメーターは、アプリケーションの一意識別子を指定します。 -
-Nameパラメーターは、拡張プロパティの名前を指定します。
例 2: データ型パラメーターを使用して拡張プロパティを作成する
Connect-Entra -Scopes 'Application.ReadWrite.All','Application.ReadWrite.OwnedBy'
$application = Get-EntraApplication -Filter "DisplayName eq 'Contoso Helpdesk Application'"
New-EntraApplicationExtensionProperty -ApplicationId $application.Id -Name 'NewAttribute1' -DataType 'Boolean'
DeletedDateTime Id AppDisplayName DataType IsSyncedFromOnPremises Name TargetObjects
--------------- -- -------------- -------- ---------------------- ---- -------------
11112222-bbbb-3333-cccc-4444dddd5555 My new test app Boolean False extension_11112222-bbbb-3333-cccc-4444dddd5555_NewAttribute {}
このコマンドは、指定したオブジェクトの指定したデータ型のアプリケーション拡張プロパティを作成します。
-
-ApplicationIdパラメーターは、アプリケーションの一意識別子を指定します。 -
-Nameパラメーターは、拡張プロパティの名前を指定します。 -
-DataTypeパラメーターは、拡張プロパティが保持できる値のデータ型を指定します。
例 3: targets パラメーターを使用して拡張プロパティを作成する
Connect-Entra -Scopes 'Application.ReadWrite.All','Application.ReadWrite.OwnedBy'
$application = Get-EntraApplication -Filter "DisplayName eq 'Contoso Helpdesk Application'"
$targets = New-Object System.Collections.Generic.List[System.String]
$targets.Add('User')
New-EntraApplicationExtensionProperty -ApplicationId $application.Id -Name 'NewAttribute2' -TargetObjects $targets
DeletedDateTime Id AppDisplayName DataType IsSyncedFromOnPremises Name TargetObjects
--------------- -- -------------- -------- ---------------------- ---- -------------
11112222-bbbb-3333-cccc-4444dddd5555 My new test app String False extension_11112222-bbbb-3333-cccc-4444dddd5555_NewAttribute {User}
この例では、指定したオブジェクトの指定したターゲット オブジェクトを使用してアプリケーション拡張プロパティを作成する方法を示します。
-
-ApplicationIdパラメーターは、アプリケーションの一意識別子を指定します。 -
-Nameパラメーターは、拡張プロパティの名前を指定します。 -
-TargetObjectsパラメーターは、拡張プロパティを使用するMicrosoft Graphリソースを指定します。 すべての値は PascalCase に存在する必要があります。
パラメーター
-ApplicationId
Microsoft Entra ID内のアプリケーションの一意の ID を指定します。
パラメーターのプロパティ
| 型: | System.String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | オブジェクト識別子 |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-DataType
拡張プロパティが保持できる値のデータ型を指定します。 次の値がサポートされています。
- バイナリ - 最大 256 バイト
- ブール値
- DateTime - ISO 8601 形式で指定する必要があります。 UTC で格納されます。
- 整数 - 32 ビット値。
- LargeInteger - 64 ビット値。
- 文字列 - 最大 256 文字
パラメーターのプロパティ
| 型: | System.String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-IsMultiValued
拡張プロパティが複数の値をサポートするかどうかを指定します。 拡張プロパティが複数の値を保持できる場合は、このパラメーターを$trueに設定します。それ以外の場合は、$falseに設定します。
パラメーターのプロパティ
| 型: | System.Boolean |
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Name
拡張プロパティの名前を指定します。
パラメーターのプロパティ
| 型: | System.String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-TargetObjects
拡張プロパティを使用できるMicrosoft Graph リソースを指定します。 すべての値は PascalCase に存在する必要があります。 次の値がサポートされています。
- User
- グループ
- アドミニストレーションユニット
- Application
- デバイス
- Organization
パラメーターのプロパティ
| 型: | System.Collections.Generic.List`1[System.String] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。