Verwalten von Pronomeneinstellungen für eine Organisation mithilfe des Microsoft Graph-API (Vorschau)
Mithilfe der Microsoft Graph-API können Sie Einstellungen zum Verwalten von Pronomen in einer Organisation aktivieren, deaktivieren oder abrufen, z. B. die Steuerung der Anzeige innerhalb der Organisation 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 Personen in der Organisation aktivieren oder deaktivieren, indem sie das Microsoft 365 Admin Center oder Microsoft Graph-API verwenden, wie unten beschrieben. Pronomen sind standardmäßig deaktiviert.
Das Aktivieren von Pronomen in einer Organisation erleichtert das Zuordnen von Benutzern zu ihren bevorzugten Pronomen innerhalb der Organisation. Dies umfasst die folgenden Endbenutzererfahrungen:
- Wenn Pronomen aktiviert sind, kann ein Benutzer optional Pronomen in der Profilkarte in Outlook im Web und Teams hinzufügen und verwalten.
- Pronomen werden anhand des Benutzernamens auf der Profilkarte in Outlook und Teams angezeigt.
- Pronomen werden nur intern innerhalb der Organisation angezeigt.
- Jeder, der über ein Konto in der Organisation 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.
Bestätigen Der aktuellen Einstellungen
Verwenden Sie den Get-Vorgang , um die aktuellen Einstellungen für Pronomen in Ihrer Organisation zurückzugeben.
Im folgenden Beispiel werden die aktuellen Anzeigeeinstellungen abgerufen, für die Pronomen deaktiviert sind:
GET https://graph.microsoft.com/beta/organization/{organizationId}/settings/pronouns
Bei erfolgreicher Ausführung gibt die Antwort einen 200 OK Antwortcode und eine PronomenSettings-Ressource im Antworttext zurück.
HTTP/1.1 200 OK
Content-Type: application/json
{
"isEnabledInOrganization": false
}
Szenarien
Ein gängiges Szenario, das globale Administratoren aktivieren können, ist die Anzeige aller Pronomen, die Benutzer in ihren Profilkarten eingerichtet haben.
| Szenario | isEnabledInOrganization |
|---|---|
| Pronomen in Profilkarten dürfen für personen innerhalb und außerhalb einer Organisation nicht angezeigt werden (Standardeinstellung). | Falsch |
| Anzeigen aller Pronomen innerhalb der Organisation, die Benutzer in ihren Profilkarten eingerichtet haben. | Wahr |
Wichtig
Wenn Sie Pronomen aktivieren oder deaktivieren, kann es bis zu sechs Stunden dauern, bis Benutzer Änderungen sehen. Wenn Sie z. B. Pronomen aktivieren, wird benutzern die Option zum Hinzufügen von Pronomen auf ihrer Profilkarte bis zu sechs Stunden lang nicht angezeigt. Wenn Sie Pronomen deaktivieren, bleiben alle zuvor festgelegten Pronomen in Microsoft 365 (z. B. auf Profilkarten) möglicherweise bis zu sechs Stunden lang sichtbar.
Wenn Sie Pronomen deaktivieren, werden alle von Benutzern erstellten Pronomendaten gelöscht. Die Datenlöschung 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.
Aktivieren von Pronomen in Ihrer Organisation
Verwenden Sie den Aktualisierungsvorgang , um Pronomen in Ihrer Organisation zu aktivieren.
PATCH https://graph.microsoft.com/beta/organization/{organizationId}/settings/pronouns
Content-Type: application/json
{
"isEnabledInOrganization": true
}
Bei erfolgreicher Ausführung gibt die Antwort einen 200 OK Antwortcode und eine PronomenSettings-Ressource im Antworttext zurück.
HTTP/1.1 200 OK
Content-Type: application/json
{
"isEnabledInOrganization": true
}
Deaktivieren von Pronomen in Ihrer Organisation
Verwenden Sie den Aktualisierungsvorgang, um Pronomen in Ihrer Organisation nicht verfügbar zu machen.
PATCH https://graph.microsoft.com/beta/organization/{organizationId}/settings/pronouns
Content-Type: application/json
{
"isEnabledInOrganization": false
}
Bei erfolgreicher Ausführung gibt die Antwort einen 200 OK Antwortcode und eine PronomenSettings-Ressource im Antworttext zurück.
HTTP/1.1 200 OK
Content-Type: application/json
{
"isEnabledInOrganization": false
}