profileCardProperty 资源类型

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。

表示 Microsoft 365 配置文件卡用户的属性，供组织在共享的人员体验中显示。

属性可以是Microsoft Entra ID内置属性（如 Alias 或 UserPrincipalName），也可以是自定义属性。 对于自定义属性，管理员可以为其组织支持的语言定义 en-us 默认显示名称 String 和一组备用翻译。

有关如何将属性添加到组织的配置文件卡的详细信息，请参阅使用配置文件卡 API 在配置文件卡添加或删除自定义属性。

注意

配置文件卡属性对应于 Microsoft Entra ID 中的属性。 将属性作为 profileCardProperty 添加到组织的 profileCardProperties 集合中将配置文件卡配置为显示属性值。 从集合中删除 profileCardProperty不会从 Microsoft Entra ID 中删除属性;它会删除配置，以便配置文件卡不再显示属性值。

方法

方法	返回类型	说明
列出 profileCardProperties	profileCardProperty 集合	获取组织的 profileCardProperty 资源的集合。
创建 profileCardProperty	profileCardProperty	为组织创建新的 profileCardProperty 。
Get profileCardProperty	profileCardProperty	检索 profileCardProperty 实体的属性。
Update profileCardProperty	profileCardProperty	更新 profileCardProperty 对象的属性，由其 directoryPropertyName 属性标识。
删除 profileCardProperty	无	从组织的配置文件卡中删除由其目录PropertyName 指定的 profileCardProperty 对象，并删除该属性的所有本地化自定义项。

属性

属性	类型	说明
注释	profileCardAnnotation 集合	允许管理员为目录属性设置自定义显示标签，并为租户中的用户本地化该标签。
directoryPropertyName	String	在“获取”、“更新”或“删除”操作中标识 profileCardProperty 资源。 允许管理员在其租户中显示 Microsoft 365 配置文件卡隐藏Microsoft Entra ID属性。 如果存在，则此属性中引用的Microsoft Entra ID字段在配置文件卡的联系人窗格中对租户中的所有用户可见。 此字段允许的值为：UserPrincipalName、、、Fax、StreetAddressPostalCode、CustomAttribute5CustomAttribute3CustomAttribute1CustomAttribute2CustomAttribute4AliasCustomAttribute7CustomAttribute8CustomAttribute9StateOrProvinceCustomAttribute10CustomAttribute6、、CustomAttribute11、CustomAttribute12、 。 CustomAttribute15CustomAttribute13CustomAttribute14

关系

无。

JSON 表示形式

以下 JSON 表示形式显示了资源类型。

{
  "annotations": [{ "@odata.type": "microsoft.graph.profileCardAnnotation" }],
  "directoryPropertyName": "String"
}