Freigeben über

Verwalten der Rangfolgeneinstellungen für Profilquellen für eine organization mithilfe des Microsoft Graph-API (Vorschau)

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, Benutzerprofilsynchronisierung 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.

In diesem Administratorhandbuch wird erläutert, wie Sie die Rangfolge von Profilquellen in einem organization mithilfe von Microsoft Graph-APIs konfigurieren. Es werden die Schritte beschrieben, die zum Hinzufügen, Aktualisieren und Löschen von Profileigenschafteneinstellungen erforderlich sind. Anhand dieser Anleitung können Sie steuern, welche Profildaten auf verschiedenen Microsoft 365-Umgebungen basierend auf den konfigurierten Prioritäten genau angezeigt werden.

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

Anmerkung: Die Name-Eigenschaftmuss leer sein, um sie von anderen Einstellungen auf Eigenschaftsebene in der Auflistung zu unterscheiden, die über eine name-Eigenschaft verfügen. Pro Profileigenschafteneinstellungsauflistung ist nur eine Konfiguration ohne Namen zulässig.

Wichtig

Wenn Sie eine neue Profilquelle als Priorität festlegen, ändern sich die Werte der Eigenschaften, die Benutzern in Ihrem organization in ihren Profilen 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/beta/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,
      "userOverridePrivacy": null,
      "allowedAudiences": null,
      "prioritizedSourceUrls": [
        "https://graph.microsoft.com/beta/admin/people/profileSources(sourceId='4ce763dd-9214-4eff-af7c-da491cc3782d')"
      ]
    }
  ]
}

Rangfolgeneinstellung für Profilquellen hinzufügen

Verwenden Sie den Vorgang Erstellen, um die Rangfolgeneinstellung der Profilquelle für Ihren organization hinzuzufügen.

Anforderung

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

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

Rangfolgeeinstellung der Profilquelle aktualisieren

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

Anforderung

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

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

Rangfolgeeinstellung für Profilquellen entfernen

Verwenden Sie den Löschvorgang, um die Rangfolgeneinstellung der Profilquelle in Ihrem organization zu entfernen.

Anforderung

DELETE https://graph.microsoft.com/beta/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