Gerenciar configurações de pronomes para uma organização usando o Microsoft API do Graph

  • Artigo

Usando o microsoft API do Graph, você pode habilitar, desabilitar ou obter configurações que gerenciam pronomes em uma organização, como controlar a exibição dentro da organização de quaisquer pronomes que os usuários possam ter configurado para si mesmos.

Os pronomes, neste contexto, são palavras usadas para substituir o nome de uma pessoa em uma frase. Pronomes e suas versões neutras de gênero existem em muitos idiomas. Por exemplo, em inglês, "ela", "ela, "ele", "ele" e o gênero neutro "eles" e "eles" são pronomes comuns. Usar corretamente os pronomes de alguém mostra inclusão e respeito. O compartilhamento de pronomes ajuda as pessoas a evitar adivinhar ou fazer suposições baseadas apenas em nomes ou observações iniciais da pessoa. Em um ambiente híbrido, multicultural ou escolar, o simples ato de usar os pronomes certos pode ajudar a criar confiança e melhorar a comunicação entre si.

Os administradores globais podem habilitar ou desabilitar pronomes para todos na organização, usando o Centro de administração do Microsoft 365 ou o Microsoft API do Graph. Por padrão, os pronomes são desabilitados.

Habilitar pronomes em uma organização facilita a associação de usuários com seus pronomes preferidos dentro da organização. Isso inclui as seguintes experiências de usuário final:

  • Quando os pronomes são habilitados, um usuário pode, opcionalmente, adicionar e gerenciar pronomes no perfil cartão em Outlook na Web e Teams.
  • Os pronomes aparecem pelo nome do usuário no perfil cartão no Outlook e no Teams.
  • Os pronomes são exibidos somente internamente na organização.
  • Qualquer pessoa que tenha uma conta na organização, incluindo contas de convidado, pode ver pronomes em cartões de perfil.

A experiência do usuário final com pronomes pode evoluir ao longo do tempo. Para obter informações atuais sobre a experiência do usuário final com pronomes, consulte Pronomes no Microsoft 365.

Os administradores globais podem decidir se exibem pronomes que os usuários configuram em seus cartões de perfil. Para habilitar esse cenário, defina a propriedade isEnabledInOrganization como true. Quando essa propriedade é definida como true, os pronomes são exibidos para todos dentro da organização. Quando essa propriedade é definida como false, os pronomes não são exibidos para ninguém dentro ou fora da organização. A configuração padrão é false.

Importante

Quando você ativa ou desativa pronomes, pode levar até sete horas para os usuários verem as alterações. Por exemplo, se você ativar pronomes, os usuários não poderão ver a opção de adicionar pronomes em seu perfil cartão por até sete horas. Se você desativar os pronomes, todos os pronomes definidos anteriormente poderão permanecer visíveis no Microsoft 365 (por exemplo, em cartões de perfil) por até sete horas.

Quando você desativa pronomes, todos os dados de pronomes criados pelos usuários são excluídos. O processo de exclusão de dados pode levar até 30 dias para ser concluído. Se você ativar os pronomes nesse período, todos os pronomes ocultos que ainda não foram excluídos dos servidores da Microsoft ficarão visíveis em experiências do Microsoft 365, como cartões de perfil.

Configurar configurações de pronomes usando o PowerShell

Você pode usar o SDK do Microsoft Graph PowerShell para configurar as configurações de pronomes em sua organização.

Pré-requisitos

Observação

Os comandos do PowerShell para configurações de pronomes só estão disponíveis em beta. Alterne para a experiência beta antes de executar os comandos a seguir.

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

Confirmar suas configurações atuais

Para obter a configuração de configurações de pronome para uma organização, use o seguinte comando:

Observação

O método get requer permissões PeopleSettings.Read.All . Para criar uma sessão do Microsoft Graph com um escopo específico necessário, use o seguinte comando e concorde com as permissões solicitadas.

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


  Get-MgBetaAdminPeoplePronoun

Habilitar pronomes em sua organização

Por padrão, os pronomes são desabilitados. Você pode usar o módulo do Microsoft Graph PowerShell para disponibilizar pronomes em sua organização.

Observação

O método de atualização requer permissões PeopleSettings.ReadWrite.All adicionais. Para criar uma sessão do Microsoft Graph com um escopo específico necessário, use o seguinte comando e concorde com as permissões solicitadas.

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

Use o comando a seguir, especifique -IsEnabledInOrganization como true.

  Update-MgBetaAdminPeoplePronoun -IsEnabledInOrganization:$true

Desabilitar pronomes em sua organização

Como alternativa, você pode tornar os pronomes indisponíveis para sua organização usando o comando a seguir, no qual você especifica -IsEnabledInOrganization como false.

  Update-MgBetaAdminPeoplePronoun -IsEnabledInOrganization:$false

Configurar configurações de pronomes usando a API REST do Microsoft Graph

Você pode usar a API pronomesSettings para configurar as configurações de pronomes em sua organização.

Confirmar suas configurações atuais

Use a operação get para retornar as configurações atuais para pronomes em sua organização.

O exemplo a seguir obtém as configurações de exibição atuais que têm pronomes desabilitados.

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

Se for bem-sucedida, a resposta retornará um 200 OK código de resposta e um objeto pronomesSettings no corpo da resposta.

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

{
  "isEnabledInOrganization": false
}

Habilitar pronomes em sua organização

Use a operação de atualização para habilitar pronomes em sua organização.

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

{
  "isEnabledInOrganization": true
}

Se for bem-sucedida, a resposta retornará um 200 OK código de resposta e um objeto pronomesSettings no corpo da resposta.

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

{
  "isEnabledInOrganization": true
}

Desabilitar pronomes em sua organização

Use a operação de atualização para tornar os pronomes indisponíveis em sua organização.

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

{
  "isEnabledInOrganization": false
}

Se for bem-sucedida, a resposta retornará um 200 OK código de resposta e um objeto pronomesSettings no corpo da resposta.

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

{
  "isEnabledInOrganization": false
}

Conteúdo relacionado