Verwalten der Rangfolge von Profilquellen in Microsoft 365

Die Rangfolge von Profilquellen ist ein Feature, mit dem Mandantenadministratoren die Quelle der Profildaten für die Benutzer ihrer organization steuern können. Profildaten können aus Microsoft Entra ID, Organisationsdaten in Microsoft 365, Copilot-Connectors für Personendaten, SharePoint oder anderen Quellen stammen. Wenn mehrere Quellen überlappende Daten bereitstellen, kann ein Mandantenadministrator die autoritative Quelle von Profildaten für Benutzer in ihren organization konfigurieren. Diese Funktion gilt in erster Linie für Personal- und Arbeitspositionsdaten im Benutzerprofil, das als einwertig behandelt wird.

Weitere Informationen zu Datenquellen und Quell-IDs für Personen finden Sie unter Verwalten von Profilquelleneinstellungen für eine organization.

Die Quellrangfolge im Zusammenhang mit Personal- und Arbeitspositionsdaten basiert auf einer Standardreihenfolge nach Quellpriorität:

  1. Copilot-Connectors für Personendaten, sofern konfiguriert, einschließlich Connectors für beliebte HR-Systeme und benutzerdefinierte Connectors. Ein organization kann mehrere Verbindungen konfigurieren. Die zuletzt konfigurierte Verbindung hat die höchste Priorität. Jede Verbindung verfügt über eine eindeutige Quell-ID, die vom Administrator definiert wird.
  2. Microsoft Entra ID. Die Quell-ID lautet 4ce763dd-9214-4eff-af7c-da491cc3782d.
  3. Organisationsdaten in Microsoft 365. Die Quell-ID lautet 7986c642-b494-4140-8df4-f5ed125e2c67. Ausführliche Informationen zu den Kundenquellen, die dieser Microsoft 365-Quelle zugeordnet sind, finden Sie unter Organisationsdaten in Microsoft 365.

Andere Quellen von Personendaten sind vorhanden, aber nur die aufgeführten Quellen sind relevant, wenn Sie den autoritativen Wert für Personal- oder Arbeitspositionsdaten auswählen und wenn Sie die Rangfolgenkonfiguration der Mandantenadministratorquelle anwenden, wie in diesem Artikel beschrieben.

Hinweis

  • Die Quelle der SharePoint-Benutzerprofilanwendung (User Profile Application, UPA) ist für einen Quellrangfolge-Eckfall relevant. Wenn ein Benutzer beispielsweise eine Führungskraft Assistent über die Personen Karte konfiguriert und das Personalsystem eine andere Assistent für denselben Benutzer definiert, priorisieren die Personen Karte den vom Benutzer eingegebenen Wert, wenn sich die Werte unterscheiden. Diese Reihenfolge kann nicht geändert werden.
  • Wenn Personal- oder Arbeitspositionsdaten mithilfe der Profil-API-Benutzerquelle (/me/profile oder /users/{id | userPrincipalName}/profile in Microsoft Graph Beta, einschließlich graph Explorer) geschrieben werden, überschreiben diese Daten nicht den Connector oder Entra ID-Quellen. Wenn Sie die Profildaten mithilfe des Microsoft Graph-API lesen, werden die Daten in OData als separate instance in der WorkPosition-Entitätssammlung angezeigt.

Ein Administrator kann die Reihenfolge der zuvor aufgeführten Quellen ändern. Beispielsweise, indem Entra-ID eine höhere Priorität als ein Connector erhält oder die Priorität für mehrere Connectorquellen geändert wird. Die Priorität von Kundenquellen hinter Organisationsdaten in Microsoft 365 wird separat in der Organisationsdaten in Microsoft 365-Plattform verwaltet.

Wie sich die Quellrangfolge auf die Personendarstellung auswirkt

Die Quellrangfolge wirkt sich hauptsächlich auf Einwertdaten aus. In diesem Kontext bedeutet Ein-Wert, dass ein autoritativer Wert für eine bestimmte Eigenschaft in der resultierenden Personendarstellung vorhanden ist. Einwertige Daten umfassen Arbeitsposition, Namensdaten und Kontodaten.

Für Einwertdaten wählt die Geschäftslogik den Wert für eine Eigenschaft aus der Quelle mit der höchsten Priorität aus, die über einen Wert verfügt. Daten aus Quellen mit niedrigerer Priorität werden ignoriert, wenn eine Quelle mit höherer Priorität einen Wert für die Eigenschaft bereitstellt.

Hinweis

Es besteht ein erheblicher Unterschied zwischen einem leeren Wert oder einer Zeichenfolge und einem NULL-Wert oder einer Eigenschaft, die nicht Teil der Connectorerfassung ist. Beispielsweise wird eine leere Zeichenfolge ("") als Wert behandelt und überschreibt eine Quelle mit niedrigerer Priorität, die über eine nicht leere Zeichenfolge verfügt. Dieses Verhalten ermöglicht einer Connectorquelle die vollständige Kontrolle über eine bestimmte Eigenschaft, indem eine leere Zeichenfolge festgelegt wird, wenn die Eigenschaft keinen Wert haben soll.

Bei Mehrwertdaten wie Telefonen, E-Mails, Projekten oder Skills wirkt sich die Quellrangfolge nur auf die Reihenfolge der Daten aus mehreren Quellen aus. Clients entscheiden, wie diese Daten verwendet werden sollen. Die API-Nutzlast kann doppelte Daten aus mehreren Quellen enthalten.

Konfigurieren der Quellrangfolge mithilfe von Microsoft Graph oder PowerShell

Ein Administrator kann die Rangfolge der Quelle mithilfe von Microsoft Graph-APIs oder PowerShell ändern. In diesem Leitfaden werden die Schritte beschrieben, die zum Hinzufügen oder Aktualisieren von Profileigenschafteneinstellungen im Zusammenhang mit der Quellrangfolge erforderlich sind.

Die Prioritätsquell-URLs sind gemäß der Datenrangfolge angeordnet, wobei das erste Element in der Sammlung die höchste Priorität hat.

Hinweis

  • Wenn Sie die Quellrangfolge mithilfe des Microsoft Graph-API konfigurieren, verwenden Sie den Entitätstyp profilePropertySetting, der Einstellungen auf Mandantenebene und pro Eigenschaft unterstützt. Da die Quellrangfolge eine Einstellung auf Mandantenebene ist, müssen Sie die Eigenschaften name und displayName weglassen oder auf null festlegen, um sie von einstellungen auf Eigenschaftsebene zu unterscheiden. Pro Profileigenschafteneinstellungsauflistung ist nur eine Konfiguration ohne Namen zulässig.
  • In priordSourceUrls können die aufgelisteten URLs entweder den /beta Endpunkt oder /v1.0 verwenden. Die Konfiguration der Profileigenschaftspriorität und die zugrunde liegenden Daten werden für beide Endpunkte freigegeben, sodass die Angabe eines der beiden Endpunkte die gleiche Auswirkung hat.
  • Sie sollten profilePropertySetting nicht löschen, das eine Quellrangfolgekonfiguration enthält. Patchen Sie es stattdessen auf einen Standardzustand, der nur den Entra ID-Quellverweis enthält. Ein Löschvorgang wird erst unterstützt, nachdem die Einstellung auf diesen Standardzustand gepatcht wurde, und schlägt fehl, es sei denn, die Eigenschaft priordSourceUrls enthält nur den Entra ID-Quellverweis.

Wichtig

Wenn Sie eine neue Profilquelle als Priorität festlegen, ändern sich die Werte der Eigenschaften, die Benutzern in Ihrem organization in Benutzerprofilen in Microsoft 365-Anwendungen angezeigt werden. Standardmäßig ist Entra ID die priorisierte Quelle von Profildaten in einem organization.

Konfigurieren der Rangfolgeneinstellungen für Profilquellen mithilfe des Microsoft-Graph-API

Sie können die profilePropertySetting-API verwenden, um die Rangfolge der Profilquelle in Ihrem organization zu konfigurieren.

Bestätigen Der aktuellen Einstellungen

Verwenden Sie den Vorgang Auflisten, um die aktuellen Einstellungen für Profileigenschafteneinstellungen in Ihrem organization zurückzugeben.

Im folgenden Beispiel wird die Auflistung der Profileigenschafteneinstellungen in einem organization abgerufen.

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

Bei erfolgreicher Ausführung gibt die Methode den 200 OK Antwortcode und ein profilePropertySetting-Objekt im Antworttext zurück.

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
    }
  ]
}

Hinzufügen der Rangfolgeneinstellung für die Ursprüngliche Profilquelle

Verwenden Sie den Vorgang Erstellen, um die Rangfolgeneinstellung der Profilquelle für Ihren organization hinzuzufügen. Es kann nur eine Quellrangfolgeeinstellung erstellt werden.

Die folgende Anforderung definiert die Rangfolge:

  1. Ein Connector instance mit der Quell-ID contosohr1.
  2. Entra-ID mit fester Quell-ID 4ce763dd-9214-4eff-af7c-da491cc3782d.

Anforderung

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')"
  ]
}

Bei erfolgreicher Ausführung gibt die Methode den 201 Created Antwortcode und ein profilePropertySetting-Objekt im Antworttext zurück.

Antwort

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
}

Rangfolgeeinstellung der Profilquelle aktualisieren

Verwenden Sie den Vorgang Aktualisieren, um die Rangfolge der Profilquelle in Ihrem organization zu ändern.

Im folgenden Beispiel wird im Vergleich zum vorherigen Erstellungsvorgang (POST) eine weitere Connectorquell-ID contosohr2hinzugefügt.

Anforderung

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')"
  ]
}

Bei erfolgreicher Ausführung gibt die Methode den 200 OK Antwortcode und ein profilePropertySetting-Objekt im Antworttext zurück.

Antwort

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
}

Rangfolgeeinstellung für Profilquellen entfernen

Verwenden Sie den Löschvorgang, um die Rangfolgeneinstellung der Profilquelle in Ihrem organization zu entfernen, nachdem Sie sie auf den Standardzustand zurückgesetzt haben, der nur den Verweis auf die Entra-ID-Quelle enthält.

Anforderung

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

Wenn die Methode erfolgreich verläuft, wird der Antwortcode 204 No Content zurückgegeben.

Antwort

HTTP/1.1 204 No Content

Konfigurieren der Rangfolgeneinstellung für Profilquellen mithilfe des Microsoft Graph PowerShell SDK

Sie können das Microsoft Graph PowerShell SDK verwenden, um Die Rangfolgeneinstellungen für Profilquellen in Ihrem organization zu konfigurieren.

Voraussetzungen

Hinweis

Die PowerShell-Befehle für die Rangfolge der Profilquellen sind nur in der Betaversion verfügbar. Wechseln Sie zur Betaumgebung, bevor Sie die folgenden Befehle ausführen.

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

Bestätigen Der aktuellen Einstellungen

Verwenden Sie den folgenden Befehl, um die Konfiguration der Profileigenschafteneinstellungen für eine organization abzurufen.

Get-MgBetaAdminPeopleProfilePropertySetting

Verwenden Sie den folgenden Befehl, um die Rangfolgenkonfiguration der Profilquelle in einem organization abzurufen.

Get-MgBetaAdminPeopleProfilePropertySetting -ProfilePropertySettingId $id

Hinweis

Die Get-Befehle erfordern die PeopleSettings.Read.All -Berechtigung. Um eine Microsoft Graph-Sitzung mit einem bestimmten erforderlichen Bereich zu erstellen, verwenden Sie den folgenden Befehl, und stimmen Sie den angeforderten Berechtigungen zu.

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

Hinzufügen der Rangfolgeneinstellung für Profilquellen in Ihrem organization

Sie können das Microsoft Graph PowerShell-Modul verwenden, um die Profilrangfolge in Ihrem organization zu konfigurieren. Der neue Befehl erfordert die Berechtigung PeopleSettings.ReadWrite.All, und um eine Microsoft Graph-Sitzung mit dem spezifischen erforderlichen Bereich zu erstellen, verwenden Sie den folgenden Befehl und stimmen den angeforderten Berechtigungen zu.

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

Aktualisieren der Rangfolgeneinstellung für Profilquellen in Ihrem organization

Sie können das Microsoft Graph PowerShell-Modul verwenden, um die Rangfolgeneinstellung der Profilquelle in Ihrem organization zu aktualisieren. Der Updatebefehl erfordert die Berechtigung PeopleSettings.ReadWrite.All, und um eine Microsoft Graph-Sitzung mit dem spezifischen erforderlichen Bereich zu erstellen, verwenden Sie den folgenden Befehl und stimmen den angeforderten Berechtigungen zu.

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

Entfernen der Rangfolgeneinstellung für Profilquellen in Ihrem organization

Sie können das Microsoft Graph PowerShell-Modul verwenden, um die Rangfolgeneinstellung der Profilquelle aus Ihrem organization zu entfernen. Der Befehl remove erfordert die Berechtigung PeopleSettings.ReadWrite.All, und um eine Microsoft Graph-Sitzung mit dem spezifischen erforderlichen Bereich zu erstellen, verwenden Sie den folgenden Befehl und stimmen den angeforderten Berechtigungen zu.

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

Remove-MgBetaAdminPeopleProfilePropertySetting -ProfilePropertySettingId $id

Verwandte Inhalte

  • Last updated on