Set-EntraDirSyncEnabled

Set-EntraDirSyncEnabled

    -EnableDirSync <Boolean>
    [-Force]
    [-TenantId <String>]
    [<CommonParameters>]

指令小程式用來 Set-EntraDirSyncEnabled 開啟或關閉公司的目錄同步功能。

當你啟用或重新啟用 DirSync 時，租戶中會出現新的服務主體。 它擁有 appID 6bf85cfa-ac8a-4be5-b5de-425a0d0dc016 和顯示名稱 Microsoft Entra AD 同步服務。

停用 DirSync 可能需要長達 72 小時，視你雲端訂閱中的物件數量而定。 一旦停用，該流程無法取消，必須完成後才能繼續行動，包括重新啟用 DirSync。

如果您重新啟用 DirSync，將會進行完全同步，這可能會因 Microsoft Entra ID 中的物件數量而花費相當長的時間。

此外，若BlockCloudObjectTakeoverThroughHardMatch啟用 DirSync，重新啟用 DirSync 將阻擋所有 Microsoft Entra ID 母帶物件的本地至雲端物件接管或更新。 若要同步這些物件，請設 BlockCloudObjectTakeoverThroughHardMatch 為 false。

Connect-Entra -Scopes 'OnPremDirectorySynchronization.ReadWrite.All', 'Organization.ReadWrite.All'
Set-EntraDirSyncEnabled -EnableDirsync $true -Force $true

這個範例是為一家公司啟用目錄同步。

• -EnableDirsync 規定是否要為你的公司開啟目錄同步。
• -Force 強制指令執行而不需使用者確認。

Connect-Entra -Scopes 'OnPremDirectorySynchronization.ReadWrite.All', 'Organization.ReadWrite.All'
$tenantID = (Get-EntraContext).TenantId
Set-EntraDirSyncEnabled -EnableDirsync $false -TenantId $tenantID -Force

這個範例是關閉某公司的目錄同步功能。

• -EnableDirsync 規定是否要為你的公司開啟目錄同步。
• -Force 強制指令執行而不需使用者確認。
• -TenantId 指定執行操作的租戶唯一 ID。

此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。