Fiche mémo

Robocopy — fiche mémo

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

⌚ Environ 3 min de lecture
Voir mes favoris
WindowsIntermédiaire à avancé8 sections · 32 repères

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 /E

Copie sous-dossiers y compris vides sans supprimer les extras destination.

Simulation
robocopy C:Source D:Destination /E /L

Affiche ce qui serait traité sans effectuer la copie.

Journal
robocopy C:Source D:Destination /E /TEE /LOG:C:Logsrobocopy.log

TEE affiche et journalise simultanément.

Réseau redémarrable
robocopy C:Source \ServeurPartage /E /Z /R:2 /W:5

/Z facilite reprise mais peut réduire les performances selon scénario.

Sélection des dossiers

/E
Inclut sous-dossiers vides

Ne supprime pas les fichiers en trop dans la destination.

/S
Sous-dossiers non vides

Alternative si les dossiers vides ne sont pas nécessaires.

/XD
Exclure dossiers

Exemple : /XD "System Volume Information" Temp.

/XJ
Exclure jonctions

Évite certaines boucles ou traversées non souhaitées de junctions.

Sélection des fichiers

/XF
Exclure fichiers

Peut prendre noms et motifs, par exemple *.tmp.

/MAX
Taille maximale en octets

Utile pour exclure les très gros fichiers dans un premier passage.

/MINAGE
Exclure fichiers plus récents qu’un âge/date

Vérifiez la syntaxe date/âge avant production.

/MAXAGE
Exclure fichiers plus anciens qu’un âge/date

Pratique pour périmètres d’archives.

Données, attributs & ACL

/COPY:DAT
Data, Attributes, Timestamps

Valeur classique pour contenu sans sécurité NTFS.

/COPY:DATSOU
Data, Attributes, Timestamps, Security, Owner, aUditing

Né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 dossiers

Important dans certaines migrations où les dates dossiers doivent être conservées.

Reprise & erreurs

/Z
Mode redémarrable

Permet de reprendre un gros fichier après interruption.

/ZB
Redémarrable puis Backup mode

Backup mode nécessite privilèges et peut contourner certaines ACL.

/R:n
Nombre de retries

Définissez une valeur raisonnable : le défaut historique peut être très élevé.

/W:n
Attente entre retries

Réduit le temps perdu sur un fichier durablement verrouillé.

Performance

/MT:n
Copie multithread

Exemple /MT:16 ; augmente charge CPU, disque et réseau.

/J
I/O non bufferisée

Peut aider avec de très gros fichiers selon stockage.

/IPG:n
Inter-packet gap

Ancienne méthode de limitation ; testez plutôt la charge réelle.

Fenêtre de migration
Mesurer débit + IOPS + fichiers/s

Le nombre de petits fichiers peut dominer plus que le volume total.

Miroir, purge & déplacement

/MIR
/E + /PURGE

Peut supprimer en destination ce qui n’existe plus en source.

/PURGE
Supprime les extras destination

Toujours simuler avec /L sur un périmètre sensible.

/MOVE
Déplace fichiers et dossiers

Supprime la source après copie : action destructive.

/MOV
Déplace uniquement les fichiers

Les dossiers source restent.

Logs & codes retour

/LOG
Écrire un journal

Préférez un chemin local fiable pendant une migration critique.

/TEE
Console + log

Utile pour suivre et conserver la preuve.

0 à 7
Résultat sans erreur bloquante Robocopy

Ces codes représentent combinaisons de copies/extras/mismatches, pas forcément un échec.

>= 8
Au moins une erreur de copie

Traitez comme échec et analysez le journal.

À retenir

  • 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.
← Toutes les fiches mémo
♡ 0