Cómo hacer copia de seguridad y migrar reglas de Outlook con export-inboxrule a través de EWS
🔍 WiseChecker

Cómo hacer copia de seguridad y migrar reglas de Outlook con export-inboxrule a través de EWS

Tiene un conjunto de reglas de Outlook que procesan el correo entrante, mueven mensajes a carpetas o reenvían elementos a su equipo. Cuando se muda a un nuevo buzón o a un entorno de Exchange diferente, esas reglas no se transfieren automáticamente. Recrear manualmente docenas de reglas es lento y propenso a errores.

El cmdlet Export-InboxRule en Exchange Management Shell lee las reglas directamente del servidor mediante Exchange Web Services (EWS). Exporta cada regla a un archivo CSV, que luego puede importar a otro buzón con Import-InboxRule.

Este artículo explica cómo hacer copia de seguridad de sus reglas del lado servidor de Outlook con Export-InboxRule, migrarlas a un nuevo buzón y manejar errores comunes durante el proceso.

Puntos clave: Exportar e importar reglas de Outlook mediante Exchange PowerShell

  • Export-InboxRule -Mailbox user@domain.com | Export-CSV rules.csv: Exporta todas las reglas del lado servidor del buzón especificado a un archivo CSV para copia de seguridad o migración.
  • Import-InboxRule -Mailbox newuser@domain.com -CSVData (Get-Content rules.csv -Encoding Byte): Importa las reglas guardadas al buzón de destino, recreando cada regla con sus condiciones y acciones originales.
  • Get-InboxRule -Mailbox user@domain.com: Enumera todas las reglas existentes en un buzón para que pueda verificar la exportación o comprobar conflictos antes de importar.

ADVERTISEMENT

Cómo funcionan las reglas del lado servidor de Exchange con EWS

Las reglas de Outlook pueden ser del lado cliente o del lado servidor. Las reglas del lado cliente se ejecutan solo cuando Outlook está abierto. Las reglas del lado servidor se ejecutan en el servidor de Exchange independientemente de si Outlook está en ejecución. Exchange Web Services (EWS) es la API que los cmdlets de Exchange PowerShell como Export-InboxRule usan para leer y escribir estas reglas del lado servidor.

El cmdlet Export-InboxRule se conecta al servidor de Exchange a través de EWS y recupera la colección de reglas del buzón. No depende de que Outlook esté instalado o en ejecución en la máquina donde ejecuta el comando. El cmdlet genera un conjunto de objetos de regla que puede canalizar a Export-CSV para crear un archivo de copia de seguridad portátil.

El cmdlet Import-InboxRule lee el archivo CSV y crea reglas en el buzón de destino usando los mismos puntos de conexión de EWS. El buzón de destino debe estar en un servidor de Exchange que admita EWS. Exchange Online y Exchange Server 2013 y versiones posteriores admiten estos cmdlets.

Requisitos previos

Antes de ejecutar Export-InboxRule o Import-InboxRule, verifique estos requisitos:

  • Exchange Management Shell está instalado. Para Exchange Online, instale el módulo Exchange Online PowerShell V2.
  • Tiene el rol Mail Recipients o permisos equivalentes en los buzones de origen y destino.
  • El buzón de destino debe existir y ser accesible desde el servidor de Exchange o Exchange Online.
  • Ambos buzones deben estar en la misma organización de Exchange o en Exchange Online. La migración entre inquilinos requiere pasos adicionales.
  • Las reglas que usan condiciones o acciones no admitidas en el servidor de destino no se podrán importar.

Pasos para hacer copia de seguridad y migrar reglas de Outlook

Siga los pasos a continuación para exportar reglas de un buzón de origen e importarlas a un buzón de destino. Todos los comandos se ejecutan en Exchange Management Shell o Exchange Online PowerShell.

  1. Abrir Exchange Management Shell
    En una máquina con Exchange Management Tools, haga clic en Inicio y escriba Exchange Management Shell. Haga clic con el botón derecho en el resultado y seleccione Ejecutar como administrador. Para Exchange Online, abra Windows PowerShell y ejecute Connect-ExchangeOnline con sus credenciales de administrador.
  2. Verificar las reglas existentes en el buzón de origen
    Ejecute Get-InboxRule -Mailbox source@contoso.com | Format-Table Name,Priority. Esto enumera todas las reglas del lado servidor. Anote los nombres y el recuento total para poder confirmar que la exportación capturó todo.
  3. Exportar reglas a un archivo CSV
    Ejecute Export-InboxRule -Mailbox source@contoso.com | Export-CSV -Path “C:\Backup\OutlookRules.csv” -NoTypeInformation. El parámetro -NoTypeInformation elimina la línea de encabezado que marca el tipo de objeto. El archivo se guarda en la ruta especificada.
  4. Abrir el archivo CSV para inspeccionar las reglas
    Abra el archivo CSV en Notepad o Excel. Cada fila es una regla. Las columnas incluyen Name, Description, Enabled, Priority, From, SentTo, SubjectContains, MoveToFolder y otras. Verifique que las reglas que espera aparezcan en el archivo. Si ve errores sobre condiciones no admitidas, omita o elimine esas filas antes de importar.
  5. Importar reglas al buzón de destino
    Ejecute Import-InboxRule -Mailbox target@contoso.com -CSVData (Get-Content “C:\Backup\OutlookRules.csv” -Encoding Byte). El parámetro -CSVData espera el contenido del archivo como una matriz de bytes. El argumento -Encoding Byte garantiza que el archivo se lea correctamente. Este comando crea las reglas en el buzón de destino.
  6. Verificar las reglas importadas
    Ejecute Get-InboxRule -Mailbox target@contoso.com | Format-Table Name,Enabled,Priority. Compare la lista con la lista del buzón de origen. Todas las reglas deben aparecer con los mismos nombres y prioridades.
  7. Probar una regla en el buzón de destino
    Envíe un correo electrónico de prueba desde una cuenta externa que coincida con una de las condiciones de la regla importada. Por ejemplo, si una regla mueve mensajes de un remitente específico a una carpeta, compruebe que el correo electrónico aparezca en la carpeta correcta en unos minutos.

ADVERTISEMENT

Errores comunes de importación y cómo manejarlos

La importación de reglas de un buzón a otro puede fallar por varias razones. A continuación se presentan los problemas más frecuentes y sus soluciones.

La regla usa una condición o acción no admitida en el destino

Algunas condiciones de regla, como formularios o clasificaciones de mensajes, pueden no existir en el servidor de destino. Abra el archivo CSV en Excel. Elimine la fila completa de cualquier regla que use condiciones no admitidas. Guarde el archivo y ejecute la importación de nuevo.

El buzón de destino ya tiene el número máximo de reglas

Exchange Online permite hasta 256 reglas por buzón. Exchange Server 2016 y 2019 permiten hasta 256 reglas. Si el buzón de destino ya tiene 256 reglas, la importación falla. Ejecute Get-InboxRule -Mailbox target@contoso.com | Measure-Object para contar las reglas existentes. Elimine las reglas innecesarias del destino antes de importar.

La acción MoveToFolder hace referencia a una carpeta que no existe

Si una regla mueve mensajes a una carpeta llamada “Project X” pero esa carpeta no existe en el buzón de destino, la regla se crea pero la acción falla silenciosamente. Cree las carpetas faltantes en el buzón de destino antes de importar las reglas. Como alternativa, edite el archivo CSV y cambie el nombre de la carpeta a una carpeta existente.

La importación falla con error de acceso denegado

La cuenta que ejecuta Import-InboxRule debe tener permiso Full Access en el buzón de destino. Si recibe un error de acceso denegado, agregue el permiso Full Access con Add-MailboxPermission -Identity target@contoso.com -User admin@contoso.com -AccessRights FullAccess. Luego ejecute la importación de nuevo.

Export-InboxRule vs recreación manual de reglas: diferencias clave

Elemento Export-InboxRule a través de EWS Recreación manual de reglas en Outlook
Tiempo necesario para 20 reglas Menos de 5 minutos 30 a 60 minutos
Riesgo de error Bajo si se inspecciona el CSV antes de importar Alto debido a errores tipográficos y condiciones faltantes
Requiere instalación de Outlook No
Maneja todas las condiciones del lado servidor Sí, exporta todas las condiciones admitidas Sí, pero cada regla debe recrearse desde cero
Admite migración masiva Sí, un archivo CSV para todas las reglas No, cada regla se crea individualmente
Funciona entre inquilinos de Exchange Online No, requiere el mismo inquilino o local a local Sí, pero manual

Export-InboxRule es el método más rápido y preciso cuando ambos buzones están en la misma organización o inquilino de Exchange. La recreación manual es la alternativa cuando se aplican restricciones entre inquilinos.

Ahora puede hacer copia de seguridad de sus reglas del lado servidor de Outlook en un archivo CSV y migrarlas a un nuevo buzón con Export-InboxRule e Import-InboxRule. Todo el proceso toma unos minutos y conserva los nombres, las condiciones y las acciones de las reglas exactamente como estaban en el origen. Para el mantenimiento regular, ejecute Export-InboxRule mensualmente y guarde el archivo CSV en una ubicación segura. Si necesita auditar reglas en muchos buzones, combine Get-InboxRule con un script que genere el recuento de reglas y la fecha de última modificación de cada buzón.

ADVERTISEMENT