robocopy

Copie les données de fichier d’un emplacement vers un autre.

Syntaxe

robocopy <source> <destination> [<file>[ ...]] [<options>]

Par exemple, pour copier un fichier nommé annuel-report.mov de c:\reports vers un partage de fichiers \\marketing\videos tout en activant le multithreading pour des performances plus élevées (avec le paramètre /mt ) et la possibilité de redémarrer le transfert en cas d’interruption (avec le paramètre /z ), tapez :

robocopy c:\reports '\\marketing\videos' yearly-report.mov /mt /z

Paramètres

Paramètre Description
<source> Spécifie le chemin d’accès au répertoire source.
<destination> Spécifie le chemin d’accès au répertoire de destination.
<file> Spécifie le fichier ou les fichiers à copier. Les caractères génériques (* ou ?) sont pris en charge. Si vous ne spécifiez pas ce paramètre, *.* est utilisé comme valeur par défaut.
<options> Spécifie les options à utiliser avec la commande robocopy , notamment les options de copie, de fichier, de nouvelle tentative, de journalisation et de travail .

Options de copie

Option Description
/s Copie les sous-répertoires. Cette option exclut automatiquement les répertoires vides.
/e Copie les sous-répertoires. Cette option inclut automatiquement des répertoires vides.
/Lev:<n> Copie uniquement les n niveaux supérieurs de l’arborescence de répertoires sources.
/z Copie les fichiers en mode redémarré. En mode redémarré, si une copie de fichier doit être interrompue, Robocopy peut reprendre là où il s’est arrêté au lieu de recopier l’intégralité du fichier.
/b Copie les fichiers en mode sauvegarde. Le mode de sauvegarde permet à Robocopy de remplacer les paramètres d’autorisation de fichier et de dossier (ACL). Cela vous permet de copier des fichiers auquel vous n’avez peut-être pas accès, en supposant qu’il est exécuté sous un compte disposant de privilèges suffisants.
/zb Copie les fichiers en mode redémarré. Si l’accès au fichier est refusé, bascule vers le mode de sauvegarde.
/J Copies utilisant des E/S non sauvegardées (recommandées pour les fichiers volumineux).
/efsraw Copie tous les fichiers chiffrés en mode RAW EFS.
/Copie:<copyflags> Spécifie les propriétés de fichier à copier. Les valeurs valides pour cette option sont les suivantes :
  • D - Données
  • A - Attributs
  • T - Horodatages
  • S - Liste de contrôle d’accès NTFS (ACL)
  • O - Informations sur le propriétaire
  • U - Informations d’audit
La valeur par défaut de cette option est DAT (données, attributs et horodatages).
/dcopy :<copyflags> Spécifie les éléments à copier dans les répertoires. Les valeurs valides pour cette option sont les suivantes :
  • D - Données
  • A - Attributs
  • T - Horodatages
La valeur par défaut de cette option est DA (données et attributs).
/s Copie des fichiers avec sécurité (équivalent à /copy:DATS).
/copyall Copie toutes les informations de fichier (équivalentes à /copy:DATSOU).
/nocopy Copie aucune information de fichier (utile avec /purge).
/secfix Corrige la sécurité des fichiers sur tous les fichiers, même ignorés.
/timfix Corrige les heures de fichier sur tous les fichiers, même ignorés.
/Purge Supprime les fichiers et répertoires de destination qui n’existent plus dans la source. L’utilisation de cette option avec l’option /e et un répertoire de destination permet de ne pas remplacer les paramètres de sécurité du répertoire de destination.
/Mir Met en miroir une arborescence de répertoires (équivalente à /e plus /purge). À l’aide de cette option avec l’option /e et un répertoire de destination, remplace les paramètres de sécurité du répertoire de destination.
/Mov Déplace les fichiers et les supprime de la source après leur copie.
/Déplacer Déplace les fichiers et les répertoires, puis les supprime de la source après leur copie.
/a+:[RASHCNET] Ajoute les attributs spécifiés aux fichiers copiés. Les valeurs valides pour cette option sont les suivantes :
  • R - Lecture seule
  • A - Archive
  • S - Système
  • H - Masqué
  • C - Compressé
  • N - Non indexé
  • E - Chiffré
  • T - Temporaire
/a-:[RASHCNET] Supprime les attributs spécifiés des fichiers copiés. Les valeurs valides pour cette option sont les suivantes :
  • R - Lecture seule
  • A - Archive
  • S - Système
  • H - Masqué
  • C - Compressé
  • N - Non indexé
  • E - Chiffré
  • T - Temporaire
/Créer Crée une arborescence de répertoires et des fichiers de longueur nulle uniquement.
/Graisse Crée des fichiers de destination à l’aide des noms de fichiers FAT de longueur 8.3 uniquement.
/256 Désactive la prise en charge des chemins d’accès de plus de 256 caractères.
/mon :<n> Surveille la source et s’exécute à nouveau lorsque plus de n modifications sont détectées.
/mot :<m> Surveille la source et s’exécute à nouveau en m minutes, si des modifications sont détectées.
/Mt[:n] Crée des copies multithread avec n threads. n doit être un entier compris entre 1 et 128. La valeur par défaut de n est 8. Pour de meilleures performances, redirigez votre sortie à l’aide de l’option /log .

Le paramètre /mt ne peut pas être utilisé avec les paramètres /ipg et /efsraw .

/rh:hhmm-hhmm Spécifie les heures d’exécution lorsque de nouvelles copies peuvent être démarrées.
/Pf Vérifie les heures d’exécution par fichier (et non par pass).
/ipg:n Spécifie l’écart entre paquets pour libérer la bande passante sur les lignes lentes.
/Sj Copie les jonctions (liaisons réversibles) vers le chemin d’accès de destination au lieu de cibles de liaison.
/Sl Ne suivez pas les liens symboliques et créez plutôt une copie du lien.
/nodcopy Copie aucune information de répertoire (la valeur par défaut /dcopy:DA est terminée).
/nooffload Copie des fichiers sans utiliser le mécanisme de déchargement de copie Windows.
/Compresser Demande la compression réseau pendant le transfert de fichiers, le cas échéant.

Notes

Le paramètre /mt a été introduit dans Windows Server 2008 R2 et ses fonctionnalités s’appliquent aux versions actuelles de Windows Server.

Important

Lorsque vous utilisez l’option de copie /secfix , spécifiez le type d’informations de sécurité que vous souhaitez copier, à l’aide de l’une de ces options de copie supplémentaires :

  • /copyall
  • /copy:o
  • /copy:s
  • /copy:u
  • /sec

Options de sélection de fichiers

Option Description
/a Copie uniquement les fichiers pour lesquels l’attribut Archive est défini.
/m Copie uniquement les fichiers pour lesquels l’attribut Archive est défini et réinitialise l’attribut Archive .
/ia :[RASHCNETO] Inclut uniquement les fichiers pour lesquels l’un des attributs spécifiés est défini. Les valeurs valides de cette option sont les suivantes :
  • R - Lecture seule
  • A - Archiver
  • S - Système
  • H - Masqué
  • C - Compressé
  • N - Non-contenu indexé
  • E - Chiffré
  • T - Temporaire
  • O - Hors connexion
/Xa:[RASHCNETO] Exclut les fichiers pour lesquels l’un des attributs spécifiés est défini. Les valeurs valides de cette option sont les suivantes :
  • R - Lecture seule
  • A - Archiver
  • S - Système
  • H - Masqué
  • C - Compressé
  • N - Non-contenu indexé
  • E - Chiffré
  • T - Temporaire
  • O - Hors connexion
/Xf <filename>[ ...] Exclut les fichiers qui correspondent aux noms ou chemins spécifiés. Les caractères génériques (* et ?) sont pris en charge.
/Xd <directory>[ ...] Exclut les répertoires qui correspondent aux noms et chemins spécifiés.
/Xc Exclut les fichiers existants avec le même horodatage, mais différentes tailles de fichier.
/Xn Les fichiers de répertoire source plus récents que la destination sont exclus de la copie.
/Xo Les fichiers de répertoire source antérieurs à la destination sont exclus de la copie.
/Xx Exclut les fichiers et répertoires supplémentaires présents dans la destination, mais pas la source. L’exclusion de fichiers supplémentaires ne supprime pas les fichiers de la destination.
/Xl Exclut les fichiers et répertoires « solitaires » présents dans la source, mais pas la destination. L’exclusion de fichiers solitaires empêche tout nouveau fichier d’être ajouté à la destination.
/Im Inclure des fichiers modifiés (heures de modification différentes).
/is Inclut les mêmes fichiers. Les mêmes fichiers sont identiques dans le nom, la taille, les heures et tous les attributs.
/Il Inclut des fichiers « ajustés ». Les fichiers ajustés ont le même nom, la taille et les heures, mais différents attributs.
/Max:<n> Spécifie la taille de fichier maximale (pour exclure les fichiers supérieurs à n octets).
/Min:<n> Spécifie la taille minimale du fichier (pour exclure les fichiers inférieurs à n octets).
/maxage :<n> Spécifie l’âge maximal du fichier (pour exclure les fichiers antérieurs à n jours ou date).
/minage :<n> Spécifie l’âge minimal du fichier (exclure les fichiers plus récents que n jours ou date).
/maxlad :<n> Spécifie la date maximale de dernier accès (exclut les fichiers inutilisés depuis n).
/minlad :<n> Spécifie la date minimale de dernier accès (exclut les fichiers utilisés depuis n) Si n est inférieur à 1900, n spécifie le nombre de jours. Sinon, n spécifie une date au format AAAAMMDD.
/Xj Exclut les points de jonction, qui sont normalement inclus par défaut.
/fft Calcule l’heure des fichiers FAT (à 2 secondes près).
/Dst Compense les différences de temps d’une heure d’une heure.
/xjd Exclut les points de jonction pour les répertoires.
/xjf Exclut les points de jonction pour les fichiers.

Options de nouvelle tentative

Option Description
/r:<n> Spécifie le nombre de nouvelles tentatives en cas d’échec de la copie. La valeur par défaut de n est 1 000 000 (un million de nouvelles tentatives).
/w:<n> Spécifie le délai d’attente entre les tentatives, en secondes. La valeur par défaut de n est 30 (délai d’attente de 30 secondes).
/Reg Enregistre les valeurs spécifiées dans les options /r et /w en tant que paramètres par défaut dans le Registre.
/Tbd Spécifie que le système attend que les noms de partage soient définis (erreur de nouvelle tentative 67).

Options du journal

Option Description
/l Spécifie que les fichiers doivent être répertoriés uniquement (et non copiés, supprimés ou horodatés).
/x Signale tous les fichiers supplémentaires, pas seulement ceux qui sont sélectionnés.
/v Produit une sortie détaillée et affiche tous les fichiers ignorés.
/Ts Inclut les horodatages du fichier source dans la sortie.
/fp Inclut les noms complets des fichiers dans la sortie.
/bytes Imprime les tailles, sous forme d’octets.
/Ns Spécifie que les tailles de fichier ne doivent pas être journalisées.
/nc Spécifie que les classes de fichiers ne doivent pas être journalisées.
/nfl Indique que les noms de fichier ne doivent pas être consignés.
/ndl Indique que les noms de répertoire ne doivent pas être consignés.
/np Spécifie que la progression de l’opération de copie (le nombre de fichiers ou répertoires copiés jusqu’ici) n’est pas affichée.
/Eta Affiche l’heure estimée de l’arrivée (ETA) des fichiers copiés.
/rapport:<logfile> Écrit la sortie d’état dans le fichier journal (remplace le fichier journal existant).
/log+:<logfile> Écrit la sortie d’état dans le fichier journal (ajoute la sortie au fichier journal existant).
/unicode Affiche la sortie de l’état sous forme de texte Unicode.
/Unilog:<logfile> Écrit la sortie d’état dans le fichier journal sous forme de texte Unicode (remplace le fichier journal existant).
/unilog+ :<logfile> Écrit la sortie d’état dans le fichier journal sous forme de texte Unicode (ajoute la sortie au fichier journal existant).
/tee Écrit la sortie d’état dans la fenêtre de console et dans le fichier journal.
/njh Spécifie qu’il n’existe aucun en-tête de travail.
/njs Spécifie qu’il n’existe aucun résumé du travail.

Options de travail

Option Description
/Travail:<jobname> Spécifie que les paramètres doivent être dérivés du fichier de travail nommé. Pour exécuter /job:jobname, vous devez d’abord exécuter le /save:jobname paramètre pour créer le fichier de travail.
/sauvegarder:<jobname> Spécifie que les paramètres doivent être enregistrés dans le fichier de travail nommé. Cette opération doit être exécutée avant l’exécution /job:jobname. Toutes les options de copie, de nouvelle tentative et de journalisation doivent être spécifiées avant ce paramètre.
/Quitter Quitte après le traitement de la ligne de commande (pour afficher les paramètres).
/nosd Indique qu’aucun répertoire source n’est spécifié.
/nodd Indique qu’aucun répertoire de destination n’est spécifié.
/Si Inclut les fichiers spécifiés.

Codes de sortie (retour)

Valeur Description
0 Aucun fichier n’a été copié. Aucun échec n’a été rencontré. Aucun fichier n’a été incompatible. Les fichiers existent déjà dans le répertoire de destination ; par conséquent, l’opération de copie a été ignorée.
1 Tous les fichiers ont été copiés avec succès.
2 Il existe certains fichiers supplémentaires dans le répertoire de destination qui ne sont pas présents dans le répertoire source. Aucun fichier n’a été copié.
3 Certains fichiers ont été copiés. Des fichiers supplémentaires étaient présents. Aucun échec n’a été rencontré.
5 Certains fichiers ont été copiés. Certains fichiers étaient incompatibles. Aucun échec n’a été rencontré.
6 Des fichiers supplémentaires et des fichiers incompatibles existent. Aucun fichier n’a été copié et aucun échec n’a été rencontré. Cela signifie que les fichiers existent déjà dans le répertoire de destination.
7 Les fichiers ont été copiés, une incompatibilité de fichier était présente et des fichiers supplémentaires étaient présents.
8 Plusieurs fichiers n’ont pas été copiés.

Notes

Toute valeur égale ou supérieure à 8 indique qu’il y avait au moins un échec lors de l’opération de copie.

Références supplémentaires