microsoft 365 プロファイル カード上のユーザーの属性を表し、共有されたユーザー エクスペリエンスでorganizationを表示します。
属性には、Alias や UserPrincipalName などのMicrosoft Entra ID組み込み属性を指定することも、カスタム属性にすることもできます。 カスタム属性の場合、管理者は既定en-us表示名 String と、organizationでサポートされている言語の代替翻訳のセットを定義できます。
organizationのプロファイル カードにプロパティを追加する方法の詳細については、「プロファイル カード API を使用してプロファイル カードにカスタム属性を追加または削除する」を参照してください。
注:
プロファイル カード プロパティは、Microsoft Entra IDの属性に対応します。 organizationの profileCardProperties コレクションに profileCardProperty として属性を追加すると、属性値を表示するようにプロファイル カードが構成されます。 コレクションから profileCardProperty を削除しても、Microsoft Entra IDから属性は削除されません。プロファイル カードが属性値を表示しなくなったように構成を削除します。
メソッド
| メソッド | 戻り値の型 | 説明 |
|---|---|---|
| List | profileCardProperty コレクション | organizationの profileCardProperty リソースのコレクションを取得します。 |
| Create | profileCardProperty | organizationの新しい profileCardProperty を作成します。 |
| Get | profileCardProperty | profileCardProperty エンティティのプロパティを取得します。 |
| Update | profileCardProperty | directoryPropertyName プロパティによって識別される profileCardProperty オブジェクトのプロパティを更新します。 |
| Delete | なし | organizationのプロファイル カードから directoryPropertyName で指定された profileCardProperty オブジェクトを削除し、そのプロパティのローカライズされたカスタマイズを削除します。 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| 注釈 | profileCardAnnotation コレクション | 管理者がディレクトリ プロパティのカスタム表示ラベルを設定し、テナント内のユーザーにローカライズできるようにします。 |
| directoryPropertyName | 文字列 |
Get、Update、または Delete 操作の profileCardProperty リソースを識別します。 管理者がテナント内の Microsoft 365 プロファイル カードの非表示のMicrosoft Entra IDプロパティを表示できるようにします。 存在する場合、このプロパティで参照されているMicrosoft Entra ID フィールドは、プロファイル カードの連絡先ウィンドウでテナント内のすべてのユーザーに表示されます。 このフィールドに使用できる値は、 UserPrincipalName、 Fax、 StreetAddress、 PostalCode、 StateOrProvince、 Alias、 CustomAttribute1、 CustomAttribute2、 CustomAttribute3、 CustomAttribute4、 CustomAttribute5、 CustomAttribute6、 CustomAttribute7、 CustomAttribute8、 CustomAttribute9、 CustomAttribute10CustomAttribute11、 CustomAttribute12、、 CustomAttribute13CustomAttribute14、 CustomAttribute15です。 |
| Isvisible | ブール型 | 指定されたディレクトリ プロパティをユーザーのプロファイル カードに表示するかどうかを示します。 |
リレーションシップ
なし。
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"annotations": [{ "@odata.type": "microsoft.graph.profileCardAnnotation" }],
"directoryPropertyName": "String",
"isVisible": "Boolean"
}