Ir al contenido principal

Copiar varios buzones con PowerShell

Usa PowerShell para copiar varios buzones de Microsoft 365 por lotes a partir de un archivo de asignaciones.

Notas:

La integración con PowerShell requiere un paquete ShareGate Migration Pro o Migration Ultimate. No está disponible con Migration Essentials Mailbox ni Migration Essentials Files.

A finales de enero de 2026, Microsoft comenzó a dejar de admitir la cookie IDCRL, lo que significa que en la mayoría de los inquilinos de Microsoft 365 solo funcionarán los métodos de autenticación Browser y Modern authentication, con los parámetros -Browser y -ModernAuth. Para obtener más información, consulta Cambio importante en la autenticación "Other user" para Microsoft 365.

Usa PowerShell para copiar varios buzones de Microsoft 365 a partir de un archivo de asignaciones. Este enfoque te permite procesar los buzones por lotes y exportar un informe después de cada lote, lo que hace más manejables tus migraciones de buzones más grandes.

Cómo hacerlo

Para migrar tus buzones, necesitarás un archivo de asignaciones y un script de PowerShell que lea ese archivo para copiar los buzones por lotes.

Configurar tu archivo de asignaciones

Tu archivo de asignaciones es un CSV que empareja cada buzón de origen con su destino. Configúralo antes de ejecutar la migración para revisar y ajustar los emparejamientos.

Con PowerShell

Ejecuta el siguiente script para generar automáticamente tu archivo de asignaciones. ShareGate Migrate hace coincidir los buzones de origen y de destino por nombre para mostrar.

$source = Connect-MicrosoftOnline
$destination = Connect-MicrosoftOnline

Export-MailboxMappings -SourceConnection $source -DestinationConnection $destination -Path "C:\MyMappings\"

Cambia "C:\MyMappings\" por la carpeta de tu disco donde quieres guardar el archivo de asignaciones. Consulta Export-MailboxMappings para ver los parámetros disponibles.

Los buzones sin coincidencia en el destino se dejan en blanco en el CSV. Revisa el archivo y completa los emparejamientos que falten antes de continuar.

Desde ShareGate Migrate

  1. Sigue los pasos de Copy mailboxes - Mappings para configurar tu operación y llegar a la pantalla de asignaciones.

  2. Haz clic en el ícono Export mappings.

  3. Guarda el archivo CSV y anota su ruta.

Cuando tengas tu archivo de asignaciones, ábrelo y confirma los emparejamientos. Puedes editar el CSV para agregar, quitar o ajustar cualquier coincidencia de origen a destino antes de ejecutar la migración.

Crear tu script

Copia y pega el siguiente script en la aplicación de PowerShell que prefieras. Cambia los valores de -Path en $mappings y $csv para que apunten al archivo de asignaciones que guardaste en la sección anterior.

$sourceConnection = Connect-MicrosoftOnline
$destinationConnection = Connect-MicrosoftOnline

$options = New-MailboxCopyOptions -IncludeEmails
$mappings = Import-MailboxMappings -SourceConnection $sourceConnection -DestinationConnection $destinationConnection -Path "C:\MyMappings\SharegateMailboxesMapping.csv"

$csv = Import-Csv -Path "C:\MyMappings\SharegateMailboxesMapping.csv"

# Ensure $csv is treated as an array, even with a single mailbox
$csv = @($csv)

# Initialize the starting index and the batch size
$index = 0
$batchSize = 16

while ($index -lt $csv.Count) {
# Select the current batch
$guids = $csv | Select-Object -Skip $index -First $batchSize -ExpandProperty "Source user id"

# Fetch the mailboxes
$mailboxes = Get-Mailbox -Id $guids -Connection $sourceConnection -AllowMultiple

# Copy the mailboxes
$result = Copy-Mailbox -SourceConnection $sourceConnection -DestinationConnection $destinationConnection -CopyOptions $options -MappingSettings $mappings -Mailboxes $mailboxes

# Export the report
Export-Report -SessionId $result.SessionId

# Increment index for next batch
$index += $batchSize
}

Ajusta el script para que funcione en tu entorno. Estas son algunas pautas:

  • $sourceConnection y $destinationConnection: Se conectan a tus inquilinos de Microsoft 365 de origen y de destino. Consulta Connect-MicrosoftOnline para ver las opciones de autenticación.

  • $options: Define el contenido que se incluirá en la copia. Reemplaza -IncludeEmails por las opciones de tu migración. Consulta New-MailboxCopyOptions para ver los parámetros disponibles.

  • $mappings y $csv: Ambos deben apuntar al mismo archivo de asignaciones. Cambia -Path e Import-Csv -Path para que coincidan con el archivo que guardaste en la sección anterior.

  • $batchSize: El número de buzones que se procesan por lote. Comienza con 16 y ajústalo según el rendimiento de tu entorno.

  • $guids: Extrae del CSV los ID de los usuarios de origen del lote actual.

  • $mailboxes: Obtiene los objetos de buzón del lote actual. El parámetro -AllowMultiple es obligatorio cuando se pasa más de un ID. Consulta Get-Mailbox para obtener más detalles.

  • $result: Contiene el resultado de la operación de copia, incluido el ID de sesión que usa Export-Report.

  • Export-Report: Exporta el informe de migración de cada lote cuando termina. Consulta Export-Report.

Ejecuta tu script una vez que esté bien ajustado y probado.

Consideraciones

  • La Modern authentication con -ModernAuth es el método de autenticación más seguro para Microsoft 365 y se puede usar con las variables Username y Password siempre que no se exija la autenticación multifactor (MFA). Consulta Connect-MicrosoftOnline para conocer las distintas opciones de autenticación o para cambiar a la Browser authentication si es necesario.

  • Los informes de migración se generan por lote. El script exporta automáticamente el informe de cada lote con Export-Report.

  • Puedes programar tu migración con PowerShell para ejecutarla fuera del horario laboral y optimizar el rendimiento.

  • Para realizar una migración incremental, vuelve a ejecutar el script después de la copia inicial para sincronizar solo los elementos que se agregaron o cambiaron desde la última ejecución.

  • Tamaño del lote: El tamaño de lote adecuado depende del tamaño de tus buzones y de las condiciones de red. Comienza con 16 y ajústalo según el rendimiento. Los lotes más pequeños son más fáciles de supervisar y de solucionar si algo falla.

  • Errores del script y pruebas: Prueba tu script con un pequeño grupo de buzones antes de ejecutarlo en todo tu entorno. Las pruebas ayudan a identificar posibles problemas antes de que afecten a muchos usuarios.

Este artículo fue traducido con inteligencia artificial. En caso de duda, consulta la versión original en inglés.

¿Ha quedado contestada tu pregunta?