Microsoft Graph APIを使用してorganizationのプロファイルソース設定を管理する

プロファイルソースの構成により、エンドユーザーエクスペリエンスが向上し、プロファイルデータのソースが明確でわかりやすいものになります。

この管理者ガイドでは、Microsoft Graph API を使用してorganizationでプロファイルソース設定を構成する方法について説明します。 organizationでプロファイルソースを追加、更新、削除するために必要な手順について詳しく説明し、プロファイルデータがさまざまな Microsoft 365 エクスペリエンスで正確に属性付けされ、表示されるようにします。

重要

既定では、Microsoft Entra IDはorganization内のプロファイルデータのソースです。 organization管理者は、読み取り可能で一意のプロファイルソース識別子である sourceId プロパティを設定します。 sourceId プロパティは更新可能ではなく、プロファイルソースのクエリを実行するときに代替キーとして使用できます。プロファイルソースは、 id という名前のシステム生成キーを使用して識別できます。

管理者は、 ローカリゼーション プロパティを使用して、複数のロケールのプロファイルソースの表示名をカスタマイズできます。

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

profileSource API を使用して、organizationでプロファイルソースを構成できます。

現在の設定を確認する

List 操作を使用して、organization内のプロファイルソースの現在の設定を返します。

次の例では、organization内のプロファイルソースのコレクションを取得します。

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

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

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

{
  "value": [
    {
      "id": "27f1af7b-b166-4f5b-b994-ae135a581547",
      "sourceId": "bamboohr1",
      "kind": "BambooHR",
      "displayName": "HR Platform",
      "webUrl": "https://bamboohr.contoso.com/login",
      "localizations": [
        {
          "displayName" : "HR-Platform",
          "webUrl" : "http://bamboohr.contoso.com/en-us/login",
          "languageTag" : "en-us"
        },
        {
          "displayName" : "HR-Plattform",
          "webUrl" : "http://bamboohr.contoso.com/de/login",
          "languageTag" : "de"
        }
      ]
    },
    {
      "id": "520c18f8-0284-4d79-9b14-8a2d74461370",
      "sourceId": "4ce763dd-9214-4eff-af7c-da491cc3782d",
      "kind": "MSEntra",
      "displayName": "Contoso Microsoft Entra",
      "webUrl": "https://login.microsoftonline.com",
      "localizations": [
        {
          "displayName" : "Contoso Microsoft Entra",
          "webUrl" : "https://login.microsoftonline.com",
          "languageTag" : "en-us"
        }
      ]
    }
  ]
}

プロファイルソースを追加する

[作成] 操作を使用して、organizationにプロファイルソースを追加します。

要求

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

{
  "sourceId": "bamboohr1",
  "displayName": "HR Platform",
  "kind": "BambooHR",
  "webUrl": "https://bamboohr.contoso.com/login",
  "localizations": [
    {
      "displayName" : "HR-Plattform",
      "webUrl" : "http://bamboohr.contoso.com/de/login",
      "languageTag" : "de"
    }
  ]
}

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

応答

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

{
  "id" : "27f1af7b-b166-4f5b-b994-ae135a581547",
  "sourceId": "bamboohr1",
  "kind": "BambooHR",
  "displayName": "HR Platform",
  "webUrl": "https://bamboohr.contoso.com/login",
  "localizations": [
    {
      "displayName" : "HR-Plattform",
      "webUrl" : "http://bamboohr.contoso.com/de/login",
      "languageTag" : "de"
    }
  ]
}

プロファイルソースを更新する

Update 操作を使用して、organization内のプロファイルソースを変更します。

要求

PATCH https://graph.microsoft.com/beta/admin/people/profileSources(sourceId='bamboohr1')
Content-Type: application/json

{
  "displayName": "BambooHR Updated",
  "localizations": [
    {
      "displayName" : "HR-Platform",
      "webUrl" : "http://bamboohr.contoso.com/en-us/login",
      "languageTag" : "en-us"
    },
    {
      "displayName" : "HR-Plattform",
      "webUrl" : "http://bamboohr.contoso.com/de/login",
      "languageTag" : "de"
    }
  ]
}

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

応答

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

{
  "id" : "27f1af7b-b166-4f5b-b994-ae135a581547",
  "sourceId": "bamboohr1",
  "kind": "BambooHR",
  "displayName": "BambooHR Updated",
  "webUrl": "https://bamboohr.contoso.com/login",
  "localizations": [
    {
      "displayName" : "HR-Platform",
      "webUrl" : "http://bamboohr.contoso.com/en-us/login",
      "languageTag" : "en-us"
    },
    {
      "displayName" : "HR-Plattform",
      "webUrl" : "http://bamboohr.contoso.com/de/login",
      "languageTag" : "de"
    }
  ]
}

プロファイルソースを削除する

削除操作を使用して、organization内のプロファイルソースを削除します。

要求

DELETE https://graph.microsoft.com/beta/admin/people/profileSources(sourceId='bamboohr1')

成功した場合、このメソッドは 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-MgBetaAdminPeopleProfileSource

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

Get-MgBetaAdminPeopleProfileSource -ProfileSourceId $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 = @{
	displayName = "HR-Platform"
	sourceId = "hrPlatform1"
	webUrl = "http://bamboohr.contoso.com/login"
	localizations = @(
		@{
			displayName = "HR-Plattform"
			webUrl = "http://bamboohr.contoso.com/de/login"
			languageTag = "de"
		}
	)
}

New-MgBetaAdminPeopleProfileSource -BodyParameter $params

organizationでプロファイルソース設定を更新する

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

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

$params = @{
	displayName = "HR-Platform Updated"
	sourceId = "hrPlatform1"
	webUrl = "http://bamboohr.contoso.com/login"
	localizations = @(
    @{
      displayName = "HR-Platform"
      webUrl = "http://bamboohr.contoso.com/en-us/login"
      languageTag = "en-us"
    },
		@{
			displayName = "HR-Plattform"
			webUrl = "http://bamboohr.contoso.com/de/login"
			languageTag = "de"
		}
	)
}

Update-MgBetaAdminPeopleProfileSource -ProfileSourceId $id -BodyParameter $params

organizationでプロファイルソース設定を削除する

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

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

Remove-MgBetaAdminPeopleProfileSource -ProfileSourceId $id

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

フィードバック

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

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でプロファイルソース設定を削除する