ROBOCOPY

Syntaxe

Paramètres

Description

Cette commande permet d'effectuer la copie automatisé avec sous-répertoire de fichier(s) vers un nouvel emplacement.

Remarques

• En copiant uniquement les fichiers modifiés, la commande ROBOCOPY peut être utilisé pour sauvegarder de très gros volumes.
• Si la source ou la destination est un nom de dossier long entre guillemets, n'incluez pas de barre oblique inversée car cela sera traité comme un caractère d'échappement, c'est-à-dire que "C:\chemin\" échouera mais "C:\chemin\\" ou "C:\chemin\." ou "C:\chemin" fonctionnera.
• Si vous créez un fichier journal de bord de progression avec /LOG, spécifiez un répertoire de destination existant déjà, la commande ROBOCOPY créera le fichier mais ne créera pas automatiquement de répertoire de journal de bord.
• La commande ROBOCOPY acceptera les chemins d'accès UNC, y compris les chemins d'accès longs de plus de 256 caractères. Lors de la copie d'une arborescence de plusieurs fichiers et sous-dossiers, si le dossier de destination a un nom plus long que le dossier source, il est probable que certains fichiers atteignent la limite de 256 caractères. Même lorsque la commande ROBOCOPY copie correctement ces fichiers, d'autres logiciels peuvent refuser de les ouvrir.
• Pour la compatibilité avec les anciens logiciels, le dossier User Profile contient un certain nombre de points de jonction, «Application Data», «My Documents», «Recent», «Send To»,... Par défaut, ROBOCOPY /S suivra un point de jonction dans la source et copiera le contenu dans un dossier standard dans la destination. Dans le cas de «Application Data» sous le système d'exploitation Windows 7, le chemin «\Documents and Settings\%USER%\Application Data» est un point de jonction vers «\Users\%USER%\AppData\Roaming», qui à son tour peut contenir la jonction «Application Data» en tant que sous-répertoire. Dans des cas comme celui-ci, la commande ROBOCOPY peut créer une boucle récursive en copiant le dossier en lui-même jusqu'à ce que la longueur maximale du nom de dossier NTFS de 32 767 caractères soit dépassée. Pour éviter cette situation, utilisez les paramètres /XJ ou /XJD.
• Le paramètre /SL copiera les liens symboliques, cette situation copiera uniquement un lien symbolique de fichier, créant un nouveau lien symbolique à la destination.
• Pour un lien symbolique de répertoire, une jonction ou un lien dur, la commande ROBOCOPY suivra la source et copiera le contenu dans un dossier standard de la destination. Pour un programme de sauvegarde, c'est généralement le comportement souhaité.
• Pour exclure la copie des points de jonction, vous pouvez utiliser les paramètres /XJ, /XJD, /XJF, cette situation empêchera la copie des fichiers source. Le point de jonction lui-même ne sera pas copié (avec ou sans ces drapeaux).
• Un point de jonction NTFS dans la destination ne sera pas supprimé par ROBOCOPY, si vous sélectionnez des paramètres supprimant de la destination (/purge, /mir) et que la destination contient une jonction, la commande ROBOCOPY suivra aveuglément cette jonction et supprimera le contenu. Le paramètre /XJ n'affectent pas cette situation car elles excluent uniquement les jonctions de la source.

Codes de sortie

Le code de retour de ROBOCOPY est un bitmap, défini comme suit :

Ceux-ci peuvent être combinés, donnant quelques codes de sortie supplémentaires :

Un code de sortie de 0 à 7 est un succès et toute valeur ≥ 8 indique qu'il y a eu au moins un échec pendant l'opération de copie. De nombreux outils de déploiement tels que SCCM supposent par défaut que tout code de sortie supérieur à 0 est une erreur.

Exemples

L'exemple suivant permet de copier le répertoire «C:\backup» dans le répertoire «C:\test» :

L'exemple suivant permet de copier le répertoire «C:\backup» dans le répertoire «C:\test» et change le code de retour pour 0 si l'opération c'est bien passé sinon 0 :

Variante