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を参照してください。