Set-EntraDirSyncEnabled

Set-EntraDirSyncEnabled

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

cmdlet 为 Set-EntraDirSyncEnabled 公司打开或关闭目录同步。

启用或重新启用 DirSync 时，租户中会显示一个新的服务主体。 它具有 appId 6bf85cfa-ac8a-4be5-b5de-425a0d0dc016 和显示名称Microsoft Entra AD 同步服务。

停用 DirSync 可能需要长达 72 小时，具体取决于云订阅中的对象数。 禁用后，无法取消该过程，并且必须先完成，然后才能采取进一步操作，包括重新启用 DirSync。

如果重新启用 DirSync，将发生完全同步，这可能需要很长时间，具体取决于Microsoft Entra ID中的对象数。

此外，如果BlockCloudObjectTakeoverThroughHardMatch已启用，重新启用 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。