Gérer les paramètres de priorité de la source de profil pour un organization à l’aide de Microsoft API Graph (préversion)

La priorité de la source de profil est une fonctionnalité qui permet aux administrateurs de locataires de contrôler la source des données de profil pour les utilisateurs de leur organization. Les données de profil peuvent provenir de Microsoft Entra ID, de données organisationnelles dans Microsoft 365, de synchronisation de profils utilisateur ou d’autres sources. Lorsque plusieurs sources fournissent des données qui se chevauchent, un administrateur client peut configurer la source faisant autorité des données de profil pour les utilisateurs dans leur organization.

Ce guide de l’administrateur explique comment configurer la priorité de la source de profil dans un organization à l’aide des API Microsoft Graph. Il détaille les étapes requises pour ajouter, mettre à jour et supprimer des paramètres de propriété de profil. En suivant ce guide, vous pouvez contrôler les données de profil qui sont affichées avec précision dans différentes expériences Microsoft 365 en fonction des priorités configurées.

Les URL sources de priorité sont organisées en fonction de la priorité des données, le premier élément de la collection ayant la priorité la plus élevée.

Note: La propriété namedoit être vide pour la différencier des autres paramètres de niveau propriété de la collection qui ont une propriété name . Une seule configuration sans nom est autorisée par collection de paramètres de propriété de profil.

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

Vous pouvez utiliser l’API profilePropertySetting pour configurer la priorité de la source de profil dans votre organization.

Confirmer vos paramètres actuels

Utilisez l’opération Liste pour renvoyer les paramètres actuels des paramètres de propriété de profil dans votre organization.

L’exemple suivant obtient la collection de paramètres de propriété de profil dans un organization.

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

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

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

Ajouter le paramètre de priorité de la source de profil

Utilisez l’opération Créer pour ajouter le paramètre de priorité de la source de profil pour votre organization.

Demande

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

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

Réponse

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

Mettre à jour le paramètre de priorité de la source de profil

Utilisez l’opération De mise à jour pour modifier le paramètre de priorité de la source de profil dans votre organization.

Demande

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

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

Réponse

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

Supprimer le paramètre de priorité de la source de profil

Utilisez l’opération Supprimer pour supprimer le paramètre de priorité de la source de profil dans votre organization.

Demande

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

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 le paramètre de priorité 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 priorité de la source de profil dans votre organization.

Configuration requise

• Module PowerShell : installez le module version 2.3.0 ou ultérieure.
• .NET Framework : installez .NET Framework 4.7.2 ou une version ultérieure.

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 propriété de profil pour un organization, utilisez la commande suivante.

Get-MgBetaAdminPeopleProfilePropertySetting

Pour obtenir la configuration de priorité de la source de profil dans un organization, utilisez la commande suivante.

Get-MgBetaAdminPeopleProfilePropertySetting -ProfilePropertySettingId $id

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

Ajouter le paramètre de priorité de la source de profil dans votre organization

Vous pouvez utiliser le module Microsoft Graph PowerShell pour configurer la priorité des profils 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 = @{
    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

Mettre à jour le paramètre de priorité de la source de profil dans votre organization

Vous pouvez utiliser le module Microsoft Graph PowerShell pour mettre à jour le paramètre de priorité de la 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 = @{
    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

Supprimer le paramètre de priorité de la source de profil dans votre organization

Vous pouvez utiliser le module Microsoft Graph PowerShell pour supprimer le paramètre de priorité de la 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-MgBetaAdminPeopleProfilePropertySetting -ProfilePropertySettingId $id

Contenu connexe

• Gérer les paramètres de la source de profil pour un organization
• Comprendre comment les données organisationnelles sont utilisées et conservées dans Microsoft 365
• Synchronisation des profils utilisateur