Microsoft Entra 連線 Single Object Sync

  • 發行項

Microsoft Entra 連線 Single Object Sync 工具是 PowerShell Cmdlet，可用來將個別物件從 Active Directory 同步處理至 Microsoft Entra ID。 產生的報告可用來調查和針對每個物件同步處理問題進行疑難解答。

注意

此工具支援從 Active Directory 同步處理至 Microsoft Entra ID。 它不支援從 Microsoft Entra ID 同步處理至 Active Directory。

此工具支援同步處理物件修改新增和更新。 它不支援同步處理物件修改刪除。

運作方式

單一物件同步工具需要 Active Directory 辨別名稱做為輸入，才能尋找來源連接器和數據分割以進行匯入。 它會將變更導出至 Microsoft Entra ID。 此工具會產生類似於 provisioningObjectSummary 資源類型的 JSON 輸出。

單一物件同步工具會執行下列步驟：

  1. 判斷物件 （來源） 網域 （Active Directory 連線 or 和 Partition） 是否在同步範圍中。
  2. 判斷物件 （target） 網域 （Microsoft Entra 連線 or 和 Partition） 是否在同步範圍中。
  3. 判斷物件是否在同步範圍中的組織單位。
  4. 判斷物件是否可使用連接器帳戶認證來存取。
  5. 判斷物件在同步範圍中的類型。
  6. 判斷物件是否在同步範圍中，是否已啟用群組篩選。
  7. 將物件從 Active Directory 匯入至 Active Directory 連線 or Space。
  8. 將物件從 Microsoft Entra 識別符匯入至 Microsoft Entra 連線 or Space。
  9. 從 Active Directory 同步物件 連線 或空間。
  10. 將物件從 Microsoft Entra 連線 or Space 導出至 Microsoft Entra ID。

除了 JSON 輸出之外，此工具還會產生 HTML 報表，其中包含同步處理作業的所有詳細數據。 HTML 報表位於 C：\ProgramData\AAD 連線\ADSyncObjectDiagnostics\ ADSyncSingleObjectSyncResult-date.htm<> 中。 如有需要，此 HTML 報告可以與支援小組共用，以進行進一步的疑難解答。

HTML 報表具有下列專案：

索引標籤 描述
步驟 概述同步處理對象所採取的步驟。 每個步驟都包含疑難解答的詳細數據。 匯入、同步和匯出步驟包含其他屬性資訊，例如名稱，是多重值、類型、值、值新增、值刪除、作業、同步規則、對應類型和數據源。
疑難解答與建議 提供錯誤碼和原因。 只有在發生失敗時，才會提供錯誤資訊。
已修改的屬性 顯示舊的值和新值。 如果沒有舊的值，或刪除新值，該儲存格會是空白的。 針對多重值屬性，它會顯示計數。 屬性名稱是 [步驟] 索引卷標的連結：將物件從 Microsoft Entra 連線 導出至 Microsoft Entra ID：屬性資訊，其中包含名稱等屬性的其他詳細數據，是多重值、類型、值、值新增、值刪除、作業、同步規則、對應類型和數據源。
摘要 提供來源和目標系統中對象發生狀況和標識碼的概觀。

必要條件

若要使用單一物件同步工具，您將需要使用下列各項：

執行單一物件同步工具

若要執行單一物件同步工具，請執行下列步驟：

  1. 使用 [以 管理員 istrator 執行] 選項，在您的 Microsoft Entra 連線 伺服器上開啟新的 Windows PowerShell 會話。

  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. 叫用單一物件同步 Cmdlet。

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

  6. 重新啟用同步排程器。

    Set-ADSyncScheduler -SyncCycleEnabled $true

單一物件同步輸入參數 描述
DistinguishedName 這是必要的字串參數。

這是需要同步處理和疑難解答的 Active Directory 物件的辨別名稱。
StagingMode 這是選擇性的 switch 參數。

此參數可用來防止將變更匯出至 Microsoft Entra ID。

注意：Cmdlet 會認可同步作業。

注意：Microsoft Entra 連線 預備伺服器不會將變更匯出至 Microsoft Entra ID。
NoHtmlReport 這是選擇性的 switch 參數。

此參數可用來防止產生 HTML 報表。

單一物件同步節流

單一物件同步工具旨在調查和疑難解答每個物件同步處理問題。 它並非用來取代排程器所執行的同步處理週期。 從 Microsoft Entra 識別元匯入並匯出至 Microsoft Entra ID 受限於節流限制。 如果您達到節流限制，請在 5 分鐘後重試。

下一步