Set-EntraDirSyncEnabled

Ativa ou desativa a sincronização de diretórios numa empresa.

Sintaxe

Default (Predefinição)

Set-EntraDirSyncEnabled

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

Descrição

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

Um novo principal de serviço aparece no seu tenant quando ativa ou reativa o DirSync. Tem o appId 6bf85cfa-ac8a-4be5-b5de-425a0d0dc016 e o nome de exibição Microsoft Entra AD Synchronization Service.

Desativar o DirSync pode demorar até 72 horas, dependendo do número de objetos na sua subscrição na cloud. Uma vez desativado, o processo não pode ser cancelado e deve ser concluído antes de poder tomar mais medidas, incluindo reativar o DirSync.

Se reativar o DirSync, ocorrerá uma sincronização completa, que pode demorar bastante tempo consoante o número de objetos no Microsoft Entra ID.

Além disso, se BlockCloudObjectTakeoverThroughHardMatch estiver ativado, reativar o DirSync bloqueará a tomada de controlo/atualizações de objetos On-Premises para cloud para todos os objetos masterizados pelo Microsoft Entra ID. Para permitir a sincronização destes objetos, defina BlockCloudObjectTakeoverThroughHardMatch para falso.

Exemplos

Exemplo 1: Ativar a sincronização de diretórios

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 deve ativar a sincronização de diretórios para a sua empresa.
  • -Force Força o comando a correr sem pedir confirmação do utilizador.

Exemplo 2: Desligar a sincronização de diretórios

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 numa empresa.

  • -EnableDirsync Especifica se deve ativar a sincronização de diretórios para a sua empresa.
  • -Force Força o comando a correr sem pedir confirmação do utilizador.
  • -TenantId Especifica o ID único do inquilino sobre o qual realizar a operação.

Parâmetros

-EnableDirsync

Especifica se deve ativar a sincronização de diretórios para a sua empresa.

Propriedades dos parâmetros

Tipo:System.Boolean
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-Force

Força o comando a ser executado sem pedir a confirmação do usuário.

Propriedades dos parâmetros

Tipo:System.Management.Automation.SwitchParameter
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-TenantId

Especifica o ID único do inquilino sobre o qual realizar a operação. Este parâmetro proporciona compatibilidade com o Azure AD e o MSOnline para cenários parceiros. TenantID é o ID do tenant do utilizador iniciado sessão.

Propriedades dos parâmetros

Tipo:System.String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

CommonParameters

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.