Microsoft Graph APIを使用してorganizationの代名詞設定を管理する

Microsoft Graph APIを使用すると、ユーザーが自分で設定した可能性がある代名詞のorganization内での表示の制御など、organizationで代名詞を管理する設定を有効、無効、または取得できます。

代名詞は、このコンテキストでは、文内の人の名前を置き換えるために使用される単語です。 代名詞とその性別に依存しないバージョンは、多くの言語に存在します。 たとえば、英語では、"she"、"her、"he"、"him"、性別に依存しない "they"、および "them" は一般的な代名詞です。 誰かの代名詞を正しく使用すると、包含と敬意が示されます。 代名詞を共有すると、名前や最初の観察のみに基づいて推測や仮定を行うのを避けることができます。 ハイブリッド、多文化の職場または学校環境では、適切な代名詞を使用する単純な行為は、相互の信頼を構築し、コミュニケーションを向上させるのに役立ちます。

グローバル管理者は、Microsoft 365 管理センターまたは Microsoft Graph APIを使用して、organizationのすべてのユーザーの代名詞を有効または無効にすることができます。 既定では、代名詞は無効になっています。

organizationで代名詞を有効にすると、ユーザーをorganization内の優先する代名詞に関連付けやすくします。 これには、次のエンド ユーザー エクスペリエンスが含まれます。

• 代名詞が有効になっている場合、ユーザーは必要に応じて、Outlook on the web と Teams のプロファイル カードに代名詞を追加および管理できます。
• 代名詞は、Outlook と Teams のプロファイル カードにユーザーの名前で表示されます。
• 代名詞は、organization内でのみ内部的に表示されます。
• ゲスト アカウントを含め、organizationにアカウントを持っているユーザーは、プロファイル カードに代名詞を表示できます。

代名詞のエンド ユーザー エクスペリエンスは、時間の経過と共に進化する可能性があります。 代名詞を使用したエンド ユーザー エクスペリエンスの現在の情報については、「 Microsoft 365 の代名詞」を参照してください。

グローバル管理者は、ユーザーがプロファイル カードに設定した代名詞を表示するかどうかを決定できます。 このシナリオを有効にするには、 isEnabledInOrganization プロパティを に設定します true。 このプロパティを にtrue設定すると、organization内のすべてのユーザーに代名詞が表示されます。 このプロパティが にfalse設定されている場合、organization内または外部のユーザーに代名詞は表示されません。 既定の設定は です false。

PowerShell を使用して代名詞の設定を構成する

Microsoft Graph PowerShell SDK を使用して、organizationで代名詞設定を構成できます。

前提条件

• PowerShell モジュール - モジュール バージョン 2.3.0 以降をインストールします。
• .NET Framework - .NET Framework 4.7.2 以降のバージョンをインストールします。

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

現在の設定を確認する

organizationの代名詞設定の構成を取得するには、次のコマンドを使用します。

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

  Get-MgBetaAdminPeoplePronoun

organizationで代名詞を有効にする

既定では、代名詞は無効になっています。 Microsoft Graph PowerShell モジュールを使用して、代名詞をorganizationで使用できるようにします。

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

次のコマンドを使用して、 として trueを指定-IsEnabledInOrganizationします。

  Update-MgBetaAdminPeoplePronoun -IsEnabledInOrganization:$true

organizationで代名詞を無効にする

または、次のコマンドを使用して、organizationで代名詞を使用できないようにすることもできます。ここで、 を としてfalse指定-IsEnabledInOrganizationします。

  Update-MgBetaAdminPeoplePronoun -IsEnabledInOrganization:$false

Microsoft Graph REST API を使用して代名詞設定を構成する

pronounsSettings API を使用して、organizationで代名詞設定を構成できます。

現在の設定を確認する

get 操作を使用して、organizationの代名詞の現在の設定を返します。

次の例では、代名詞が無効になっている現在の表示設定を取得します。

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

成功した場合、応答は応答コードと、応答本文の pronounsSettings オブジェクトを返200 OKします。

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

{
  "isEnabledInOrganization": false
}

organizationで代名詞を有効にする

更新操作を使用して、organizationで代名詞を有効にします。

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

{
  "isEnabledInOrganization": true
}

成功した場合、応答は応答コードと、応答本文の pronounsSettings オブジェクトを返200 OKします。

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

{
  "isEnabledInOrganization": true
}

organizationで代名詞を無効にする

更新操作を使用して、代名詞をorganizationで使用できないようにします。

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

{
  "isEnabledInOrganization": false
}

成功した場合、応答は応答コードと、応答本文の pronounsSettings オブジェクトを返200 OKします。

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

{
  "isEnabledInOrganization": false
}

関連コンテンツ

• Microsoft 365 管理センターでorganizationの代名詞をオンまたはオフにする
• Microsoft 365 の代名詞
• Microsoft 365 のプロファイル カード