使用 Microsoft 图形 API管理组织的代词设置

  • 项目

使用 Microsoft 图形 API，可以启用、禁用或获取管理组织中代词的设置，例如控制组织中用户可能为自己设置的任何代词的显示。

在此上下文中，代词是用于替换句子中人员姓名的字词。 代词及其与性别无关的版本存在于多种语言中。 例如，在英语中，“she”、“her”、“he”、“him”以及性别中立的“他们”和“他们”是常见的代词。 正确使用某人的代词表示包容和尊重。 共享代词可帮助人们避免仅仅基于姓名或初步观察结果进行猜测或假设。 在混合的多元文化工作或学校环境中，使用正确的代词的简单行为可以帮助建立信任和改善彼此之间的沟通。

全局管理员可以使用 Microsoft 365 管理中心 或 Microsoft 图形 API为组织中的每个人启用或禁用代词。 默认情况下，将禁用代词。

在组织中启用代词有助于将用户与其组织内的首选代词相关联。 这包括以下最终用户体验：

  • 启用代词后，用户可以选择在 Outlook 网页版 和 Teams 中的配置文件卡添加和管理代词。
  • 在 Outlook 和 Teams 中卡配置文件中，代词由用户名显示。
  • 代词仅在组织内部显示。
  • 组织中拥有帐户（包括来宾帐户）的任何人都可以在个人资料卡上看到代词。

代词的最终用户体验可能会随着时间的推移而发展。 有关代词最终用户体验的最新信息，请参阅 Microsoft 365 中的代词。

全局管理员可以决定是否显示用户在个人资料卡中设置的代词。 若要启用此方案，请将 isEnabledInOrganization 属性设置为 true。 当此属性设置为 true时，为组织中的每个人显示代词。 当此属性设置为 false时，不会为组织内部或外部的任何人显示代词。 默认设置为 false。

重要

打开或关闭代词时，用户可能需要长达 7 小时才能看到更改。 例如，如果启用代词，则用户最多 7 小时看不到在其配置文件卡添加代词的选项。 如果关闭代词，任何以前设置的代词都可能在 Microsoft 365 (中保持可见，例如，在个人资料卡上) 长达 7 小时。

关闭代词后，将删除用户创建的所有代词数据。 数据删除过程可能需要长达 30 天才能完成。 如果在该时间段内重新打开代词，任何尚未从 Microsoft 服务器中删除的隐藏代词将在 Microsoft 365 体验（如个人资料卡）中可见。

使用 PowerShell 配置代词设置

可以使用 Microsoft Graph PowerShell SDK 在组织中配置代词设置。

先决条件

注意

代词设置的 PowerShell 命令仅在 beta 版中可用。 在运行以下命令之前，请切换到 beta 体验。

   Install-Module -Name Microsoft.Graph.Beta -MinimumVersion 2.3.0

确认当前设置

若要获取组织的代词设置配置，请使用以下命令：

注意

get 方法需要 PeopleSettings.Read.All 权限。 若要创建带特定所需范围的 Microsoft Graph 会话，请使用以下命令并同意请求的权限。

   Connect-MgGraph -Scopes "PeopleSettings.Read.All"


  Get-MgBetaAdminPeoplePronoun

在组织中启用代词

默认情况下，将禁用代词。 可以使用 Microsoft Graph PowerShell 模块使代词在组织中可用。

注意

更新方法需要其他 PeopleSettings.ReadWrite.All 权限。 若要创建带特定所需范围的 Microsoft Graph 会话，请使用以下命令并同意请求的权限。

   Connect-MgGraph -Scopes "PeopleSettings.ReadWrite.All","PeopleSettings.Read.All"

使用以下命令，将 指定 -IsEnabledInOrganization 为 true。

  Update-MgBetaAdminPeoplePronoun -IsEnabledInOrganization:$true

在组织中禁用代词

或者，可以使用以下命令（其中将 指定 -IsEnabledInOrganization 为 false）使组织无法使用代词。

  Update-MgBetaAdminPeoplePronoun -IsEnabledInOrganization:$false

使用 Microsoft Graph REST API 配置代词设置

可以使用 pronounsSettings API 在组织中配置代词设置。

确认当前设置

使用 获取 操作可返回组织中代词的当前设置。

以下示例获取禁用了代词的当前显示设置。

GET https://graph.microsoft.com/v1.0/admin/people/pronouns

如果成功，响应将在响应正文中返回 200 OK 响应代码和 pronounsSettings 对象。

HTTP/1.1 200 OK
Content-Type: application/json

{
  "isEnabledInOrganization": false
}

在组织中启用代词

使用 更新 操作在组织中启用代词。

PATCH https://graph.microsoft.com/v1.0/admin/people/pronouns
Content-Type: application/json

{
  "isEnabledInOrganization": true
}

如果成功，响应将在响应正文中返回 200 OK 响应代码和 pronounsSettings 对象。

HTTP/1.1 200 OK
Content-Type: application/json

{
  "isEnabledInOrganization": true
}

在组织中禁用代词

使用更新操作使代词在组织中不可用。

PATCH https://graph.microsoft.com/v1.0/admin/people/pronouns
Content-Type: application/json

{
  "isEnabledInOrganization": false
}

如果成功，响应将在响应正文中返回 200 OK 响应代码和 pronounsSettings 对象。

HTTP/1.1 200 OK
Content-Type: application/json

{
  "isEnabledInOrganization": false
}

相关内容