extensionProperty リソースの種類 (ディレクトリ拡張機能)
名前空間: microsoft.graph
外部データ ストアを必要とせずに、ディレクトリ オブジェクトにカスタム プロパティを追加するために使用できるディレクトリ 拡張機能 を表します。 たとえば、organizationにディレクトリ内の各ユーザーの Skype ID を必要とする基幹業務 (LOB) アプリケーションがある場合、Microsoft Graph を使用して、ディレクトリの User オブジェクトに skypeId という名前の新しいプロパティを登録し、特定のユーザーの新しいプロパティに値を書き込むことができます。 ディレクトリ拡張機能は、テナントで に同意されているマルチテナント アプリでも使用できます。
ディレクトリ拡張機能は、次のディレクトリ オブジェクトに追加できます。
任意の単一のMicrosoft Entra リソースに書き込める拡張値は、すべての種類とすべてのアプリケーションで 100 個のみです。
このリソースと関連するメソッドを使用して、ディレクトリ拡張機能の定義を管理します。 拡張リソース インスタンス上のディレクトリ拡張機能データを管理するには、リソース インスタンスの管理に使用するのと同じ REST 要求を使用します。
Microsoft Graph の拡張機能の詳細については、「 拡張機能を使用してリソースにカスタム プロパティを追加する」を参照してください。
directoryObject から継承します。
注:
Azure AD Graph を介して作成された拡張機能 (現在は廃止サイクル中) と、Microsoft Entra Connect Sync を使用してオンプレミスの Active Directoryから同期されたカスタム データは、Microsoft Graph のディレクトリ拡張機能として表されます。
メソッド
| メソッド | 戻り値の型 | 説明 |
|---|---|---|
| extensionProperties の作成 | extensionProperty | アプリケーション オブジェクトにディレクトリ拡張機能を作成します。 |
| extensionProperties の一覧表示 | extensionProperty コレクション | アプリケーション オブジェクトのディレクトリ拡張機能を一覧表示します。 |
| extensionProperty の取得 | extensionProperty コレクション | アプリケーション オブジェクトのディレクトリ拡張機能を取得します。 |
| extensionProperty の削除 | なし | アプリケーション オブジェクトからディレクトリ拡張機能を削除します。 削除できるのは、オンプレミスの Active Directory から同期されていないディレクトリ拡張機能のみです。 |
| 使用可能な拡張機能を取得する | extensionProperty コレクション | マルチテナント アプリを使用するなど、ディレクトリに登録されているすべてのディレクトリ拡張機能定義を返します。 |
ヒント
- 拡張プロパティの値を targetObjects で指定されたリソースのインスタンスに設定するには、リソースの Update 操作を使用します。 たとえば、ユーザーの値を設定する 更新 ユーザー API です。
- targetObjects で指定されているリソースのインスタンスから拡張プロパティとその値を削除するには、拡張プロパティの値を に
null設定します。
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| appDisplayName | String | この拡張プロパティが定義されているアプリケーション オブジェクトの表示名。 読み取り専用です。 |
| dataType | String | 拡張プロパティが保持できる値のデータ型を指定します。 次の値がサポートされています。
|
| deletedDateTime | DateTimeOffset | このオブジェクトが削除された日時。 オブジェクトが削除されていない場合は常に null。 directoryObject から継承されます。 |
| isSyncedFromOnPremises | ブール型 | この拡張機能プロパティが、Microsoft Entra Connect を使用してオンプレミスの Active Directory から同期されたかどうかを示します。 読み取り専用です。 |
| name | String | 拡張プロパティの名前。 null 許容ではありません。 $filter (eq)をサポートしています。 |
| isMultiValued | ブール型 | ディレクトリ拡張機能を複数値プロパティとして定義します。 の場合 true、ディレクトリ拡張プロパティは dataType のオブジェクトのコレクション (たとえば、 などの "extension_b7b1c57b532f40b8b5ed4b7a7ba67401_jobGroupTracker": ["String 1", "String 2"]文字列型のコレクション) を格納できます。 既定値は false です。 $filter (eq)をサポートしています。 |
| targetObjects | String コレクション | 次の値がサポートされています。 null 許容型ではありません。
|
リレーションシップ
なし
JSON 表記
リソースの JSON 表記を次に示します。
{
"@odata.type": "#microsoft.graph.extensionProperty",
"appDisplayName": "String",
"dataType": "String",
"deletedDateTime": "String (timestamp)",
"id": "String (identifier)",
"isSyncedFromOnPremises": "Boolean",
"isMultiValued": "Boolean",
"name": "String",
"targetObjects": [
"String"
]
}
関連コンテンツ
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示