Gerir definições de precedência de origem de perfil para uma organização com o Microsoft API do Graph (pré-visualização)

A precedência da origem de perfil é uma funcionalidade que capacita os administradores de inquilinos com controlo sobre a origem dos dados de perfil para os utilizadores da respetiva organização. Os dados de perfil podem ter origem em Microsoft Entra ID, dados organizacionais no Microsoft 365, sincronização de perfis de utilizador ou outras origens. Quando várias origens fornecem dados sobrepostos, um administrador inquilino pode configurar a origem autoritativa dos dados de perfil para os utilizadores na respetiva organização.

Este guia de administrador explica como configurar a precedência da origem do perfil numa organização com as APIs do Microsoft Graph. Detalha os passos necessários para adicionar, atualizar e eliminar definições de propriedades de perfil. Ao seguir este guia, pode controlar que dados de perfil são apresentados com precisão em várias experiências do Microsoft 365 com base nas prioridades configuradas.

Os URLs de origem de prioridade são organizados de acordo com a precedência dos dados, com o primeiro item na coleção a ter a prioridade mais alta.

Nota: A propriedade nametem de estar vazia para diferenciá-la de outras definições ao nível da propriedade na coleção que tenham uma propriedade de nome . Só é permitida uma configuração sem nome por coleção de definições de propriedades de perfil.

Configurar definições de precedência de origem de perfil com o Microsoft API do Graph

Pode utilizar a API profilePropertySetting para configurar a precedência da origem do perfil na sua organização.

Confirmar as definições atuais

Utilize a operação Lista para devolver as definições atuais das definições de propriedade do perfil na sua organização.

O exemplo seguinte obtém a coleção de definições de propriedades de perfil numa organização.

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

Se for bem-sucedido, este método devolve um 200 OK código de resposta e um objeto profilePropertySetting no corpo da resposta.

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

Adicionar definição de precedência de origem de perfil

Utilize a operação Criar para adicionar a definição de precedência de origem do perfil à sua organização.

Solicitação

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

Se for bem-sucedido, este método devolve um 201 Created código de resposta e um objeto profilePropertySetting no corpo da resposta.

Resposta

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

Atualizar definição de precedência de origem do perfil

Utilize a operação Atualizar para modificar a definição de precedência de origem do perfil na sua organização.

Solicitação

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

Se for bem-sucedido, este método devolve um 200 OK código de resposta e um objeto profilePropertySetting no corpo da resposta.

Resposta

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

Remover definição de precedência de origem do perfil

Utilize a operação Eliminar para remover a definição de precedência de origem do perfil na sua organização.

Solicitação

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

Se tiver êxito, este método retornará um código de resposta 204 No Content.

Resposta

HTTP/1.1 204 No Content

Configurar a definição de precedência de origem do perfil com o SDK do PowerShell do Microsoft Graph

Pode utilizar o SDK do PowerShell do Microsoft Graph para configurar as definições de precedência de origem do perfil na sua organização.

Pré-requisitos

• Módulo do PowerShell – instale a versão 2.3.0 ou superior do módulo.
• .NET Framework - Instale o .NET Framework 4.7.2 ou uma versão superior.

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

Confirmar as definições atuais

Para obter a configuração das definições de propriedade do perfil para uma organização, utilize o seguinte comando.

Get-MgBetaAdminPeopleProfilePropertySetting

Para obter a configuração da precedência de origem do perfil numa organização, utilize o seguinte comando.

Get-MgBetaAdminPeopleProfilePropertySetting -ProfilePropertySettingId $id

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

Adicionar definição de precedência de origem de perfil na sua organização

Pode utilizar o módulo do PowerShell do Microsoft Graph para configurar a precedência de perfis na sua organização. O novo comando requer a permissão PeopleSettings.ReadWrite.All e para criar uma sessão do Microsoft Graph com o âmbito necessário específico, utilize o seguinte comando e consentimento para as permissões pedidas.

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

Atualizar a definição de precedência de origem do perfil na sua organização

Pode utilizar o módulo do PowerShell do Microsoft Graph para atualizar a definição de precedência da origem de perfil na sua organização. O comando update requer a permissão PeopleSettings.ReadWrite.All e para criar uma sessão do Microsoft Graph com o âmbito necessário específico, utilize o seguinte comando e consentimento para as permissões pedidas.

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

Remover a definição de precedência de origem do perfil na sua organização

Pode utilizar o módulo do PowerShell do Microsoft Graph para remover a definição de precedência de origem do perfil da sua organização. O comando remover requer a permissão PeopleSettings.ReadWrite.All e para criar uma sessão do Microsoft Graph com o âmbito necessário específico, utilize o seguinte comando e consentimento para as permissões pedidas.

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

Remove-MgBetaAdminPeopleProfilePropertySetting -ProfilePropertySettingId $id

Conteúdo relacionado

• Gerir definições de origem de perfil para uma organização
• Compreender como os dados organizacionais são utilizados e retidos no Microsoft 365
• Sincronização de perfis de utilizador