Управление параметрами приоритета источника профиля для организации с помощью microsoft API Graph

Приоритет источника профиля — это функция, которая позволяет администраторам клиентов управлять источником данных профиля для пользователей своей организации. Данные профиля могут исходить из Microsoft Entra ID, организационных данных в Microsoft 365, синхронизации профилей пользователей или других источников. Если несколько источников предоставляют перекрывающиеся данные, администратор клиента может настроить полномочный источник данных профиля для пользователей в своей организации.

В этом руководстве администратора объясняется, как настроить приоритет источника профиля в организации с помощью API Microsoft Graph. В ней подробно описаны действия, необходимые для добавления, обновления и удаления параметров свойств профиля. Следуя этому руководству, вы можете контролировать, какие данные профиля точно отображаются в различных интерфейсах Microsoft 365 на основе настроенных приоритетов.

URL-адреса источника приоритета упорядочены в соответствии с приоритетом данных, при этом первый элемент в коллекции имеет наивысший приоритет.

Настройка параметров приоритета источника профиля с помощью microsoft API Graph

Api profilePropertySetting можно использовать для настройки приоритета источника профиля в организации.

Подтверждение текущих параметров

Используйте операцию List , чтобы вернуть текущие параметры для параметров свойств профиля в организации.

В следующем примере возвращается коллекция параметров свойств профиля в организации.

GET https://graph.microsoft.com/v1.0/admin/people/profilePropertySettings

В случае успешного выполнения этот метод возвращает код отклика 200 OK и объект profilePropertySetting в теле отклика.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "value": [
    {
      "id": "00000000-0000-0000-0000-000000000001",
      "name": "Profile priority config",
      "displayName": "Profile priority config",
      "prioritizedSourceUrls": [
        "https://graph.microsoft.com/v1.0/admin/people/profileSources(sourceId='4ce763dd-9214-4eff-af7c-da491cc3782d')"
      ]
    }
  ]
}

Добавление параметра приоритета источника профиля

Используйте операцию Создания , чтобы добавить параметр приоритета источника профиля для вашей организации.

Запрос

POST https://graph.microsoft.com/v1.0/admin/people/profilePropertySettings
Content-Type: application/json

{
  "prioritizedSourceUrls": [
    "https://graph.microsoft.com/v1.0/admin/people/profileSources(sourceId='contosohr1')",
    "https://graph.microsoft.com/v1.0/admin/people/profileSources(sourceId='4ce763dd-9214-4eff-af7c-da491cc3782d')"
  ]
}

В случае успешного выполнения этот метод возвращает код отклика 201 Created и объект profilePropertySetting в теле отклика.

Отклик

HTTP/1.1 201 Created
Content-type: application/json

{
  "id": "00000000-0000-0000-0000-000000000001",
  "name": "Profile priority config",
  "displayName": "Profile priority config",
  "prioritizedSourceUrls": [
    "https://graph.microsoft.com/v1.0/admin/people/profileSources(sourceId='contosohr1')",
    "https://graph.microsoft.com/v1.0/admin/people/profileSources(sourceId='4ce763dd-9214-4eff-af7c-da491cc3782d')"
  ]
}

Обновление параметра приоритета источника профиля

Используйте операцию Обновления , чтобы изменить параметр приоритета источника профиля в организации.

Запрос

PATCH https://graph.microsoft.com/v1.0/admin/people/profilePropertySettings/00000000-0000-0000-0000-000000000001
Content-Type: application/json

{
  "prioritizedSourceUrls": [
    "https://graph.microsoft.com/v1.0/admin/people/profileSources(sourceId='contosohr1')",
    "https://graph.microsoft.com/v1.0/admin/people/profileSources(sourceId='contosohr2')",
    "https://graph.microsoft.com/v1.0/admin/people/profileSources(sourceId='4ce763dd-9214-4eff-af7c-da491cc3782d')"
  ]
}

В случае успешного выполнения этот метод возвращает код отклика 200 OK и объект profilePropertySetting в теле отклика.

Отклик

HTTP/1.1 200 OK
Content-type: application/json

{
  "id": "00000000-0000-0000-0000-000000000001",
  "name": "Profile priority config",
  "displayName": "Profile priority config",
  "prioritizedSourceUrls": [
    "https://graph.microsoft.com/v1.0/admin/people/profileSources(sourceId='contosohr1')",
    "https://graph.microsoft.com/v1.0/admin/people/profileSources(sourceId='contosohr2')",
    "https://graph.microsoft.com/v1.0/admin/people/profileSources(sourceId='4ce763dd-9214-4eff-af7c-da491cc3782d')"
  ]
}

Удаление параметра приоритета источника профиля

Используйте операцию Удаления , чтобы удалить параметр приоритета источника профиля в организации.

Запрос

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

В случае успешного выполнения этот метод возвращает код отклика 204 No Content.

Отклик

HTTP/1.1 204 No Content

Настройка параметра приоритета источника профиля с помощью пакета SDK Для Microsoft Graph PowerShell

Вы можете использовать пакет SDK PowerShell для Microsoft Graph для настройки параметров приоритета источника профиля в организации.

Предварительные условия

• Модуль PowerShell — установка модуля версии 2.3.0 или более поздней.
• .NET Framework — установите .NET Framework 4.7.2 или более поздней версии.

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

Подтверждение текущих параметров

Чтобы получить конфигурацию параметров свойств профиля для организации, используйте следующую команду.

Get-MgBetaAdminPeopleProfilePropertySetting

Чтобы получить конфигурацию приоритета источника профиля в организации, используйте следующую команду.

Get-MgBetaAdminPeopleProfilePropertySetting -ProfilePropertySettingId $id

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

Добавление параметра приоритета источника профиля в организации

Вы можете использовать модуль Microsoft Graph PowerShell для настройки приоритета профилей в организации. Для новой команды требуется разрешение PeopleSettings.ReadWrite.All, а для создания сеанса Microsoft Graph с конкретным необходимым область используйте следующую команду и согласие на запрошенные разрешения.

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

Обновление параметра приоритета источника профиля в организации

Модуль Microsoft Graph PowerShell можно использовать для обновления параметра приоритета источника профиля в организации. Для выполнения команды update требуется разрешение PeopleSettings.ReadWrite.All, а для создания сеанса Microsoft Graph с конкретными необходимыми область используйте следующую команду и согласие на запрошенные разрешения.

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

Удаление параметра приоритета источника профиля в организации

Вы можете использовать модуль Microsoft Graph PowerShell, чтобы удалить параметр приоритета источника профиля из вашей организации. Для команды remove требуется разрешение PeopleSettings.ReadWrite.All, а для создания сеанса Microsoft Graph с конкретным необходимым область используйте следующую команду и согласие на запрошенные разрешения.

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

Remove-MgBetaAdminPeopleProfilePropertySetting -ProfilePropertySettingId $id

Связанные материалы

• Управление параметрами источника профиля для организации
• Сведения об использовании и хранении данных организации в Microsoft 365
• Синхронизация профилей пользователей