Verwalten von Pronomeneinstellungen für ein organization mithilfe des Microsoft-Graph-API

  • Artikel

Mithilfe der Microsoft Graph-API können Sie Einstellungen zum Verwalten von Pronomen in einem organization aktivieren, deaktivieren oder abrufen, z. B. die Steuerung der Anzeige innerhalb der organization von Pronomen, die Benutzer möglicherweise für sich selbst eingerichtet haben.

Pronomen sind in diesem Zusammenhang Wörter, die verwendet werden, um den Namen einer Person in einem Satz zu ersetzen. Pronomen und ihre geschlechtsneutralen Versionen existieren in vielen Sprachen. Im Englischen sind z. B. "she", "her", "he", "him" und die geschlechtsneutralen "they" und "them" gemeinsame Pronomen. Die korrekte Verwendung der Pronomen von jemandem zeigt Inklusion und Respekt. Die Freigabe von Pronomen hilft Menschen, zu vermeiden, Annahmen zu erraten oder zu treffen, die ausschließlich auf Namen oder anfänglichen Beobachtungen der Person basieren. In einer hybriden, multikulturellen Arbeits- oder Schulumgebung kann die einfache Verwendung der richtigen Pronomen dazu beitragen, Vertrauen aufzubauen und die Kommunikation untereinander zu verbessern.

Globale Administratoren können Pronomen für alle Benutzer im organization mithilfe der Microsoft 365 Admin Center oder Microsoft Graph-API aktivieren oder deaktivieren. Pronomen sind standardmäßig deaktiviert.

Das Aktivieren von Pronomen in einem organization erleichtert das Zuordnen von Benutzern mit ihren bevorzugten Pronomen innerhalb der organization. Dies umfasst die folgenden Endbenutzererfahrungen:

  • Wenn Pronomen aktiviert sind, kann ein Benutzer optional Pronomen im Profil hinzufügen und verwalten Karte in Outlook im Web und Teams.
  • Pronomen werden nach dem Namen des Benutzers auf dem Profil Karte in Outlook und Teams angezeigt.
  • Pronomen werden nur intern innerhalb des organization angezeigt.
  • Jeder, der über ein Konto im organization verfügt, einschließlich Gastkonten, kann Pronomen auf Profilkarten sehen.

Die Endbenutzererfahrung mit Pronomen kann sich im Laufe der Zeit weiterentwickeln. Aktuelle Informationen zur Endbenutzererfahrung mit Pronomen finden Sie unter Pronomen in Microsoft 365.

Globale Administratoren können entscheiden, ob Pronomen angezeigt werden sollen, die Benutzer in ihren Profilkarten eingerichtet haben. Um dieses Szenario zu aktivieren, legen Sie die isEnabledInOrganization-Eigenschaft auf fest true. Wenn diese Eigenschaft auf truefestgelegt ist, werden Pronomen für alle Innerhalb des organization angezeigt. Wenn diese Eigenschaft auf falsefestgelegt ist, werden Pronomen für niemanden innerhalb oder außerhalb des organization angezeigt. Die Standardeinstellung ist false.

Wichtig

Wenn Sie Pronomen aktivieren oder deaktivieren, kann es bis zu sieben Stunden dauern, bis Benutzer Änderungen sehen. Wenn Sie z. B. Pronomen aktivieren, können Benutzer die Option zum Hinzufügen von Pronomen zu ihrem Profil Karte bis zu sieben Stunden lang nicht sehen. Wenn Sie Pronomen deaktivieren, bleiben alle zuvor festgelegten Pronomen in Microsoft 365 (z. B. auf Profilkarten) möglicherweise bis zu sieben Stunden lang sichtbar.

Wenn Sie Pronomen deaktivieren, werden alle von Benutzern erstellten Pronomendaten gelöscht. Der Datenlöschvorgang kann bis zu 30 Tage dauern. Wenn Sie Pronomen innerhalb dieses Zeitraums wieder aktivieren, werden alle ausgeblendeten Pronomen, die noch nicht von Microsoft-Servern gelöscht wurden, in Microsoft 365-Umgebungen wie Profilkarten angezeigt.

Konfigurieren von Pronomeneinstellungen mithilfe von PowerShell

Sie können das Microsoft Graph PowerShell SDK verwenden, um Einstellungen für Pronomen in Ihrem organization zu konfigurieren.

Voraussetzungen

Hinweis

Die PowerShell-Befehle für Pronomeneinstellungen sind nur in der Betaversion verfügbar. Wechseln Sie zur Betaumgebung, bevor Sie die folgenden Befehle ausführen.

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

Bestätigen Der aktuellen Einstellungen

Verwenden Sie den folgenden Befehl, um die Konfiguration der Pronomeneinstellungen für eine organization abzurufen:

Hinweis

Die get-Methode erfordert PeopleSettings.Read.All Berechtigungen. Um eine Microsoft Graph-Sitzung mit einem bestimmten erforderlichen Umfang zu erstellen, verwenden Sie den folgenden Befehl und stimmen den angeforderten Berechtigungen zu.

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


  Get-MgBetaAdminPeoplePronoun

Aktivieren von Pronomen in Ihrem organization

Pronomen sind standardmäßig deaktiviert. Sie können das Microsoft Graph PowerShell-Modul verwenden, um Pronomen in Ihrem organization verfügbar zu machen.

Hinweis

Die Aktualisierungsmethode erfordert zusätzliche PeopleSettings.ReadWrite.All-Berechtigungen. Um eine Microsoft Graph-Sitzung mit einem bestimmten erforderlichen Umfang zu erstellen, verwenden Sie den folgenden Befehl und stimmen den angeforderten Berechtigungen zu.

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

Verwenden Sie den folgenden Befehl, und geben Sie als truean-IsEnabledInOrganization.

  Update-MgBetaAdminPeoplePronoun -IsEnabledInOrganization:$true

Deaktivieren von Pronomen in Ihrem organization

Alternativ können Sie Pronomen für Ihre organization mit dem folgenden Befehl, in dem Sie als falseangeben-IsEnabledInOrganization, festlegen, dass Pronomen für Ihre organization nicht verfügbar sind.

  Update-MgBetaAdminPeoplePronoun -IsEnabledInOrganization:$false

Konfigurieren von Pronomeneinstellungen mithilfe der Microsoft Graph-REST-API

Sie können die PronomenSettings-API verwenden, um Pronomeneinstellungen in Ihrem organization zu konfigurieren.

Bestätigen Der aktuellen Einstellungen

Verwenden Sie den Get-Vorgang, um die aktuellen Einstellungen für Pronomen in Ihrem organization zurückzugeben.

Im folgenden Beispiel werden die aktuellen Anzeigeeinstellungen abgerufen, für die Pronomen deaktiviert sind.

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

Bei erfolgreicher Ausführung gibt die Antwort einen 200 OK Antwortcode und ein PronomenSettings-Objekt im Antworttext zurück.

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

{
  "isEnabledInOrganization": false
}

Aktivieren von Pronomen in Ihrem organization

Verwenden Sie den Aktualisierungsvorgang, um Pronomen in Ihrem organization zu aktivieren.

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

{
  "isEnabledInOrganization": true
}

Bei erfolgreicher Ausführung gibt die Antwort einen 200 OK Antwortcode und ein PronomenSettings-Objekt im Antworttext zurück.

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

{
  "isEnabledInOrganization": true
}

Deaktivieren von Pronomen in Ihrem organization

Verwenden Sie den Aktualisierungsvorgang, um Pronomen in Ihrem organization nicht verfügbar zu machen.

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

{
  "isEnabledInOrganization": false
}

Bei erfolgreicher Ausführung gibt die Antwort einen 200 OK Antwortcode und ein PronomenSettings-Objekt im Antworttext zurück.

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

{
  "isEnabledInOrganization": false
}

Verwandte Inhalte