Compartir a través de

Administrar la configuración de origen de perfil de una organización mediante Microsoft Graph API

La configuración del origen de perfiles mejora la experiencia del usuario final, lo que hace que el origen de sus datos de perfil sea claro y comprensible.

En esta guía de administrador se explica cómo configurar los valores de origen de perfil en una organización mediante las API de Microsoft Graph. Detalla los pasos necesarios para agregar, actualizar y eliminar un origen de perfil en una organización, lo que garantiza que los datos de perfil se atribuyen y exponen con precisión en varias experiencias de Microsoft 365.

Importante

De forma predeterminada, Microsoft Entra ID es el origen de los datos de perfil de una organización. Un administrador de la organización establece la propiedad sourceId que es un identificador de origen de perfil único y legible. La propiedad sourceId no se puede actualizar y se puede usar como clave alternativa al consultar un origen de perfil. Un origen de perfil se puede identificar a través de una clave generada por el sistema denominada id.

Los administradores pueden personalizar un nombre para mostrar de origen de perfil para varias configuraciones regionales a través de la propiedad localizaciones .

Configuración del origen del perfil mediante microsoft Graph API

Puede usar profileSource API para configurar un 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 los orígenes de perfil de la organización.

En el ejemplo siguiente se obtiene la colección de orígenes de perfil de una organización.

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

Si se ejecuta correctamente, la respuesta devuelve un 200 OK código de respuesta y un objeto profileSource en el cuerpo de la respuesta.

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

Agregar un origen de perfil

Use la operación Crear para agregar un origen de perfil a su organización.

Solicitud

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

Respuesta

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

Actualización de un origen de perfil

Use la operación Actualizar para modificar un origen de perfil en su organización.

Solicitud

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

Respuesta

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

Eliminación de un origen de perfil

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

Solicitud

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

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 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 origen de perfil en su organización.

Requisitos previos

Nota:

Los comandos de PowerShell para la configuración de origen de perfil solo están disponibles en versión beta. Cambie a la experiencia beta antes de ejecutar los siguientes comandos.

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 origen del perfil para una organización, use el siguiente comando.

Get-MgBetaAdminPeopleProfileSource

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

Get-MgBetaAdminPeopleProfileSource -ProfileSourceId $id

Nota:

Los comandos get requieren el PeopleSettings.Read.All permiso . Para crear una sesión de Microsoft Graph con un ámbito necesario específico, use el siguiente comando y dé su consentimiento a los permisos solicitados.

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

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

Puede usar el módulo de PowerShell de Microsoft Graph para configurar una configuración de origen 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 = @{
	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

Actualización de una configuración de origen de perfil en la organización

Puede usar el módulo de PowerShell de Microsoft Graph para actualizar una configuración de origen de 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 = @{
	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

Eliminación de una configuración de origen de perfil en la organización

Puede usar el módulo de PowerShell de Microsoft Graph para quitar una configuración de origen de perfil de la 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-MgBetaAdminPeopleProfileSource -ProfileSourceId $id

Contenido relacionado

Administración de la configuración de precedencia del origen del perfil para una organización

  • Last updated on