Синхронизация отдельных объектов Microsoft Entra Подключение

  • Статья

Средство синхронизации отдельных объектов Microsoft Entra Подключение — это командлет PowerShell, который можно использовать для синхронизации отдельного объекта из Active Directory с идентификатором Microsoft Entra. Созданный отчет можно использовать для исследования и устранения неполадок, связанных с синхронизацией отдельных объектов.

Примечание.

Средство поддерживает синхронизацию с Active Directory с идентификатором Microsoft Entra. Он не поддерживает синхронизацию с идентификатором Microsoft Entra с Active Directory.

Это средство поддерживает синхронизацию добавления и обновления изменений объектов. Оно не поддерживает синхронизацию удаления изменений объектов.

Как это работает

Инструменту синхронизации одного объекта требуется различающееся имя Active Directory в качестве входных данных, чтобы найти исходный соединитель и раздел для импорта. Он экспортирует изменения в идентификатор Microsoft Entra. Средство создает выходные данные в формате JSON, аналогичные типу ресурса provisioningObjectSummary.

Средство синхронизации одного объекта выполняет следующие действия:

  1. Определяет, находится ли домен (соединитель и раздел Active Directory) объекта (источник) в области синхронизации.
  2. Определите, является ли домен объекта (целевой) (Microsoft Entra Подключение or и partition) в область синхронизации.
  3. Определяет, находится ли подразделение объекта в области синхронизации.
  4. Определяет, доступен ли объект с помощью учетных данных соединителя.
  5. Определяет, находится ли тип объекта в области синхронизации.
  6. Определяет, находится ли объект в области синхронизации, если включена фильтрация групп.
  7. Импортирует объект из Active Directory в пространство соединителя Active Directory.
  8. Импорт объекта из идентификатора Microsoft Entra в microsoft Entra Подключение or Space.
  9. Синхронизирует объект из пространства соединителя Active Directory.
  10. Экспорт объекта из Microsoft Entra Подключение or пробела в идентификатор Microsoft Entra.

Помимо выходных данных JSON, средство создает HTML-отчет, содержащий все сведения об операции синхронизации. Отчет в формате HTML находится по пути C:\ProgramData\AADConnect\ADSyncObjectDiagnostics\ ADSyncSingleObjectSyncResult-<дата>.htm. Этот отчет в формате HTML можно использовать совместно с группой поддержки для дальнейшего устранения неполадок, если потребуется.

Отчет в формате HTML содержит следующие элементы:

Вкладка Описание
Шаги Описывает шаги, предпринимаемые для синхронизации объекта. Каждый шаг содержит сведения для устранения неполадок. Шаги импорта, синхронизации и экспорта содержат дополнительные сведения об атрибутах, такие как имя, многозначность, тип, значение, добавление значения, удаление значения, операция, правило синхронизации, тип сопоставления и источник данных.
Устранение неполадок и рекомендации Содержит код и причину ошибки. Сведения об ошибке доступны, только если происходит сбой.
Измененные свойства Показывает старое и новое значения. Если старое значение отсутствует или новое значение удалено, эта ячейка остается пустой. Для многозначных атрибутов отображается количество. Имя атрибута — это ссылка на вкладку "Шаги". Экспорт объекта из Microsoft Entra Подключение or Space to Microsoft Entra ID: Атрибут Info, содержащий дополнительные сведения об атрибуте, например имя, имеет многозначное значение, тип, значение, добавление значения, удаление значения, операция, правило синхронизации, тип сопоставления и источник данных.
Итоги Содержит общие сведения о том, что случилось и идентификаторы для объекта в исходной и целевой системах.

Необходимые компоненты

Чтобы воспользоваться средством синхронизации отдельного объекта, необходимо использовать следующие компоненты:

  • Выпуск 2021 марта (1.6.4.0) microsoft Entra Подключение или более поздней версии.
  • PowerShell 5.0

Запуск средства синхронизации одного объекта

Чтобы запустить средство синхронизации одного объекта, выполните следующие действия:

  1. Откройте новый сеанс Windows PowerShell на сервере Microsoft Entra Подключение с параметром Запуска от имени Администратор istrator.

  2. Задайте для политики выполнения значение RemoteSigned или Unrestricted.

  3. Убедитесь, что никаких операций синхронизации не выполняется, и отключите планировщик синхронизации.

    Set-ADSyncScheduler -SyncCycleEnabled $false

  4. Импортируйте модуль диагностики AdSync

    Import-module -Name "C:\Program Files\Microsoft Azure AD Sync\Bin\ADSyncDiagnostics\ADSyncDiagnostics.psm1"

  5. Вызовите командлет синхронизации одного объекта.

    Invoke-ADSyncSingleObjectSync -DistinguishedName "CN=testobject,OU=corp,DC=contoso,DC=com" | Out-File -FilePath ".\output.json"

  6. Повторно включите планировщик синхронизации.

    Set-ADSyncScheduler -SyncCycleEnabled $true

Входные параметры синхронизации одного объекта Description
Различающееся имя. Это обязательный строковый параметр.

Это различающееся имя объекта Active Directory, требующего синхронизации и устранения неполадок.
StagingMode Это необязательный параметр коммутатора.

Этот параметр можно использовать для предотвращения экспорта изменений в идентификатор Microsoft Entra.

Примечание. Командлет зафиксует операцию синхронизации.

Примечание. Промежуточный сервер Microsoft Entra Подключение не экспортирует изменения в идентификатор Microsoft Entra.
NoHtmlReport Это необязательный параметр.

Этот параметр позволяет запретить создавать HTML-отчет.

Регулирование синхронизации одного объекта

Средство синхронизации одного объекта предназначено для изучения и устранения неполадок, связанных с синхронизацией отдельных объектов. Оно не предназначено для замены цикла синхронизации, выполняемого планировщиком. Импорт из идентификатора Microsoft Entra и экспорта в Идентификатор Microsoft Entra зависит от ограничений регулирования. Если достигнут регулирующий предел, повторите попытку через 5 минут.

Следующие шаги