Атрибуты расширения в локальной Active Directory (AD) позволяют организациям расширять объекты каталога новыми атрибутами, адаптированными к их конкретным потребностям. Эти пользовательские атрибуты можно синхронизировать с Microsoft Entra ID, обеспечивая бесшовную интеграцию между платформами.

После синхронизации эти атрибуты можно отображать на сайтах SharePoint и Microsoft Teams с помощью веб-части Employee Directory, что повышает доступность для пользователей информации о сотрудниках.

В этой статье представлено подробное руководство по настройке веб-части Employee Directory для отображения настраиваемых атрибутов объектов пользователей из Entra ID.

Название атрибута

Пользовательские атрибуты не называются так, как в локальном Active Directory, например факс. Вместо этого имя пользовательского атрибута в Azure AD выглядит следующим образом:

Пользовательские атрибуты в Entra ID не именуются так же, как в локальной AD. Например, атрибут fax в локальной AD будет иметь другое название в Entra ID. Формат имен пользовательских атрибутов в Entra ID следующий:

extension_{uniqueid}_attributeName

Для эффективного использования этих пользовательских атрибутов необходимо получить их имена из Entra ID.

Предусловие

Прежде чем продолжить, убедитесь, что у вас установлены необходимые модули PowerShell для взаимодействия со средой Microsoft 365. Откройте PowerShell и выполните следующие команды для установки модулей MSOnline и AzureAD:

Install-Module -Name MSOnline

Install-Module -Name AzureAD

Подключение к Microsoft 365

Чтобы подключиться к среде Microsoft 365, выполните командлет Connect-AzureAD:

Connect-AzureAD

Вам будет предложено войти в систему с помощью вашей корпоративной учетной записи. Это подключение необходимо для доступа и управления атрибутами пользователей Entra ID.

Получение пользовательских атрибутов

Чтобы получить пользовательские атрибуты, замените dbadmin@vitextra.onmicrosoft.com на логин пользователя в вашем Entra ID, который имеет необходимые атрибуты. Запустите следующий скрипт:

$userLogin = "dbadmin@vitextra.onmicrosoft.com"
Get-AzureADUser -ObjectId $userLogin | Select -ExpandProperty ExtensionProperty

Эта команда выведет список свойств расширения, которые можно использовать в качестве настраиваемых атрибутов в веб-части Employee Directory.

Свойства веб-части

Чтобы настроить веб-часть Employee Directory, перейдите на страницу, где размещена веб-часть, и войдите в режим редактирования. Откройте настройки веб-части и выберите Настройка под заголовком Пользовательские столбцы:

Добавьте пользовательские атрибуты в список и нажмите кнопку Сохранить, чтобы применить изменения.

После того, как пользовательские атрибуты определены и отмечены как видимые, они появятся на панели сведений о сотруднике:

Наконец, опубликуйте страницу, чтобы сохранить изменения и сделать пользовательские атрибуты доступными для пользователей.

Резюме

Подводя итог, можно сказать, что расширение объектов каталога с помощью настраиваемых атрибутов в Entra ID повышает функциональность веб-части «Каталог сотрудников» в SharePoint и Microsoft Teams.

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

Для получения дополнительной помощи рассмотрите возможность изучения дополнительных ресурсов или обратитесь в свою службу ИТ-поддержки.