Microsoft 365 でプロファイルソースの優先順位を管理する

プロファイルソースの優先順位は、テナント管理者がorganizationのユーザーのプロファイルデータのソースを制御できるようにする機能です。プロファイルデータは、Microsoft Entra ID、Microsoft 365 の組織データ、ユーザーデータ、SharePoint、またはその他のソース用の Copilot コネクタから発生する可能性があります。複数のソースが重複するデータを提供する場合、テナント管理者は、organization内のユーザーの権限のあるプロファイルデータのソースを構成できます。この機能は、主に、単一値として扱われるユーザープロファイルの人事および作業位置データに適用されます。

ユーザーデータソースとソース ID の詳細については、「organizationのプロファイルソース設定を管理する」を参照してください。

HR および作業位置データに関連するソース優先順位は、ソース優先順位による既定の順序に基づいています。

一般的な人事システムへのコネクタやカスタムコネクタなど、構成されている場合は、ユーザーデータ用の Copilot コネクタ。 organizationは、複数の接続を構成する場合があります。最後に構成された接続の優先順位が最も高くなります。各接続には、管理者によって定義された一意のソース ID があります。
Microsoft Entra ID。ソース ID が 4ce763dd-9214-4eff-af7c-da491cc3782d。
Microsoft 365 の組織データ。ソース ID が 7986c642-b494-4140-8df4-f5ed125e2c67。この Microsoft 365 ソースに関連付けられている顧客ソースの詳細については、「Microsoft 365 の組織データ」を参照してください。

他のユーザーデータソースが存在しますが、HR または仕事の位置データの権限のある値を選択する場合と、この記事で説明するようにテナント管理者ソースの優先順位の構成を適用する場合は、一覧表示されているソースのみが関連します。

注:

SharePoint ユーザープロファイルアプリケーション (UPA) ソースは、ソースの優先順位コーナーケースに関連します。たとえば、ユーザーがユーザーカードを介してエグゼクティブアシスタントを構成し、人事システムが同じユーザーに対して別のエグゼクティブアシスタントを定義した場合、値が異なる場合、ユーザーはユーザー入力値の優先順位を設定カード。この順序は変更できません。
プロファイル API ユーザーソース (Graph エクスプローラーを含む Microsoft Graph ベータ版の/me/profileまたは/users/{id | userPrincipalName}/profile) を使用して HR または作業位置データが書き込まれる場合、このデータはコネクタまたは Entra ID ソースをオーバーライドしません。 Microsoft Graph APIを使用してプロファイルデータを読み取ると、データは workPosition エンティティコレクション内の別のインスタンスとして OData に表示されます。

管理者は、前に一覧表示したソースの順序を変更できます。たとえば、Entra ID にコネクタよりも高い優先順位を付けたり、複数のコネクタソース間で優先順位を変更したりします。 Microsoft 365 の組織データの背後にある顧客ソースの優先順位は、 Microsoft 365 プラットフォームの組織データで個別に管理されます。

ソースの優先順位がユーザーの表現にどのように影響するか

ソースの優先順位は、主に単一値データに影響します。このコンテキストでは、単一値は、結果として得られる people 表現の特定のプロパティに対して 1 つの権限のある値が存在することを意味します。単一値データには、仕事の位置、名前データ、アカウントデータが含まれます。

単一値データの場合、ビジネスロジックは、値を持つ最も優先度の高いソースからプロパティの値を選択します。優先度の低いソースのデータは、優先度の高いソースがプロパティの値を提供する場合は無視されます。

注:

空の値または文字列と null 値、またはコネクタインジェストの一部ではないプロパティの間には、大きな違いが存在します。たとえば、空の文字列 ("") は値として扱われ、空でない文字列を持つ優先順位の低いソースをオーバーライドします。この動作により、コネクタソースは、プロパティが値を持つものではない場合に空の文字列を設定することで、特定のプロパティを完全に制御できます。

電話、メール、プロジェクト、スキルなどの複数値データの場合、ソースの優先順位は、複数のソースからのデータの順序にのみ影響します。クライアントは、このデータを使用する方法を決定します。 API ペイロードには、複数のソースからの重複データを含めることができます。

Microsoft Graph または PowerShell を使用してソースの優先順位を構成する

管理者は、Microsoft Graph API または PowerShell を使用してソースの優先順位を変更できます。このガイドでは、ソースの優先順位に関連するプロファイルプロパティ設定を追加または更新するために必要な手順について説明します。

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

注:

Microsoft Graph APIを使用してソースの優先順位を構成する場合は、テナントレベルとプロパティごとの設定をサポートする profilePropertySetting エンティティ型を使用します。ソースの優先順位はテナントレベルの設定であるため、プロパティレベルの設定と区別するには、名前と displayName プロパティを省略するか、nullに設定する必要があります。プロファイルプロパティ設定コレクションごとに、名前のない構成は 1 つだけ許可されます。
prioritizedSourceUrls では、一覧表示されている URL では、/beta または /v1.0 エンドポイントを使用できます。プロファイルプロパティの優先順位の構成と基になるデータは両方のエンドポイント間で共有されるため、どちらのエンドポイントを指定しても同じ効果があります。
ソース優先順位構成を含む profilePropertySetting は削除しないでください。代わりに、Entra ID ソース参照のみを含む既定の状態に修正します。 Delete 操作は、設定がこの既定の状態に修正された後にのみサポートされ、優先順位付けされたSourceUrls プロパティにEntra ID ソース参照のみが含まれている場合を除き、失敗します。

重要

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

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

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

現在の設定を確認する

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

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

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

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

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

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

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

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

次の要求は、優先順位を定義します。

ソース ID contosohr1を持つコネクタインスタンス。
Entra ID と固定ソース ID 4ce763dd-9214-4eff-af7c-da491cc3782d。

要求

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

{
  "prioritizedSourceUrls": [
    "https://graph.microsoft.com/v1.0/admin/people/profileSources(sourceId='contosohr1')",
    "https://graph.microsoft.com/v1.0/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,
  "prioritizedSourceUrls": [
    "https://graph.microsoft.com/v1.0/admin/people/profileSources(sourceId='contosohr1')",
    "https://graph.microsoft.com/v1.0/admin/people/profileSources(sourceId='4ce763dd-9214-4eff-af7c-da491cc3782d')"
  ],
  "displayName": null
}

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

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

次の例では、前の作成 (POST) 操作の例と比較して、 contosohr2別のコネクタソース ID を追加します。

要求

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

{
  "prioritizedSourceUrls": [
    "https://graph.microsoft.com/v1.0/admin/people/profileSources(sourceId='contosohr1')",
    "https://graph.microsoft.com/v1.0/admin/people/profileSources(sourceId='contosohr2')",
    "https://graph.microsoft.com/v1.0/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,
  "prioritizedSourceUrls": [
    "https://graph.microsoft.com/v1.0/admin/people/profileSources(sourceId='contosohr1')",
    "https://graph.microsoft.com/v1.0/admin/people/profileSources(sourceId='contosohr2')",
    "https://graph.microsoft.com/v1.0/admin/people/profileSources(sourceId='4ce763dd-9214-4eff-af7c-da491cc3782d')"
  ],
  "displayName": null
}

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

削除操作を使用して、Entra ID ソース参照のみを含む既定の状態にパッチを適用した後、organizationのプロファイルソース優先順位設定を削除します。

要求

DELETE https://graph.microsoft.com/v1.0/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 2026-06-12

Microsoft 365 でプロファイル ソースの優先順位を管理する

ソースの優先順位がユーザーの表現にどのように影響するか

Microsoft Graph または PowerShell を使用してソースの優先順位を構成する

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

現在の設定を確認する

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

要求

応答

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

要求

応答

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

要求

応答

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

前提条件

現在の設定を確認する

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

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

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

関連コンテンツ

フィードバック

その他のリソース

Microsoft 365 でプロファイルソースの優先順位を管理する

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

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

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

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

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

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

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