Partager via

Gérer les paramètres de source de profil pour un organization à l’aide de Microsoft API Graph

La configuration de la source de profil améliore l’expérience de l’utilisateur final, ce qui rend la source de ses données de profil claire et compréhensible.

Ce guide de l’administrateur explique comment configurer les paramètres de source de profil dans un organization à l’aide des API Microsoft Graph. Il détaille les étapes requises pour ajouter, mettre à jour et supprimer une source de profil dans un organization, garantissant ainsi que les données de profil sont correctement attribuées et exposées dans différentes expériences Microsoft 365.

Importante

Par défaut, Microsoft Entra ID est la source des données de profil dans un organization. Un administrateur organization définit la propriété sourceId qui est un identificateur de source de profil unique et lisible. La propriété sourceId n’est pas modifiable et peut être utilisée comme clé alternative lorsque vous interrogez une source de profil. Une source de profil est identifiable via une clé générée par le système nommée id.

Les administrateurs peuvent personnaliser un nom complet de source de profil pour plusieurs paramètres régionaux via la propriété localisations .

Configurer les paramètres de la source de profil à l’aide de Microsoft API Graph

Vous pouvez utiliser l’API profileSource pour configurer une source de profil dans votre organization.

Confirmer vos paramètres actuels

Utilisez l’opération List pour retourner les paramètres actuels des sources de profil dans votre organization.

L’exemple suivant obtient la collection de sources de profil dans un organization.

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

Si elle réussit, la réponse renvoie un 200 OK code de réponse et un objet profileSource dans le corps de la réponse.

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

Ajouter une source de profil

Utilisez l’opération Créer pour ajouter une source de profil dans votre organization.

Demande

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

Si elle réussit, cette méthode renvoie un 201 Created code de réponse et un objet profileSource dans le corps de la réponse.

Réponse

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

Mettre à jour une source de profil

Utilisez l’opération De mise à jour pour modifier une source de profil dans votre organization.

Demande

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

Si elle réussit, cette méthode renvoie un 200 OK code de réponse et un objet profileSource dans le corps de la réponse.

Réponse

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

Supprimer une source de profil

Utilisez l’opération Supprimer pour supprimer une source de profil dans votre organization.

Demande

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

Si elle réussit, cette méthode renvoie un code de réponse 204 No Content.

Réponse

HTTP/1.1 204 No Content

Configurer les paramètres de la source de profil à l’aide du Kit de développement logiciel (SDK) Microsoft Graph PowerShell

Vous pouvez utiliser le Kit de développement logiciel (SDK) Microsoft Graph PowerShell pour configurer les paramètres de source de profil dans votre organization.

Configuration requise

Remarque

Les commandes PowerShell pour les paramètres de source de profil sont uniquement disponibles en version bêta. Basculez vers l’expérience bêta avant d’exécuter les commandes suivantes.

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

Confirmer vos paramètres actuels

Pour obtenir la configuration des paramètres de source de profil pour un organization, utilisez la commande suivante.

Get-MgBetaAdminPeopleProfileSource

Pour obtenir la configuration d’un paramètre de source de profil dans un organization, utilisez la commande suivante.

Get-MgBetaAdminPeopleProfileSource -ProfileSourceId $id

Remarque

Les commandes get nécessitent l’autorisation PeopleSettings.Read.All . Pour créer une session Microsoft Graph avec une étendue requise spécifique, utilisez la commande suivante et consentez aux autorisations demandées.

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

Ajouter un paramètre de source de profil dans votre organization

Vous pouvez utiliser le module Microsoft Graph PowerShell pour configurer un paramètre de source de profil dans votre organization. La nouvelle commande nécessite l’autorisation PeopleSettings.ReadWrite.All. Pour créer une session Microsoft Graph avec l’étendue requise spécifique, utilisez la commande suivante et donnez votre consentement aux autorisations demandées.

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

Mettre à jour un paramètre de source de profil dans votre organization

Vous pouvez utiliser le module Microsoft Graph PowerShell pour mettre à jour un paramètre de source de profil dans votre organization. La commande de mise à jour nécessite l’autorisation PeopleSettings.ReadWrite.All. Pour créer une session Microsoft Graph avec l’étendue requise spécifique, utilisez la commande suivante et consentez aux autorisations demandées.

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

Supprimer un paramètre de source de profil dans votre organization

Vous pouvez utiliser le module Microsoft Graph PowerShell pour supprimer un paramètre de source de profil de votre organization. La commande remove nécessite l’autorisation PeopleSettings.ReadWrite.All. Pour créer une session Microsoft Graph avec l’étendue requise spécifique, utilisez la commande suivante et donnez votre consentement aux autorisations demandées.

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

Remove-MgBetaAdminPeopleProfileSource -ProfileSourceId $id

Contenu connexe

Gérer les paramètres de priorité de la source de profil pour un organization

  • Last updated on