Freigeben über

Verwalten von Profilquelleneinstellungen für eine organization mithilfe des Microsoft-Graph-API

Die Profilquellenkonfiguration verbessert die Endbenutzererfahrung und macht die Quelle ihrer Profildaten klar und verständlich.

In diesem Administratorhandbuch wird erläutert, wie Profilquelleneinstellungen in einem organization mithilfe von Microsoft Graph-APIs konfiguriert werden. Es werden die Schritte beschrieben, die zum Hinzufügen, Aktualisieren und Löschen einer Profilquelle in einem organization erforderlich sind, um sicherzustellen, dass Profildaten genau zugeordnet und in verschiedenen Microsoft 365-Umgebungen angezeigt werden.

Wichtig

Standardmäßig ist Microsoft Entra ID die Quelle von Profildaten in einem organization. Ein organization Administrator legt die sourceId-Eigenschaft fest, die ein lesbarer und eindeutiger Profilquellbezeichner ist. Die sourceId-Eigenschaft kann nicht aktualisiert werden und kann als alternativer Schlüssel verwendet werden, wenn Sie eine Profilquelle abfragen. Eine Profilquelle ist über einen vom System generierten Schlüssel mit dem Namen id identifizierbar.

Administratoren können den Anzeigenamen einer Profilquelle für mehrere Gebietsschemas über die Lokalisierungs-Eigenschaft anpassen.

Konfigurieren von Profilquelleneinstellungen mithilfe des Microsoft-Graph-API

Sie können die profileSource-API verwenden, um eine Profilquelle in Ihrem organization zu konfigurieren.

Bestätigen Der aktuellen Einstellungen

Verwenden Sie den Listenvorgang, um die aktuellen Einstellungen für Profilquellen in Ihrem organization zurückzugeben.

Im folgenden Beispiel wird die Auflistung von Profilquellen in einem organization abgerufen.

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

Bei erfolgreicher Ausführung gibt die Antwort einen 200 OK Antwortcode und ein profileSource-Objekt im Antworttext zurück.

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

Hinzufügen einer Profilquelle

Verwenden Sie den Vorgang Erstellen, um ihrer organization eine Profilquelle hinzuzufügen.

Anforderung

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

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

Antwort

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

Aktualisieren einer Profilquelle

Verwenden Sie den Vorgang Aktualisieren, um eine Profilquelle in Ihrem organization zu ändern.

Anforderung

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

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

Antwort

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

Entfernen einer Profilquelle

Verwenden Sie den Löschvorgang, um eine Profilquelle in Ihrem organization zu entfernen.

Anforderung

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

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

Antwort

HTTP/1.1 204 No Content

Konfigurieren von Profilquelleneinstellungen mit dem Microsoft Graph PowerShell SDK

Sie können das Microsoft Graph PowerShell SDK verwenden, um Profilquelleneinstellungen in Ihrem organization zu konfigurieren.

Voraussetzungen

Hinweis

Die PowerShell-Befehle für Profilquelleneinstellungen 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 Profilquelleneinstellungen für eine organization abzurufen.

Get-MgBetaAdminPeopleProfileSource

Verwenden Sie den folgenden Befehl, um die Konfiguration einer Profilquelleneinstellung in einem organization abzurufen.

Get-MgBetaAdminPeopleProfileSource -ProfileSourceId $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 einer Profilquelleneinstellung in Ihrem organization

Sie können das Microsoft Graph PowerShell-Modul verwenden, um eine Profilquelleneinstellung 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 = @{
	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

Aktualisieren einer Profilquelleneinstellung in Ihrem organization

Sie können das Microsoft Graph PowerShell-Modul verwenden, um eine Profilquelleneinstellung 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 = @{
	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

Entfernen einer Profilquelleneinstellung in Ihrem organization

Sie können das Microsoft Graph PowerShell-Modul verwenden, um eine Profilquelleneinstellung 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-MgBetaAdminPeopleProfileSource -ProfileSourceId $id

Verwandte Inhalte

Verwalten der Rangfolgeneinstellungen für Profilquellen für eine organization

  • Last updated on