Administrar la configuración de precedencia del origen del perfil para una organización mediante microsoft Graph API (versión preliminar)

La prioridad del origen de perfil es una característica que permite a los administradores de inquilinos controlar el origen de los datos de perfil para los usuarios de su organización. Los datos de perfil pueden originarse en Microsoft Entra ID, datos organizativos de Microsoft 365, sincronización de perfiles de usuario u otros orígenes. Cuando varios orígenes proporcionan datos superpuestos, un administrador de inquilinos puede configurar el origen autoritativo de datos de perfil para los usuarios de su organización.

En esta guía de administrador se explica cómo configurar la prioridad de origen de perfil en una organización mediante las API de Microsoft Graph. Detalla los pasos necesarios para agregar, actualizar y eliminar la configuración de propiedades de perfil. Siguiendo esta guía, puede controlar qué datos de perfil se muestran con precisión en varias experiencias de Microsoft 365 en función de las prioridades configuradas.

Las direcciones URL de origen de prioridad se organizan según la prioridad de los datos, con el primer elemento de la colección con la prioridad más alta.

Nota: La propiedad namedebe estar vacía para diferenciarla de otros valores de nivel de propiedad de la colección que tienen una propiedad name . Solo se permite una configuración sin un nombre por colección de valores de propiedad de perfil.

Configuración de la precedencia del origen del perfil mediante microsoft Graph API

Puede usar profilePropertySetting API para configurar la prioridad del origen de perfil en su organización.

Confirmación de la configuración actual

Use la operación List para devolver la configuración actual de la configuración de propiedades de perfil de su organización.

En el ejemplo siguiente se obtiene la colección de valores de propiedad de perfil de una organización.

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

Si se ejecuta correctamente, este método devuelve un 200 OK código de respuesta y un objeto profilePropertySetting en el cuerpo de la respuesta.

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

Agregar configuración de precedencia de origen de perfil

Use la operación Crear para agregar la configuración de prioridad de origen de perfil para su organización.

Solicitud

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 se ejecuta correctamente, este método devuelve un 201 Created código de respuesta y un objeto profilePropertySetting en el cuerpo de la respuesta.

Respuesta

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

Actualizar la configuración de precedencia del origen del perfil

Use la operación Actualizar para modificar la configuración de precedencia del origen del perfil en su organización.

Solicitud

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 se ejecuta correctamente, este método devuelve un 200 OK código de respuesta y un objeto profilePropertySetting en el cuerpo de la respuesta.

Respuesta

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

Eliminación de la configuración de precedencia del origen del perfil

Use la operación Eliminar para quitar la configuración de prioridad de origen de perfil de la organización.

Solicitud

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

Si se ejecuta correctamente, este método devuelve un código de respuesta 204 No Content.

Respuesta

HTTP/1.1 204 No Content

Configuración de la configuración de precedencia del origen del perfil mediante el SDK de PowerShell de Microsoft Graph

Puede usar el SDK de PowerShell de Microsoft Graph para configurar los valores de precedencia del origen de perfil en su organización.

Requisitos previos

• Módulo de PowerShell : instale el módulo versión 2.3.0 o posterior.
• .NET Framework - Instale .NET Framework 4.7.2 o una versión superior.

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

Confirmación de la configuración actual

Para obtener la configuración de la propiedad de perfil para una organización, use el siguiente comando.

Get-MgBetaAdminPeopleProfilePropertySetting

Para obtener la configuración de precedencia del origen del perfil en una organización, use el siguiente comando.

Get-MgBetaAdminPeopleProfilePropertySetting -ProfilePropertySettingId $id

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

Adición de la configuración de precedencia de origen de perfil en la organización

Puede usar el módulo de PowerShell de Microsoft Graph para configurar la prioridad de perfil en su organización. El nuevo comando requiere el permiso PeopleSettings.ReadWrite.All y para crear una sesión de Microsoft Graph con el ámbito necesario específico, use el siguiente comando y dé su consentimiento a los permisos solicitados.

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

Actualizar la configuración de precedencia del origen del perfil en la organización

Puede usar el módulo de PowerShell de Microsoft Graph para actualizar la configuración de precedencia del origen del perfil en su organización. El comando update requiere el permiso PeopleSettings.ReadWrite.All y, para crear una sesión de Microsoft Graph con el ámbito necesario específico, use el siguiente comando y dé su consentimiento a los permisos solicitados.

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

Eliminación de la configuración de precedencia del origen del perfil en la organización

Puede usar el módulo de PowerShell de Microsoft Graph para quitar la configuración de precedencia de origen de perfil de su organización. El comando remove requiere el permiso PeopleSettings.ReadWrite.All y, para crear una sesión de Microsoft Graph con el ámbito necesario específico, use el siguiente comando y dé su consentimiento a los permisos solicitados.

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

Remove-MgBetaAdminPeopleProfilePropertySetting -ProfilePropertySettingId $id

Contenido relacionado

• Administración de la configuración de origen del perfil para una organización
• Descripción de cómo se usan y conservan los datos de la organización en Microsoft 365
• Sincronización de perfiles de usuario