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