Ir al contenido principal

Crear una carpeta nueva de OneDrive para migraciones con PowerShell

Nota: 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.

No puedes aprovisionar directamente una carpeta nueva en tus OneDrives cuando ejecutas uno de nuestros scripts de PowerShell para copiar contenido a muchos OneDrive.

Con esta guía, puedes agregar una carpeta nueva en tus OneDrive para copiar tus archivos de origen antes de ejecutar el script de migración.

Nota: A finales de enero de 2026, Microsoft comenzó a retirar 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, con los parámetros -Browser y -ModernAuth. Para obtener más información sobre este cambio, consulta Cambio importante en la autenticación de "Other user" para Microsoft 365.

Requisitos previos

Nota: Debes ser administrador de la colección de sitios (SCA) en cada OneDrive, aunque tengas privilegios de administrador superiores. Los pasos 11 a 14 de la sección Preparación del script usan tus permisos de administrador de SharePoint o administrador global para agregarte como SCA. Si ya eres SCA en todos los OneDrive de tu alcance, puedes omitir los pasos 11 a 14.

En esta guía no eliminamos los permisos de administrador de la colección de sitios, porque este paso ya está incluido en otras guías de migración de OneDrive con PowerShell.

Preparación del script

Crea una carpeta en tu unidad local y una lista CSV de todos tus OneDrive con estos pasos:

  1. En tu unidad local, crea una carpeta nueva.

  2. Ponle a la carpeta el nombre que prefieras para tus OneDrive (por ejemplo, C:\Migrated data).

  3. Anota la ruta de la carpeta.

  4. En ShareGate Migrate, ve a All reports.

  5. Haz clic en Create custom report, en la esquina superior derecha.

  6. Selecciona OneDrive for Business como tipo de objeto.

  7. Haz clic en Continue without saving.

  8. Selecciona tu inquilino.

  9. Haz clic en Run.

  10. Selecciona todos tus OneDrives con la casilla de verificación que está en la parte superior de la lista.

  11. Haz clic en Edit en el menú Quick actions.

  12. Selecciona Add administrators en el menú desplegable Transformations.

  13. Busca y agrega tu cuenta en el campo Select user or group que aparece.

  14. Haz clic en Apply.

  15. Haz clic en Back dos veces para volver a los resultados del informe.

  16. Haz clic en Export, en la esquina superior derecha.

  17. Guarda el archivo en tu unidad.

  18. Abre el informe en Excel.

  19. Agrega el título ONEDRIVEURL a la segunda columna.

  20. Guarda este archivo nuevo como CSV en tu unidad (por ejemplo, C:\foldermigration.csv).

  21. Anota la ruta del archivo CSV.

Consejo: Puedes reutilizar esa misma lista CSV para tu migración de OneDrive.

Crea tu script

Copia y pega el siguiente script en la aplicación de PowerShell que prefieras.

# Define the CSV file path
$csvFile = "C:\foldermigration.csv"

# Import the CSV file
$table = Import-Csv $csvFile -Delimiter ","

# Define the destination connection
$dstSiteConnection = Connect-Site -Url "https://destinationtenantname-my.sharepoint.com/" -ModernAuth

# Set variables for site and list operations
Set-Variable dstSite, dstList

# Loop through each row in the CSV
foreach ($row in $table) {
# Clear previous values of variables
Clear-Variable dstSite
Clear-Variable dstList

# Connect to the OneDrive site
$dstSite = Connect-Site -Url $row.ONEDRIVEURL -UseCredentialsFrom $dstSiteConnection

# Get the "Documents" list from the destination site
$dstList = Get-List -Name Documents -Site $dstSite

# Import documents from the source file path to the destination list
Import-Document -SourceFilePath "C:\Migrated data" -DestinationList $dstList
}

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

  • $csvFile: Ajusta la ruta para que apunte al archivo CSV que guardaste antes.

  • $table: El delimitador es el símbolo que usa tu CSV para separar los elementos de una fila. Asegúrate de que el script use el mismo delimitador que tu archivo (una forma rápida de comprobarlo es abrir el CSV en el Bloc de notas).

  • $dstSiteConnection: Reemplaza la URL por la URL raíz de tus OneDrive en el inquilino de destino.

  • Connect-site: El comando para conectarse a un sitio de SharePoint. Si necesitas cambiar el método de autenticación a Browser authentication, consulta Connect Site.

  • Set-Variable y Clear-Variable: Estos comandos ayudan a evitar un problema en el que un error de conexión puede hacer que tus datos terminen en el OneDrive equivocado.

  • foreach: Usamos foreach para recorrer los valores de tu archivo CSV. Puedes obtener más información aquí.

  • -SourceFilePath: Reemplaza "C:\Migrated data" por la ruta de la carpeta que creaste en el paso (2).

Ejecuta el script cuando esté bien ajustado y probado.

Migra contenido a tus carpetas nuevas

Para migrar tu contenido a las carpetas nuevas de OneDrive, debes agregar -DestinationFolder "folder name" (reemplaza folder name por el nombre de tu carpeta) a la línea de copia del script de migración de OneDrive.

La línea de copia del script de migración debería verse así:

# Import documents from the source folder to the destination list and folder
Import-Document -SourceFolder $row.DIRECTORY -DestinationList $dstList -DestinationFolder "Migrated data"

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?