Управление параметрами местоимений для организации с помощью microsoft API Graph

  • Статья

С помощью microsoft API Graph можно включить, отключить или получить параметры, управляющие местоимениями в организации, например управлять отображением в организации любых местоимений, которые пользователи могли настроить для себя.

Местоимения в этом контексте — это слова, используемые для замены имени человека в предложении. Местоимения и их гендерно-нейтральные версии существуют на многих языках. Например, в английском языке "она", "ее", "он", "он" и гендерно-нейтральные "они" и "они" являются общими местоимениями. Правильное использование чьих-то местоимений показывает инклюзивность и уважение. Совместное использование местоимений помогает людям не угадывать или делать предположения, основанные исключительно на именах или первоначальных наблюдениях за человеком. В гибридной, мультикультурной рабочей или учебной среде простое использование правильных местоимений может помочь построить доверие и улучшить общение между собой.

Глобальные администраторы могут включать или отключать местоимения для всех пользователей в организации с помощью Центр администрирования Microsoft 365 или microsoft API Graph. По умолчанию местоимения отключены.

Включение местоимений в организации упрощает связывание пользователей с их предпочтительными местоимениями в организации. Сюда входят следующие возможности для конечных пользователей:

  • Если местоимения включены, пользователь может при необходимости добавлять местоимения и управлять ими в карта профиля в Outlook в Интернете и Teams.
  • Местоимения отображаются по имени пользователя в профиле карта в Outlook и Teams.
  • Местоимения отображаются только внутри организации.
  • Любой пользователь, имеющий учетную запись в организации, включая гостевые учетные записи, может видеть местоимения на карточках профиля.

Взаимодействие конечных пользователей с местоимениями может со временем развиваться. Текущие сведения о взаимодействии пользователей с местоимениями см. в статье Местоимения в Microsoft 365.

Глобальные администраторы могут решить, следует ли отображать местоимения, настроенные пользователями в карточках профиля. Чтобы включить этот сценарий, присвойте свойству isEnabledInOrganization значение true. Если для этого свойства задано значение true, местоимения отображаются для всех пользователей в организации. Если для этого свойства задано значение false, местоимения не отображаются ни для кого в организации или за ее пределами. По умолчанию используется falseпараметр .

Важно!

Включение или отключение местоимений может занять до семи часов, чтобы пользователи могли увидеть изменения. Например, если включить местоимения, пользователи не смогут добавлять местоимения в карта профиля в течение семи часов. Если вы отключите местоимения, все ранее заданные местоимения могут оставаться видимыми в Microsoft 365 (например, на карточках профиля) в течение семи часов.

При отключении местоимений все данные местоимений, созданные пользователями, удаляются. Процесс удаления данных может занять до 30 дней. Если снова включить местоимения в течение этого периода, все скрытые местоимения, которые еще не были удалены с серверов Майкрософт, станут видимыми в интерфейсах Microsoft 365, таких как карточки профиля.

Настройка параметров местоимений с помощью PowerShell

Вы можете использовать пакет SDK Для Microsoft Graph PowerShell для настройки параметров местоимений в организации.

Предварительные требования

Примечание.

Команды PowerShell для параметров местоимений доступны только в бета-версии. Перед выполнением следующих команд переключитесь на бета-версию.

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

Подтверждение текущих параметров

Чтобы получить конфигурацию параметров местоимения для организации, используйте следующую команду:

Примечание.

Для метода get требуются PeopleSettings.Read.All разрешения. Чтобы создать сеанс Microsoft Graph с определенной обязательной областью, используйте следующую команду и предоставьте запрошенные разрешения.

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


  Get-MgBetaAdminPeoplePronoun

Включение местоимений в организации

По умолчанию местоимения отключены. Вы можете использовать модуль PowerShell Microsoft Graph, чтобы сделать местоимения доступными в вашей организации.

Примечание.

Для метода обновления требуются дополнительные разрешения 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

Настройка параметров местоимений с помощью REST API Microsoft Graph

Api местоименийSettings можно использовать для настройки параметров местоимений в организации.

Подтверждение текущих параметров

Используйте операцию get , чтобы вернуть текущие параметры для местоимений в организации.

В следующем примере возвращаются текущие параметры отображения с отключенными местоимениями.

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

В случае успешного выполнения ответ возвращает код отклика 200 OK и объект местоименияSettings в теле отклика.

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 и объект местоименияSettings в теле отклика.

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 и объект местоименияSettings в теле отклика.

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

{
  "isEnabledInOrganization": false
}

Связанные материалы