Compartilhar via

Gerir definições de pronomes para uma organização com o Microsoft API do Graph

  • Artigo

Ao utilizar o Microsoft API do Graph, pode ativar, desativar ou obter definições que gerem pronomes numa organização, como controlar a apresentação na organização de quaisquer utilizadores pronomes que possam ter configurado para si próprios.

Os pronomes, neste contexto, são palavras utilizadas para substituir o nome de uma pessoa numa frase. Os pronomes e as respetivas versões neutras em termos de género existem em muitos idiomas. Por exemplo, em inglês, "ela", "ela, "ele", "ele" e o "eles" neutros em termos de género e "eles" são pronomes comuns. Utilizar corretamente os pronomes de alguém mostra inclusão e respeito. Partilhar pronomes ajuda as pessoas a evitar adivinhar ou fazer suposições com base apenas em nomes ou observações iniciais da pessoa. Num ambiente híbrido, multicultural de trabalho ou escolar, o simples ato de utilizar os pronomes certos pode ajudar a criar confiança e melhorar a comunicação entre si.

Os Administradores Globais ou administradores Pessoas podem ativar ou desativar pronomes para todas as pessoas na organização, utilizando o Centro de administração do Microsoft 365 ou o Microsoft API do Graph. Por predefinição, os pronomes estão desativados.

Ativar pronomes numa organização facilita a associação de utilizadores aos seus pronomes preferidos na organização. Isto inclui as seguintes experiências de utilizador final:

  • Quando os pronomes estão ativados, opcionalmente, um utilizador pode adicionar e gerir pronomes no perfil card no Outlook na Web e no Teams.
  • Os pronomes aparecem pelo nome do utilizador no perfil card no Outlook e no Teams.
  • Os pronomes são apresentados apenas 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 utilizador final com pronomes pode evoluir ao longo do tempo. Para obter informações atuais sobre a experiência do utilizador final com pronomes, consulte Pronomes no Microsoft 365.

Os administradores globais podem decidir se devem apresentar pronomes que os utilizadores configuram nos respetivos cartões de perfil. Para ativar este cenário, defina a propriedade isEnabledInOrganization como true. Quando esta propriedade está definida como true, os pronomes são apresentados para todas as pessoas na organização. Quando esta propriedade está definida como false, os pronomes não são apresentados para ninguém dentro ou fora da organização. A predefinição é false.

Importante

Quando ativa ou desativa os pronomes, pode demorar até sete horas para os utilizadores verem as alterações. Por exemplo, se ativar os pronomes, os utilizadores não poderão ver a opção de adicionar pronomes aos respetivos card de perfil durante um máximo de sete horas. Se desativar os pronomes, os pronomes anteriormente definidos poderão permanecer visíveis no Microsoft 365 (por exemplo, em cartões de perfil) durante um máximo de sete horas.

Quando desativa os pronomes, todos os dados pronomes criados pelos utilizadores são eliminados. O processo de eliminação de dados pode demorar até 30 dias a ser concluído. Se voltar a ativar os pronomes nesse período, quaisquer pronomes ocultos que ainda não tenham sido eliminados dos servidores da Microsoft tornam-se visíveis nas experiências do Microsoft 365, como cartões de perfil.

Configurar definições de pronomes com o PowerShell

Pode utilizar o SDK do PowerShell do Microsoft Graph para configurar as definições de pronomes na sua organização.

Pré-requisitos

Observação

Os comandos do PowerShell para definições de pronomes só estão disponíveis na versão beta. Mude para a experiência beta antes de executar os seguintes comandos.

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

Confirmar as definições atuais

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

Observação

O método get requer PeopleSettings.Read.All permissões. 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

Ativar pronomes na sua organização

Por predefinição, os pronomes estão desativados. Pode utilizar o módulo do PowerShell do Microsoft Graph para disponibilizar pronomes na 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"

Utilize o seguinte comando, especifique -IsEnabledInOrganization como true.

  Update-MgBetaAdminPeoplePronoun -IsEnabledInOrganization:$true

Desativar pronomes na sua organização

Em alternativa, pode tornar os pronomes indisponíveis para a sua organização com o seguinte comando, onde especificar -IsEnabledInOrganization como false.

  Update-MgBetaAdminPeoplePronoun -IsEnabledInOrganization:$false

Configurar definições de pronomes com a API REST do Microsoft Graph

Pode utilizar a API pronounsSettings para configurar as definições de pronomes na sua organização.

Confirmar as definições atuais

Utilize a operação get para devolver as definições atuais dos pronomes na sua organização.

O exemplo seguinte obtém as definições de visualização atuais que têm pronomes desativados.

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

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

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

{
  "isEnabledInOrganization": false
}

Ativar pronomes na sua organização

Utilize a operação de atualização para ativar pronomes na 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 devolve um 200 OK código de resposta e um objeto pronounsSettings no corpo da resposta.

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

{
  "isEnabledInOrganization": true
}

Desativar pronomes na sua organização

Utilize a operação de atualização para tornar os pronomes indisponíveis na 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 devolve um 200 OK código de resposta e um objeto pronounsSettings no corpo da resposta.

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

{
  "isEnabledInOrganization": false
}

Conteúdo relacionado