robocopy
Copia los datos de archivo de una ubicación a otra.
Sintaxis
robocopy <source> <destination> [<file>[ ...]] [<options>]
Por ejemplo, para copiar un archivo denominado yearly-report.mov de c:\reports a un recurso compartido de archivos \\marketing\videos mientras se habilita el multiproceso para un mayor rendimiento (con el parámetro /mt ) y la capacidad de reiniciar la transferencia en caso de que se interrumpa (con el parámetro /z ), escriba:
robocopy c:\reports "\\marketing\videos" yearly-report.mov /mt /z
Importante
Si se copian datos de la raíz de un dispositivo, el directorio de destino adopta los atributos "ocultos" y "system" durante el proceso de copia.
Parámetros
| Parámetro | Descripción |
|---|---|
<source> |
Especifica la ruta de acceso del directorio de origen. |
<destination> |
Especifica la ruta de acceso del directorio de destino. |
<file> |
Especifica el archivo o los archivos que se van a copiar. Se admiten caracteres comodín (* o ?). Si no especifica este parámetro, *.* se usa como valor predeterminado. |
<options> |
Especifica las opciones a usar con el comando robocopy, incluyendo las opciones de copia, archivo, reintento, registro y trabajo. |
Opciones de copia
| Opción | Descripción |
|---|---|
| /s | Copia los subdirectorios. Esta opción excluye automáticamente los directorios vacíos. |
| /e | Copia los subdirectorios. Esta opción incluye automáticamente directorios vacíos. |
/lev:<n> |
Copia solo los n niveles superiores del árbol de directorios de origen. |
| /z | Copia los archivos en modo de reinicio. En el modo reiniciable, si se interrumpe la copia de un archivo, robocopy puede retomarla donde la dejó en lugar de volver a copiar todo el archivo. |
| /b | Copia los archivos en modo de copia de seguridad. En el modo de copia de seguridad, robocopy invalida la configuración de permisos de archivos y carpetas (ACL), lo que podría bloquear el acceso. |
| /zb | Copia los archivos en modo de reinicio. Si se deniega el acceso a archivos, cambia al modo de copia de seguridad. |
| /j | Copia mediante E/S sin búfer (recomendado para archivos grandes). |
| /efsraw | Copia todos los archivos cifrados en el modo sin procesar de EFS. |
/copy:<copyflags> |
Especifica qué propiedades de archivo se van a copiar. Los valores válidos para esta opción son:
|
/dcopy:<copyflags> |
Especifica qué copiar en directorios. Los valores válidos para esta opción son:
|
| /s | Copia archivos con seguridad (equivalente a /copy:DATS). |
| /copyall | Copia toda la información del archivo (equivalente a /copy:DATSOU). |
| /nocopy | No copia información de archivo (útil con /purge). |
| /secfix | Corrige la seguridad de los archivos en todos los archivos, incluso los omitidos. |
| /timfix | Corrige los tiempos de todos los archivos, incluso los omitidos. |
| /purge | Elimina los archivos y directorios de destino que ya no existen en el origen. Si usa esta opción con la opción /e y un directorio de destino, permite que la configuración de seguridad del directorio de destino no se sobrescriba. |
| /mir | Refleja un árbol de directorios (equivalente a /e más /purge). El uso de esta opción con la opción /e y un directorio de destino sobrescribe la configuración de seguridad del directorio de destino. |
| /mov | Mueve los archivos y los elimina del origen después de copiarlos. |
| /move | Mueve archivos y directorios y los elimina del origen después de copiarlos. |
| /a+:[RASHCNET] | Agrega los atributos especificados a los archivos copiados. Los valores válidos para esta opción son:
|
| /a-:[RASHCNETO] | Quita los atributos especificados de los archivos copiados. Los valores válidos para esta opción son:
|
| /create | Crea un árbol de directorios y solo archivos de longitud cero. |
| /fat | Crea archivos de destino usando solo nombres de archivo FAT de longitud de caracteres de 8,3. |
| /256 | Desactiva la compatibilidad con rutas de acceso de más de 256 caracteres. |
/mon:<n> |
Supervisa el origen y se ejecuta de nuevo cuando se detectan más de n cambios. |
/mot:<m> |
Supervisa el origen y se ejecuta de nuevo en m minutos si se detectan cambios. |
| /rh:hhmm-hhmm | Especifique los tiempos de ejecución en los que se pueden iniciar nuevas copias. |
| /pf | Comprueba los tiempos de ejecución por archivo (no por pase). |
/ipg:<n> |
Especifica el espacio entre paquetes para liberar ancho de banda en las líneas lentas. |
| /sj | Copia los cruces (vínculos simbólicos) en la ruta de acceso de destino en lugar de los objetivos de los vínculos. |
| /sl | No seguir los vínculos simbólicos y, en su lugar, crear una copia del vínculo. |
/mt:<n> |
Crea copias multiproceso con n subprocesos.
n debe ser un número entero entre 1 y 128. El valor predeterminado para n es 8. Para mejorar el rendimiento, redirija la salida mediante la opción /log. El parámetro /mt no se puede usar con los parámetros /ipg y /efsraw. |
| /nodcopy | No copia ninguna información de directorio (se hace de manera predeterminada /dcopy:DA). |
| /nooffload | Copia archivos sin usar el mecanismo de descarga de copia de Windows. |
| /compress | Solicita la compresión de red durante la transferencia de archivos, si procede. |
/sparse:<y|n> |
Habilita o deshabilita la conservación del estado disperso de los archivos durante el proceso de copia. Si no se selecciona ninguna opción, el valor predeterminado es sí (habilitado). |
| /noclone | No intenta bloquear la clonación como una optimización. |
Importante
Al usar la opción de copia /secfix, especifique el tipo de información de seguridad que quiere copiar, usando una de estas opciones de copia adicionales:
- /copyall
- /copy:o
- /copy:s
- /copy:u
- /sec
Nota:
El parámetro /mt se introdujo en Windows Server 2008 R2 y su funcionalidad se aplica a las versiones actuales de Windows Server.
Copiar opciones de limitación de archivos
| Opción | Descripción |
|---|---|
/iomaxsize:<n>[kmg] |
El tamaño máximo de E/S solicitado por ciclo de lectura y escritura en nkilobytes, megabytes o gigabytes. |
/iorate:<n>[kmg] |
Tasa de e/s solicitada en nkilobytes megabytes, o gigabytes por segundo. |
/threshold:<n>[kmg] |
Umbral de tamaño de archivo para la limitación en nkilobytes, megabytes o gigabytes (véase comentarios). |
Estas opciones de limitación se usan para especificar el ancho de banda de E/S máximo que Robocopy permite usar en bytes por segundo. Si no se especifican en bytes por segundo, se pueden usar números enteros si se especifica k, m o g. El ancho de banda de E/S mínimo que se limita es de 524288 bytes aunque se especifique un valor menor.
Opciones de selección de archivos
| Opción | Descripción |
|---|---|
| /a | Copia solo los archivos para los que se establece el atributo Archive. |
| /m | Copia solo los archivos para los que se establece el atributo Archive y restablece el atributo Archive. |
/ia:[RASHCNETO] |
Incluye solo los archivos para los que se establece cualquiera de los atributos especificados. Los valores válidos para esta opción son:
|
/xa:[RASHCNETO] |
Excluye archivos que tienen cualquiera de los atributos especificados establecidos. Los valores válidos para esta opción son:
|
/xf <filename>[ ...] |
Excluye los archivos que coinciden con los nombres o rutas de acceso especificados. Se admiten caracteres comodín (* y ?). |
/xd <directory>[ ...] |
Excluye los directorios que coinciden con los nombres y rutas de acceso especificados. |
| /xc | Excluye los archivos existentes con la misma marca de tiempo, pero tamaños de archivo diferentes. |
| /xn | Los archivos de directorio de origen más recientes que el destino se excluyen de la copia. |
| /xo | Los archivos de directorio de origen anteriores al destino se excluyen de la copia. |
| /xx | Excluye archivos y directorios adicionales presentes en el destino, pero no en el origen. La exclusión de archivos adicionales no elimina los archivos del destino. |
| /xl | Excluye los archivos y directorios "solitarios" presentes en el origen, pero no en el destino. Excluir archivos solitarios impide que se agreguen nuevos archivos al destino. |
| /im | Incluir archivos modificados (tiempos de cambio diferentes). |
| /is | Incluye los mismos archivos. Los mismos archivos son idénticos en nombre, tamaño, tiempos y todos los atributos. |
| /it | Incluye archivos "retocados". Los archivos retocados tienen el mismo nombre, tamaño y tiempos, pero atributos diferentes. |
/max:<n> |
Especifica el tamaño máximo de archivo (para excluir archivos mayores que n bytes). |
/min:<n> |
Especifica el tamaño mínimo del archivo (para excluir archivos menores que n bytes). |
/maxage:<n> |
Especifica la antigüedad máxima del archivo para excluir archivos anteriores a n días o una fecha basada en cuándo se modificaron los archivos por última vez . |
/minage:<n> |
Especifica la antigüedad mínima del archivo para excluir los archivos más recientes que n días o una fecha en función de cuándo se modificaron los archivos por última vez . |
/maxlad:<n> |
Especifica la fecha máxima de último acceso (excluye los archivos sin usar desde n). |
/minlad:<n> |
Especifica la fecha mínima de último acceso (excluye los archivos usados desde n) Si n es menor que 1 900, n especifica el número de días. De lo contrario, n especifica una fecha con el formato AAAAMMDD. |
| /xj | Excluye los puntos de unión, que normalmente se incluyen de forma predeterminada. |
| /fft | Se da por supuesto que se trata de tiempos de archivos FAT (precisión de dos segundos). |
| /dst | Compensa las diferencias horarias DST de una hora. |
| /xjd | Excluye los puntos de unión de los directorios. |
| /xjf | Excluye los puntos de unión de los archivos. |
Opciones de reintento
| Opción | Descripción |
|---|---|
/r:<n> |
Especifica el número de reintentos en las copias con errores. El valor predeterminado de n es 1 000 000 (un millón de reintentos). |
/w:<n> |
Especifica el tiempo de espera entre reintentos, en segundos. El valor predeterminado de n es 30 (tiempo de espera de 30 segundos). |
| /reg | Guarda los valores especificados en las opciones /r y /w como valores predeterminados en el registro. |
| /tbd | Especifica que el sistema espera a que se definan los nombres de los recursos compartidos (error de reintento 67). |
| /lfsm | Operar en modo de poco espacio disponible, que permite copiar, pausar y reanudar (consulte Comentarios). |
/lfsm:<n>[kmg] |
Especifica el tamaño del piso en nkilobytes, megabytes o gigabytes. |
Opciones de registro
| Opción | Descripción |
|---|---|
| /l | Especifica que solo se enumerarán los archivos (y no se copiarán, eliminarán ni se les pondrá una marca de tiempo). |
| /x | Notifica todos los archivos adicionales, no solo los seleccionados. |
| /v | Genera una salida detallada y muestra todos los archivos omitidos. |
| /ts | Incluye marcas de tiempo de archivo de origen en la salida. |
| /fp | Incluye los nombres de ruta de acceso completos de los archivos en la salida. |
| /bytes | Imprime tamaños como bytes. |
| /ns | Especifica que los tamaños de archivo no se van a registrar. |
| /nc | Especifica que las clases de archivo no se van a registrar. |
| /nfl | Especifica que los nombres de archivo no se van a registrar. |
| /ndl | Especifica que los nombres de directorio no se van a registrar. |
| /np | Especifica que no se muestra el progreso de la operación de copia (el número de archivos o directorios copiados hasta ahora). |
| /eta | Muestra el tiempo estimado de llegada (ETA) de los archivos copiados. |
/log:<logfile> |
Escribe la salida del estado en el archivo de registro (sobrescribe el archivo de registro existente). |
/log+:<logfile> |
Escribe la salida del estado en el archivo de registro (sobrescribe el archivo de registro existente). |
/unilog:<logfile> |
Escribe la salida de estado en el archivo de registro como texto Unicode (sobrescribe el archivo de registro existente). |
/unilog+:<logfile> |
Escribe la salida de estado en el archivo de registro como texto Unicode (anexa la salida al archivo de registro existente). |
| /tee | Escribe la salida de estado en la ventana de la consola y en el archivo de registro. |
| /njh | Especifica que no hay ningún encabezado de trabajo. |
| /njs | Especifica que no hay ningún resumen del trabajo. |
| /unicode | Muestra la salida de estado como texto Unicode. |
Opciones del trabajo
| Opción | Descripción |
|---|---|
/job:<jobname> |
Especifica que los parámetros se van a derivar del archivo de trabajo con nombre. Para ejecutar /job:jobname, primero debe ejecutar el parámetro /save:jobname para crear el archivo de trabajo. |
/save:<jobname> |
Especifica que los parámetros se guardarán en el archivo de trabajo con nombre. Debe ejecutarse antes de ejecutar /job:jobname. Todas las opciones de copia, reintento y registro deben especificarse antes de este parámetro. |
| /quit | Sale después de procesar la línea de comandos (para ver los parámetros). |
| /nosd | Indica que no se ha especificado ningún directorio de origen. |
| /nodd | Indica que no se ha especificado ningún directorio de destino. |
| /if | Incluye los archivos especificados. |
Comentarios
El uso de /PURGE o /MIR en el directorio raíz del volumen anteriormente provocaba que robocopy aplicara la operación solicitada también en los archivos dentro del directorio de Información del volumen del sistema. Este ya no es el caso como si se especifica, robocopy omite los archivos o directorios con ese nombre en los directorios de origen y destino de nivel superior de la sesión de copia.
La clasificación de archivos modificados solo se aplica cuando los sistemas de archivos de origen y destino son compatibles con las marcas de tiempo de cambio, como NTFS, y los archivos de origen y destino tienen tiempos de cambio diferentes pero, por lo demás, son iguales. Estos archivos no se copian de forma predeterminada. Especifique /IM para incluirlos.
La marca /DCOPY:E solicita que se deba intentar la copia extendida de atributos para los directorios. Robocopy continúa la operación de copia incluso si no se pudieron copiar las entidades de certificación de un directorio. Esta marca no se incluye en /COPYALL.
Si se especifican /IoMaxSize o /IoRate, robocopy permite la limitación de archivos de copia para reducir la carga del sistema. Ambos se pueden ajustar a valores óptimos y parámetros de copia, pero el sistema y robocopy pueden ajustarlos a los valores permitidos según sea necesario.
Si se usa /Threshold, especifica un tamaño mínimo de archivo para activar la limitación. Los archivos por debajo de ese tamaño no están limitados. Los valores de los tres parámetros pueden ir seguidos de un carácter de sufijo opcional, como [KMG] (kilobytes, megabytes, gigabytes).
El uso de /LFSM solicita que la robocopia funcione en "modo de poco espacio disponible". En este modo, robocopy se pausa cada vez que una copia de archivos provocaría que el espacio libre del volumen de destino vaya por debajo de un valor de "floor". Este valor puede especificarse explícitamente usando la marca /LFSM:n[KMG].
Si /LFSM se especifica sin ningún valor floor explícito, floor se establece en el 10 % del tamaño del volumen de destino. El modo de poco espacio disponible es incompatible con /MT y /EFSRAW.
Códigos de salida (retorno)
| Valor | Descripción |
|---|---|
| 0 | No se copiaron archivos. No se encontró ningún error. No hay archivos que no coincidan. Los archivos ya existen en el directorio de destino; por lo tanto, se omitió la operación de copia. |
| 1 | Todos los archivos se copiaron correctamente. |
| 2 | Hay algunos archivos adicionales en el directorio de destino que no están presentes en el directorio de origen. No se copiaron archivos. |
| 3 | Se copiaron algunos archivos. Existían archivos adicionales. No se encontró ningún error. |
| 5 | Se copiaron algunos archivos. Algunos archivos no coincidían. No se encontró ningún error. |
| 6 | Existen archivos adicionales y archivos que no coinciden. No se copiaron archivos y no se encontraron errores, lo que significa que los archivos ya existen en el directorio de destino. |
| 7 | Los archivos se copiaron, había un error de coincidencia de archivo y había archivos adicionales presentes. |
| 8 | Varios archivos no se copiaron. |
Nota:
Cualquier valor igual o mayor que 8 indica que hubo al menos un error durante la operación de copia.
Ejemplos
Se recomienda encarecidamente al ejecutar el comando robocopy para crear un archivo de registro que se pueda ver una vez que el proceso haya completado la comprobación de su integridad. En los ejemplos siguientes, todos usan el parámetro /LOG:. Para anexar cualquier información de registro al mismo archivo de registro, use el parámetro /LOG+: en su lugar.
Para copiar todos los archivos y subdirectorios, incluidos los directorios vacíos, de la carpeta "Registros" a la carpeta "Backup" de la unidad "D", escriba:
robocopy C:\Users\Admin\Records D:\Backup /E /ZB /LOG:C:\Logs\Backup.log
Para reflejar el contenido de la carpeta "Registros" en la carpeta "Copia de seguridad" de la unidad "D", elimine los archivos del destino que no existen en el origen con 2 reintentos y espere 5 segundos entre cada reintento, escriba:
robocopy C:\Users\Admin\Records D:\Backup /MIR /R:2 /W:5 /LOG:C:\Logs\Backup.log
Para copiar todos los archivos y subdirectorios que no están vacíos de la carpeta "Registros" a la carpeta "Backup" de la unidad "D", conservando los datos, atributos y marcas de tiempo del archivo con 16 operaciones de copia multiproceso, escriba:
robocopy C:\Users\Admin\Records D:\Backup /S /E /COPY:DAT /MT:16 /LOG:C:\Logs\Backup.log
Para mover archivos y subdirectorios, excepto directorios vacíos, de la carpeta "Registros" a la carpeta "Backup" de la unidad "D" y excluir archivos anteriores a 7 días, escriba:
robocopy C:\Users\Admin\Records D:\Backup /S /MAXAGE:7 /MOV /LOG:C:\Logs\Backup.log
Para copiar todos los archivos y subdirectorios, incluidos los directorios vacíos, de la carpeta "Registros" a la carpeta "Backup" de la unidad "D" que muestra el tiempo estimado para cada archivo y elimina los archivos y directorios del destino que no existen desde el origen, escriba:
robocopy C:\Users\Admin\Records D:\Backup /ETA /PURGE /LOG:C:\Logs\Backup.log
Para copiar todos los archivos y subdirectorios de la carpeta denominada "Records" en la unidad "C" en una carpeta denominada "Backup" en la unidad "D", al tiempo que limita la velocidad de E/S a 1 megabyte por segundo durante la operación de copia, escriba:
robocopy C:\Records D:\Backup /iorate:1m
Para omitir la copia de archivos de una carpeta de origen a una carpeta de destino cuando los archivos ya existen en la carpeta de destino, independientemente de si son más recientes, antiguos o modificados, escriba:
robocopy C:\Source C:\Destination /XC /XN /XO