Microsoft Graph API (プレビュー) を使用してorganizationのプロファイルソースの優先順位設定を管理する

プロファイルソースの優先順位は、テナント管理者がorganizationのユーザーのプロファイルデータのソースを制御できるようにする機能です。プロファイルデータは、Microsoft Entra ID、Microsoft 365 の組織データ、ユーザープロファイル同期、またはその他のソースから発生する可能性があります。複数のソースが重複するデータを提供する場合、テナント管理者は、organization内のユーザーの権限のあるプロファイルデータのソースを構成できます。

この管理者ガイドでは、Microsoft Graph API を使用してorganizationでプロファイルソースの優先順位を構成する方法について説明します。プロファイルプロパティ設定の追加、更新、削除に必要な手順について詳しくは、以下をご覧ください。このガイドに従うことで、構成された優先順位に基づいて、さまざまな Microsoft 365 エクスペリエンスで正確に表示されるプロファイルデータを制御できます。

優先順位ソース URL は、データの優先順位に従って配置され、コレクション内の最初の項目の優先順位が最も高くなります。

手記：name プロパティを持つコレクション内の他のプロパティレベルの設定と区別するには、name プロパティを空にする必要があります。プロファイルプロパティ設定コレクションごとに、名前のない構成は 1 つだけ許可されます。

重要

新しいプロファイルソースを優先度として設定すると、organizationのユーザーがプロファイルに表示するプロパティの値が変更されます。既定では、Entra IDは、organization内のプロファイルデータの優先順位付けされたソースです。

Microsoft Graph APIを使用してプロファイルソースの優先順位設定を構成する

profilePropertySetting API を使用して、organizationでプロファイルソースの優先順位を構成できます。

現在の設定を確認する

List 操作を使用して、organizationのプロファイルプロパティ設定の現在の設定を返します。

次の例では、organizationのプロファイルプロパティ設定のコレクションを取得します。

GET https://graph.microsoft.com/beta/admin/people/profilePropertySettings

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

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

{
  "value": [
    {
      "id": "00000000-0000-0000-0000-000000000001",
      "name": null,
      "userOverridePrivacy": null,
      "allowedAudiences": null,
      "prioritizedSourceUrls": [
        "https://graph.microsoft.com/beta/admin/people/profileSources(sourceId='4ce763dd-9214-4eff-af7c-da491cc3782d')"
      ]
    }
  ]
}

プロファイルソースの優先順位設定を追加する

[作成] 操作を使用して、organizationのプロファイルソースの優先順位設定を追加します。

要求

POST https://graph.microsoft.com/beta/admin/people/profilePropertySettings
Content-Type: application/json

{
  "prioritizedSourceUrls": [
    "https://graph.microsoft.com/beta/admin/people/profileSources(sourceId='contosohr1')",
    "https://graph.microsoft.com/beta/admin/people/profileSources(sourceId='4ce763dd-9214-4eff-af7c-da491cc3782d')"
  ]
}

成功した場合、このメソッドは応答コード 201 Created と、応答本文に profilePropertySetting オブジェクトを返します。

応答

HTTP/1.1 201 Created
Content-type: application/json

{
  "id": "00000000-0000-0000-0000-000000000001",
  "name": null,
  "userOverridePrivacy": null,
  "allowedAudiences": null,
  "prioritizedSourceUrls": [
    "https://graph.microsoft.com/beta/admin/people/profileSources(sourceId='contosohr1')",
    "https://graph.microsoft.com/beta/admin/people/profileSources(sourceId='4ce763dd-9214-4eff-af7c-da491cc3782d')"
  ]
}

プロファイルソースの優先順位設定を更新する

Update 操作を使用して、organizationのプロファイルソースの優先順位設定を変更します。

要求

PATCH https://graph.microsoft.com/beta/admin/people/profilePropertySettings/00000000-0000-0000-0000-000000000001
Content-Type: application/json

{
  "prioritizedSourceUrls": [
    "https://graph.microsoft.com/beta/admin/people/profileSources(sourceId='contosohr1')",
    "https://graph.microsoft.com/beta/admin/people/profileSources(sourceId='contosohr2')",
    "https://graph.microsoft.com/beta/admin/people/profileSources(sourceId='4ce763dd-9214-4eff-af7c-da491cc3782d')"
  ]
}

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

応答

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

{
  "id": "00000000-0000-0000-0000-000000000001",
  "name": null,
  "userOverridePrivacy": null,
  "allowedAudiences": null,
  "prioritizedSourceUrls": [
    "https://graph.microsoft.com/beta/admin/people/profileSources(sourceId='contosohr1')",
    "https://graph.microsoft.com/beta/admin/people/profileSources(sourceId='contosohr2')",
    "https://graph.microsoft.com/beta/admin/people/profileSources(sourceId='4ce763dd-9214-4eff-af7c-da491cc3782d')"
  ]
}

プロファイルソースの優先順位設定を削除する

[削除] 操作を使用して、organizationのプロファイルソースの優先順位設定を削除します。

要求

DELETE https://graph.microsoft.com/beta/admin/people/profilePropertySettings/00000000-0000-0000-0000-000000000001

成功した場合、このメソッドは 204 No Content 応答コードを返します。

応答

HTTP/1.1 204 No Content

Microsoft Graph PowerShell SDK を使用してプロファイルソースの優先順位設定を構成する

Microsoft Graph PowerShell SDK を使用して、organizationでプロファイルソースの優先順位設定を構成できます。

前提条件

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

注:

プロファイルソースの優先順位設定の PowerShell コマンドは、ベータ版でのみ使用できます。次のコマンドを実行する前に、ベータエクスペリエンスに切り替えます。

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

現在の設定を確認する

organizationのプロファイルプロパティ設定の構成を取得するには、次のコマンドを使用します。

Get-MgBetaAdminPeopleProfilePropertySetting

organizationでプロファイルソースの優先順位の構成を取得するには、次のコマンドを使用します。

Get-MgBetaAdminPeopleProfilePropertySetting -ProfilePropertySettingId $id

注:

get コマンドには、 PeopleSettings.Read.All アクセス許可が必要です。特定の必要なスコープを持つ Microsoft Graph セッションを作成するには、次のコマンドを使用し、要求されたアクセス許可に同意します。

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

organizationにプロファイルソースの優先順位設定を追加する

Microsoft Graph PowerShell モジュールを使用して、organizationでプロファイルの優先順位を構成できます。新しいコマンドには PeopleSettings.ReadWrite.All アクセス許可が必要であり、特定の必要なスコープを持つ Microsoft Graph セッションを作成するには、次のコマンドを使用し、要求されたアクセス許可に同意します。

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

$params = @{
    prioritizedSourceUrls = @(
      "https://graph.microsoft.com/beta/admin/people/profileSources(sourceId='hrPlatform1')",
	    "https://graph.microsoft.com/beta/admin/people/profileSources(sourceId='4ce763dd-9214-4eff-af7c-da491cc3782d')"
    )
}

New-MgBetaAdminPeopleProfilePropertySetting -BodyParameter $params

organizationのプロファイルソースの優先順位設定を更新する

Microsoft Graph PowerShell モジュールを使用して、organizationのプロファイルソースの優先順位設定を更新できます。 update コマンドには PeopleSettings.ReadWrite.All アクセス許可が必要です。また、特定の必要なスコープを持つ Microsoft Graph セッションを作成するには、次のコマンドを使用して、要求されたアクセス許可に同意します。

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

$params = @{
    prioritizedSourceUrls = @(
        "https://graph.microsoft.com/beta/admin/people/profileSources(sourceId='contosohr1')",
        "https://graph.microsoft.com/beta/admin/people/profileSources(sourceId='contosohr2')",
        "https://graph.microsoft.com/beta/admin/people/profileSources(sourceId='4ce763dd-9214-4eff-af7c-da491cc3782d')"
    )
}

Update-MgBetaAdminPeopleProfilePropertySetting -ProfilePropertySettingId $id -BodyParameter $params

organizationでプロファイルソースの優先順位設定を削除する

Microsoft Graph PowerShell モジュールを使用して、プロファイルソースの優先順位設定をorganizationから削除できます。 remove コマンドには PeopleSettings.ReadWrite.All アクセス許可が必要です。また、特定の必要なスコープを持つ Microsoft Graph セッションを作成するには、次のコマンドを使用して、要求されたアクセス許可に同意します。

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

Remove-MgBetaAdminPeopleProfilePropertySetting -ProfilePropertySettingId $id

フィードバック

このページはお役に立ちましたか?

Last updated on 2025-07-29

次の方法で共有

Microsoft Graph API (プレビュー) を使用してorganizationのプロファイル ソースの優先順位設定を管理する

Microsoft Graph APIを使用してプロファイル ソースの優先順位設定を構成する

現在の設定を確認する

プロファイル ソースの優先順位設定を追加する

要求

応答

プロファイルソースの優先順位設定を更新する

要求

応答

プロファイル ソースの優先順位設定を削除する

要求

応答

Microsoft Graph PowerShell SDK を使用してプロファイル ソースの優先順位設定を構成する

前提条件

現在の設定を確認する

organizationにプロファイル ソースの優先順位設定を追加する

organizationのプロファイル ソースの優先順位設定を更新する

organizationでプロファイル ソースの優先順位設定を削除する

関連コンテンツ

フィードバック

その他のリソース

Microsoft Graph API (プレビュー) を使用してorganizationのプロファイルソースの優先順位設定を管理する

Microsoft Graph APIを使用してプロファイルソースの優先順位設定を構成する

プロファイルソースの優先順位設定を追加する

プロファイルソースの優先順位設定を削除する

Microsoft Graph PowerShell SDK を使用してプロファイルソースの優先順位設定を構成する

organizationにプロファイルソースの優先順位設定を追加する

organizationのプロファイルソースの優先順位設定を更新する

organizationでプロファイルソースの優先順位設定を削除する