Set-EntraDirSyncEnabled

Módulo:
Microsoft.Entra.DirectoryManagement Module v1.3

Activa o desactiva la sincronización de directorios para una empresa.

Sintaxis

Default (valor predeterminado) 

Set-EntraDirSyncEnabled

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

Description

El Set-EntraDirSyncEnabled cmdlet activa o desactiva la sincronización de directorios para una empresa.

Aparece una nueva entidad de servicio en el inquilino al habilitar o volver a habilitar DirSync. Tiene appId 6bf85cfa-ac8a-4be5-b5de-425a0d0dc016 y el nombre para mostrar Microsoft Entra servicio de sincronización de AD.

La desactivación de DirSync puede tardar hasta 72 horas, en función del número de objetos de la suscripción a la nube. Una vez deshabilitado, el proceso no se puede cancelar y debe completarse antes de poder realizar más acciones, incluida la nueva habilitación de DirSync.

Si vuelve a habilitar DirSync, se producirá una sincronización completa, lo que puede tardar mucho tiempo en función del número de objetos de Microsoft Entra ID.

Además, si BlockCloudObjectTakeoverThroughHardMatch está habilitado, volver a habilitar DirSync bloqueará la adquisición o actualizaciones de objetos en la nube para todos los objetos con patrón Microsoft Entra ID. Para permitir la sincronización de estos objetos, establezca en BlockCloudObjectTakeoverThroughHardMatch false.

Ejemplos

Ejemplo 1: Activar la sincronización de directorios

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

En este ejemplo se activa la sincronización de directorios para una empresa.

  • -EnableDirsync Especifica si se va a activar la sincronización de directorios para la empresa.
  • -Force Obliga a que el comando se ejecute sin pedir confirmación del usuario.

Ejemplo 2: Desactivar la sincronización de directorios

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

En este ejemplo se desactiva la sincronización de directorios para una empresa.

  • -EnableDirsync Especifica si se va a activar la sincronización de directorios para la empresa.
  • -Force Obliga a que el comando se ejecute sin pedir confirmación del usuario.
  • -TenantId Especifica el identificador único del inquilino en el que se va a realizar la operación.

Parámetros

-EnableDirsync

Especifica si se va a activar la sincronización de directorios para la empresa.

Propiedades de parámetro

Tipo:System.Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Force

Obliga a que el comando se ejecute sin pedir confirmación del usuario.

Propiedades de parámetro

Tipo:System.Management.Automation.SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-TenantId

Especifica el identificador único del inquilino en el que se va a realizar la operación. Este parámetro proporciona compatibilidad con Azure AD y MSOnline para escenarios de asociados. TenantID es el identificador de inquilino del usuario que ha iniciado sesión.

Propiedades de parámetro

Tipo:System.String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.