Robocopy — fiche mémo : fiche mémo IT

Référence Robocopy pour copie, migration, ACL, reprise, performance, filtres, logs, simulation et interprétation des codes retour.

Exemples de base

Copie arborescence — robocopy C:\Source D:\Destination /ECopie sous-dossiers y compris vides sans supprimer les extras destination.
Simulation — robocopy C:\Source D:\Destination /E /LAffiche ce qui serait traité sans effectuer la copie.
Journal — robocopy C:\Source D:\Destination /E /TEE /LOG:C:\Logs\robocopy.logTEE affiche et journalise simultanément.
Réseau redémarrable — robocopy C:\Source \\Serveur\Partage /E /Z /R:2 /W:5/Z facilite reprise mais peut réduire les performances selon scénario.

/E — Inclut sous-dossiers videsNe supprime pas les fichiers en trop dans la destination.
/S — Sous-dossiers non videsAlternative si les dossiers vides ne sont pas nécessaires.
/XD — Exclure dossiersExemple : /XD "System Volume Information" Temp.
/XJ — Exclure jonctionsÉvite certaines boucles ou traversées non souhaitées de junctions.

/XF — Exclure fichiersPeut prendre noms et motifs, par exemple *.tmp.
/MAX — Taille maximale en octetsUtile pour exclure les très gros fichiers dans un premier passage.
/MINAGE — Exclure fichiers plus récents qu’un âge/dateVérifiez la syntaxe date/âge avant production.
/MAXAGE — Exclure fichiers plus anciens qu’un âge/datePratique pour périmètres d’archives.

/COPY:DAT — Data, Attributes, TimestampsValeur classique pour contenu sans sécurité NTFS.
/COPY:DATSOU — Data, Attributes, Timestamps, Security, Owner, aUditingNécessite droits suffisants pour S/O/U.
/COPYALL — Équivalent à /COPY:DATSOUÀ utiliser uniquement si vous devez réellement conserver toute la sécurité.
/DCOPY:DAT — Attributs/temps des dossiersImportant dans certaines migrations où les dates dossiers doivent être conservées.

/Z — Mode redémarrablePermet de reprendre un gros fichier après interruption.
/ZB — Redémarrable puis Backup modeBackup mode nécessite privilèges et peut contourner certaines ACL.
/R:n — Nombre de retriesDéfinissez une valeur raisonnable : le défaut historique peut être très élevé.
/W:n — Attente entre retriesRéduit le temps perdu sur un fichier durablement verrouillé.

/MT:n — Copie multithreadExemple /MT:16 ; augmente charge CPU, disque et réseau.
/J — I/O non bufferiséePeut aider avec de très gros fichiers selon stockage.
/IPG:n — Inter-packet gapAncienne méthode de limitation ; testez plutôt la charge réelle.
Fenêtre de migration — Mesurer débit + IOPS + fichiers/sLe nombre de petits fichiers peut dominer plus que le volume total.

/MIR — /E + /PURGEPeut supprimer en destination ce qui n’existe plus en source.
/PURGE — Supprime les extras destinationToujours simuler avec /L sur un périmètre sensible.
/MOVE — Déplace fichiers et dossiersSupprime la source après copie : action destructive.
/MOV — Déplace uniquement les fichiersLes dossiers source restent.

/LOG — Écrire un journalPréférez un chemin local fiable pendant une migration critique.
/TEE — Console + logUtile pour suivre et conserver la preuve.
0 à 7 — Résultat sans erreur bloquante RobocopyCes codes représentent combinaisons de copies/extras/mismatches, pas forcément un échec.
>= 8 — Au moins une erreur de copieTraitez comme échec et analysez le journal.

Avant /MIR, /PURGE, /MOVE ou /MOV, faites un passage /L et conservez le journal.
/COPYALL et /ZB nécessitent des privilèges adaptés et peuvent modifier la sécurité de destination.
Un code retour Robocopy inférieur à 8 n’est pas forcément un échec.
Pour une migration, comparez également nombre de fichiers, taille totale, ACL et échantillons restaurés.