Compartir a través de

Administrar la configuración de pronombres de una organización mediante Microsoft Graph API

  • Artículo

Con microsoft Graph API, puede habilitar, deshabilitar u obtener configuraciones que administren pronombres en una organización, como controlar la presentación dentro de la organización de los pronombres que los usuarios podrían haber configurado para sí mismos.

Los pronombres, en este contexto, son palabras que se usan para reemplazar el nombre de una persona en una oración. Los pronombres y sus versiones de género neutro existen en muchos idiomas. Por ejemplo, en inglés, "ella", "ella", "él", "él", y los "ellos" neutros de género y "ellos" son pronombres comunes. El uso correcto de los pronombres de alguien muestra inclusión y respeto. Compartir pronombres ayuda a las personas a evitar adivinar o hacer suposiciones basadas únicamente en nombres o observaciones iniciales de la persona. En un entorno de trabajo o escuela híbrido y multicultural, el simple acto de usar los pronombres adecuados puede ayudar a generar confianza y mejorar la comunicación entre sí.

Los administradores globales pueden habilitar o deshabilitar pronombres para todos los usuarios de la organización mediante el Centro de administración de Microsoft 365 o Microsoft Graph API. De forma predeterminada, los pronombres están deshabilitados.

La habilitación de pronombres en una organización facilita la asociación de usuarios con sus pronombres preferidos dentro de la organización. Esto incluye las siguientes experiencias de usuario final:

  • Cuando los pronombres están habilitados, un usuario puede agregar y administrar pronombres opcionalmente en la tarjeta de perfil de Outlook en la Web y Teams.
  • Los pronombres aparecen por el nombre del usuario en la tarjeta de perfil en Outlook y Teams.
  • Los pronombres solo se muestran internamente dentro de la organización.
  • Cualquier persona que tenga una cuenta en la organización, incluidas las cuentas de invitado, puede ver pronombres en las tarjetas de perfil.

La experiencia del usuario final con pronombres podría evolucionar con el tiempo. Para obtener información actual sobre la experiencia del usuario final con pronombres, consulte Pronouns en Microsoft 365.

Los administradores globales pueden decidir si se muestran los pronombres que los usuarios configuran en sus tarjetas de perfil. Para habilitar este escenario, establezca la propiedad trueisEnabledInOrganization en . Cuando esta propiedad se establece en true, los pronombres se muestran para todos los usuarios de la organización. Cuando esta propiedad se establece en false, los pronombres no se muestran para nadie dentro o fuera de la organización. La configuración predeterminada es false.

Importante

Al activar o desactivar los pronombres, los usuarios pueden tardar hasta siete horas en ver los cambios. Por ejemplo, si activa pronombres, los usuarios no podrán ver la opción de agregar pronombres en su tarjeta de perfil durante un máximo de siete horas. Si desactiva los pronombres, los pronombres establecidos anteriormente podrían permanecer visibles en Microsoft 365 (por ejemplo, en tarjetas de perfil) durante un máximo de siete horas.

Al desactivar los pronombres, se eliminan todos los datos de pronombre creados por los usuarios. El proceso de eliminación de datos puede tardar hasta 30 días en completarse. Si vuelve a activar los pronombres en ese período, los pronombres ocultos que aún no se hayan eliminado de los servidores de Microsoft se vuelven visibles en las experiencias de Microsoft 365, como las tarjetas de perfil.

Configuración de pronombres mediante PowerShell

Puede usar el SDK de PowerShell de Microsoft Graph para configurar los pronombres en su organización.

Requisitos previos

Nota:

Los comandos de PowerShell para la configuración de pronombres solo están disponibles en versión beta. Cambie a la experiencia beta antes de ejecutar los siguientes comandos.

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

Confirmación de la configuración actual

Para obtener la configuración de configuración del pronombre de una organización, use el siguiente comando:

Nota:

El método get requiere PeopleSettings.Read.All permisos. Para crear una sesión de Microsoft Graph con un alcance requerido específico, use el siguiente comando y acepte los permisos solicitados.

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


  Get-MgBetaAdminPeoplePronoun

Habilitación de pronombres en la organización

De forma predeterminada, los pronombres están deshabilitados. Puede usar el módulo de PowerShell de Microsoft Graph para que los pronombres estén disponibles en su organización.

Nota:

El método de actualización requiere de permisos PeopleSettings.ReadWrite.All adicionales. Para crear una sesión de Microsoft Graph con un alcance requerido específico, use el siguiente comando y acepte los permisos solicitados.

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

Use el comando siguiente y especifique -IsEnabledInOrganization como true.

  Update-MgBetaAdminPeoplePronoun -IsEnabledInOrganization:$true

Deshabilitación de pronombres en la organización

Como alternativa, puede hacer que los pronombres no estén disponibles para su organización mediante el siguiente comando, donde se especifica -IsEnabledInOrganization como false.

  Update-MgBetaAdminPeoplePronoun -IsEnabledInOrganization:$false

Configuración de pronombres mediante la API REST de Microsoft Graph

Puede usar la API pronounsSettings para configurar los pronombres en su organización.

Confirmación de la configuración actual

Use la operación get para devolver la configuración actual de los pronombres de su organización.

En el ejemplo siguiente se obtiene la configuración de visualización actual que tiene los pronombres deshabilitados.

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

Si se ejecuta correctamente, la respuesta devuelve un 200 OK código de respuesta y un objeto pronounsSettings en el cuerpo de la respuesta.

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

{
  "isEnabledInOrganization": false
}

Habilitación de pronombres en la organización

Use la operación de actualización para habilitar pronombres en su organización.

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

{
  "isEnabledInOrganization": true
}

Si se ejecuta correctamente, la respuesta devuelve un 200 OK código de respuesta y un objeto pronounsSettings en el cuerpo de la respuesta.

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

{
  "isEnabledInOrganization": true
}

Deshabilitación de pronombres en la organización

Use la operación de actualización para que los pronombres no estén disponibles en su organización.

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

{
  "isEnabledInOrganization": false
}

Si se ejecuta correctamente, la respuesta devuelve un 200 OK código de respuesta y un objeto pronounsSettings en el cuerpo de la respuesta.

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

{
  "isEnabledInOrganization": false
}

Contenido relacionado