PowerShell de usuario para automatizar la migración

El cmdlet de PowerShell está diseñado para administrar las tareas de migración de recursos compartidos de archivos que se ejecutan en el servicio Migration Manager y descargar informes de examen y migración.

Consulte este vínculo para asegurarse de que el equipo cumple los requisitos del sistema.

Antes de empezar

Para iniciar la migración del recurso compartido de archivos de Migration Manager:

1. Instale los agentes de Migration Manager y conéctelos al inquilino de destino con una cuenta de administrador.
2. Inicie sesión en el Centro de Administración de SharePoint como administrador y vaya a Migración/Recurso compartido de archivos.

 Descargue el archivo zip de PowerShell aquí y descomprima la compilación en una carpeta de trabajo.

Uso del cmdlet de PowerShell

Inicio de PowerShell como administrador

Ejecute los comandos siguientes:

> Get-ChildItem -Path "working_folder" -Recurse | Unblock-File

> Set-ExecutionPolicy Unrestricted -Scope CurrentUser -Force

Cierre la primera ventana de PowerShell e inicie PowerShell como administrador.

Ejecute los comandos siguientes:

> Import-Module "working_folder\Microsoft.SharePoint.MigrationManager.PowerShell.dll"

Conexión al servicio Migration Manager

> Connect-MigrationService

Este cmdlet se conecta al servicio Migration Manager. Una vez establecida una conexión, puede agregar tareas de migración e iniciar la migración.

Agregar una tarea de migración

> Add-MigrationTask

Use este cmdlet para crear una nueva tarea de migración. Después de la creación, la tarea aparece en la página Administrador de migración.

Se requieren los parámetros siguientes:

• TaskName: especifica el nombre de la tarea de migración.

• SourceUri: define la ruta de acceso del archivo de origen.

• TargetSiteUrl: indica la dirección URL del sitio de SharePoint de destino.

• TargetListName: especifica el nombre de la lista de SharePoint de destino.

Parámetros opcionales:

• ScheduleStartTime: especifica el momento en que se inicia la ejecución de la tarea. De forma predeterminada, una tarea se inicia justo después de agregarla.

• AgentGroup: Asigne un grupo de agentes para ejecutar la tarea. De forma predeterminada, se asigna el grupo "Predeterminado".

• Etiquetas: Asigne etiquetas a la tarea. Para asignar más de una etiqueta, se usan puntos y comas para separar los valores de etiqueta.

Mensaje de salida:

• "La tarea de migración se crea con el id. de tarea taskId" si la tarea se agrega correctamente al servicio de migración.

• "No se pudo agregar la tarea de migración. errorMessage" si se produce un error en el cmdlet.

Para obtener una lista completa de los parámetros admitidos, ejecute:

> Get-Help Add-MigrationTask -Full

Obtención de informes de migración

> Get-MigrationReport

Use este cmdlet para recuperar informes de tareas de migración completadas basadas en los parámetros especificados:

• OutputPath: especifica la ruta de acceso del directorio donde se guardan los informes generados.

• StartTime: filtra las tareas de migración que se iniciaron después de la fecha y hora especificadas.

• EndTime: filtra las tareas de migración que se iniciaron antes de la fecha y hora especificadas.

• TaskNameContains: filtra las tareas de migración cuyos nombres contienen la palabra clave especificada.

• Etiquetas: filtra las tareas de migración cuya etiqueta es la misma que el parámetro especificado. Si se proporcionan más de etiquetas, separadas por un punto y coma (;), se deben devolver todas las tareas cuya etiqueta sea la misma que una en el parámetro tags.

• Estado: filtra las tareas de migración cuyo estado es el mismo que el parámetro especificado. Los valores admitidos son Completed y Failed. De forma predeterminada, se descargan los informes de tareas completadas y con errores .

Si no se especifica ningún parámetro, el cmdlet descargará todos los informes completados y con errores de forma predeterminada.

Mensaje de salida:

• "Informe descargado para taskeId" para cada tarea si se descarga el archivo ZIP del informe. Y el último mensaje es una línea de resumen "Informes de migración que se descargan completados, compruebe la carpeta de salida: outputPath"

• "No se pudo descargar el informe de migración. errorMessage" si se produce un error en el cmdlet.

Para obtener una lista completa de los parámetros admitidos, ejecute:

> Get-Help Get-MigrationReport -Full

Obtención de informes de examen

> Get-ScanReport

Use este cmdlet para recuperar informes de tareas de examen completadas basadas en el parámetro especificado.

• OutputPath: especifica la ruta de acceso del directorio donde se guardan los informes generados.

• StartTime: filtra las tareas de migración que se iniciaron después de la fecha y hora especificadas.

• EndTime: filtra las tareas de migración que se iniciaron antes de la fecha y hora especificadas.

• Etiquetas: filtra las tareas de migración cuya etiqueta es la misma que el parámetro especificado. Si se proporcionan más de etiquetas, separadas por un punto y coma (;), se deben devolver todas las tareas cuya etiqueta sea la misma que una en el parámetro tags.

• Estado: filtra las tareas de migración cuyo estado es el mismo que el parámetro especificado. Los valores admitidos son Ready, Warning y Error. De forma predeterminada, se descargan los informes de las tareas Listo para migrar, Advertencia y Error .

Si no se especifica ningún parámetro, el cmdlet descargará de forma predeterminada todos los informes Listos para migrar, Advertencia y Error .

Mensaje de salida:

• "Scan log downloaded for task taskeid" for each task if the report zip file is downloaded (Examinar registro descargado para task taskeid) para cada tarea si se descarga el archivo ZIP del informe. Y el último mensaje es una línea de resumen "Scan logs downloading completed, check the output folder: outputPath".

• "No se pudo descargar el registro de examen. error_message" si se produce un error en el cmdlet.

Para obtener una lista completa de los parámetros admitidos, ejecute:

> Get-Help Get-ScanReport -Full