Gérer les paramètres de pronoms d’un organization à l’aide de Microsoft API Graph

  • Article

À l’aide de microsoft API Graph, vous pouvez activer, désactiver ou obtenir des paramètres qui gèrent les pronoms dans un organization, comme le contrôle de l’affichage dans le organization de tous les pronoms que les utilisateurs peuvent avoir configurés pour eux-mêmes.

Dans ce contexte, les pronoms sont des mots utilisés pour remplacer le nom d’une personne dans une phrase. Les pronoms et leurs versions non sexistes existent dans de nombreuses langues. Par exemple, en anglais, « she », « her », « he », « him » et les « they » et « them » neutres du genre sont des pronoms communs. L’utilisation correcte des pronoms d’une personne montre l’inclusion et le respect. Le partage de pronoms permet aux gens d’éviter de deviner ou de faire des hypothèses basées uniquement sur le nom ou les observations initiales de la personne. Dans un environnement professionnel ou scolaire hybride et multiculturel, le simple fait d’utiliser les bons pronoms peut aider à instaurer la confiance et à améliorer la communication entre les uns et les autres.

Les administrateurs généraux peuvent activer ou désactiver les pronoms pour tous les organization, à l’aide du Centre d'administration Microsoft 365 ou de Microsoft API Graph. Par défaut, les pronoms sont désactivés.

L’activation des pronoms dans un organization facilite l’association des utilisateurs à leurs pronoms préférés dans le organization. Cela inclut les expériences des utilisateurs finaux suivantes :

  • Lorsque les pronoms sont activés, un utilisateur peut éventuellement ajouter et gérer des pronoms dans le profil carte dans Outlook sur le web et Teams.
  • Les pronoms apparaissent par le nom de l’utilisateur sur le profil carte dans Outlook et Teams.
  • Les pronoms sont affichés uniquement en interne dans le organization.
  • Toute personne disposant d’un compte dans le organization, y compris les comptes invités, peut voir les pronoms sur les cartes de profil.

L’expérience de l’utilisateur final avec les pronoms peut évoluer au fil du temps. Pour plus d’informations sur l’expérience de l’utilisateur final avec les pronoms, consultez Pronoms dans Microsoft 365.

Les administrateurs généraux peuvent décider s’il faut afficher les pronoms que les utilisateurs configurent dans leurs cartes de profil. Pour activer ce scénario, vous définissez la propriété isEnabledInOrganization sur true. Lorsque cette propriété a la valeur true, les pronoms s’affichent pour tous les membres du organization. Lorsque cette propriété a la falsevaleur , les pronoms ne sont pas affichés pour les personnes à l’intérieur ou à l’extérieur du organization. Le paramètre par défaut est false.

Importante

Lorsque vous activez ou désactivez les pronoms, les utilisateurs peuvent prendre jusqu’à sept heures pour voir les modifications. Par exemple, si vous activez les pronoms, les utilisateurs ne peuvent pas voir l’option permettant d’ajouter des pronoms à leur profil carte pendant sept heures maximum. Si vous désactivez les pronoms, tous les pronoms précédemment définis peuvent rester visibles dans Microsoft 365 (par exemple, sur les cartes de profil) pendant sept heures maximum.

Lorsque vous désactivez les pronoms, toutes les données de pronoms créées par les utilisateurs sont supprimées. Le processus de suppression des données peut prendre jusqu’à 30 jours. Si vous réactivez les pronoms au cours de cette période, tous les pronoms masqués qui n’ont pas encore été supprimés des serveurs Microsoft deviennent visibles dans les expériences Microsoft 365, telles que les cartes de profil.

Configurer les paramètres des pronoms à l’aide de PowerShell

Vous pouvez utiliser le Kit de développement logiciel (SDK) Microsoft Graph PowerShell pour configurer les paramètres de pronoms dans votre organization.

Configuration requise

Remarque

Les commandes PowerShell pour les paramètres de pronoms sont disponibles uniquement dans la version bêta. Basculez vers l’expérience bêta avant d’exécuter les commandes suivantes.

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

Confirmer vos paramètres actuels

Pour obtenir la configuration des paramètres de pronom pour un organization, utilisez la commande suivante :

Remarque

La méthode get nécessite PeopleSettings.Read.All des autorisations. Pour créer une session Microsoft Graph avec une étendue requise spécifique, utilisez la commande et l’autorisation suivantes pour demander des autorisations.

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


  Get-MgBetaAdminPeoplePronoun

Activer les pronoms dans votre organization

Par défaut, les pronoms sont désactivés. Vous pouvez utiliser le module Microsoft Graph PowerShell pour rendre les pronoms disponibles dans votre organization.

Remarque

La méthode de mise à jour nécessite des autorisations PeopleSettings.ReadWrite.All supplémentaires. Pour créer une session Microsoft Graph avec une étendue requise spécifique, utilisez la commande et l’autorisation suivantes pour demander des autorisations.

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

Utilisez la commande suivante, spécifiez -IsEnabledInOrganization comme true.

  Update-MgBetaAdminPeoplePronoun -IsEnabledInOrganization:$true

Désactiver les pronoms dans votre organization

Vous pouvez également rendre les pronoms indisponibles pour votre organization à l’aide de la commande suivante, où vous spécifiez -IsEnabledInOrganization comme false.

  Update-MgBetaAdminPeoplePronoun -IsEnabledInOrganization:$false

Configurer les paramètres de pronoms à l’aide de l’API REST Microsoft Graph

Vous pouvez utiliser l’API pronomsSettings pour configurer les paramètres des pronoms dans votre organization.

Confirmer vos paramètres actuels

Utilisez l’opération get pour retourner les paramètres actuels des pronoms dans votre organization.

L’exemple suivant obtient les paramètres d’affichage actuels dont les pronoms sont désactivés.

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

Si elle réussit, la réponse renvoie un 200 OK code de réponse et un objet pronomnsSettings dans le corps de la réponse.

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

{
  "isEnabledInOrganization": false
}

Activer les pronoms dans votre organization

Utilisez l’opération de mise à jour pour activer les pronoms dans votre organization.

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

{
  "isEnabledInOrganization": true
}

Si elle réussit, la réponse renvoie un 200 OK code de réponse et un objet pronomnsSettings dans le corps de la réponse.

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

{
  "isEnabledInOrganization": true
}

Désactiver les pronoms dans votre organization

Utilisez l’opération de mise à jour pour rendre les pronoms indisponibles dans votre organization.

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

{
  "isEnabledInOrganization": false
}

Si elle réussit, la réponse renvoie un 200 OK code de réponse et un objet pronomnsSettings dans le corps de la réponse.

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

{
  "isEnabledInOrganization": false
}

Contenu connexe