Set-EntraDirSyncEnabled

Set-EntraDirSyncEnabled

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

O Set-EntraDirSyncEnabled cmdlet ativa ou desativa a sincronização de diretório para uma empresa.

Uma nova entidade de serviço aparece em seu locatário quando você habilita ou reabilita o DirSync. Ele tem o appId 6bf85cfa-ac8a-4be5-b5de-425a0d0dc016 e o nome de exibição Microsoft Entra Serviço de Sincronização do AD.

A desativação do DirSync pode levar até 72 horas, dependendo do número de objetos em sua assinatura de nuvem. Depois de desabilitado, o processo não pode ser cancelado e deve ser concluído antes que você possa executar outras ações, incluindo a reabilitação do DirSync.

Se você reabilitar o DirSync, ocorrerá uma sincronização completa, o que pode levar um tempo significativo com base no número de objetos em Microsoft Entra ID.

Além disso, se BlockCloudObjectTakeoverThroughHardMatch estiver habilitado, a reabilitação do DirSync bloqueará o On-Prem para a aquisição/atualização de objetos de nuvem para todos os objetos dominados por Microsoft Entra ID. Para permitir a sincronização desses objetos, defina BlockCloudObjectTakeoverThroughHardMatch como false.

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

Este exemplo ativa a sincronização de diretórios para uma empresa.

• -EnableDirsync Especifica se a sincronização de diretório deve ser ativada para sua empresa.
• -Force Força o comando a ser executado sem solicitar a confirmação do usuário.

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

Este exemplo desativa a sincronização de diretórios para uma empresa.

• -EnableDirsync Especifica se a sincronização de diretório deve ser ativada para sua empresa.
• -Force Força o comando a ser executado sem solicitar a confirmação do usuário.
• -TenantId Especifica a ID exclusiva do locatário no qual executar a operação.

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.