Exporter (0) Imprimer
Développer tout

Xcopy

Mis à jour: janvier 2005

S'applique à: Windows Server 2003, Windows Server 2003 R2, Windows Server 2003 with SP1, Windows Server 2003 with SP2

Xcopy

Copie des fichiers et des répertoires, sous-répertoires compris.

Syntaxe

xcopy Source [Destination] [/w] [/p] [/c] [/v] [/q] [/f] [/l] [/g] [/d[:MM-JJ-AAAA]] [/u] [/i] [/s [/e]] [/t] [/k] [/r] [/h] [{/a | /m}] [/n] [/o] [/x] [/exclude:NomFichier1[+[NomFichier2]][+[NomFichier3]] [{/y | /-y}] [/z]

Paramètres
Source
Obligatoire. Spécifie l'emplacement et le nom des fichiers à copier. Ce paramètre doit obligatoirement inclure un lecteur ou un chemin d'accès.

Destination
Spécifie la destination des fichiers à copier. Ce paramètre peut inclure une lettre de lecteur et le signe deux-points (:), un nom de répertoire, un nom de fichier ou toute combinaison de ces éléments.

/w
Affiche le message suivant et attend une réponse avant de commencer à copier les fichiers :

Appuyez sur une touche pour lancer la copie des fichiers.

/p
Demande à l'utilisateur de confirmer la création de chaque fichier de destination.

/c
Ne tient pas compte des erreurs.

/v
Vérifie chaque fichier au fur et à mesure de son écriture dans le fichier de destination afin de garantir que les fichiers de destination sont identiques aux fichiers sources.

/q
Supprime l'affichage des messages de la commande xcopy .

/f
Affiche les noms des fichiers sources et de destination pendant la copie.

/l
Affiche la liste des fichiers à copier.

/g
Crée des fichiers de destination décryptés.

/d [:MM-JJ-AAAA]
Copie uniquement les fichiers sources qui ont été modifiés à la date précisée ou après cette date. Si vous ne spécifiez aucune valeur pour MM-JJ-AAAA, la commande xcopy copie tous les fichiers Source qui sont plus récents que les fichiers de Destination existants. Cette option de ligne de commande permet de ne mettre à jour que les fichiers qui ont été modifiés.

/u
Copie uniquement les fichiers Source qui existent dans la Destination.

/i
Si le paramètre Source correspond à un répertoire ou qu'il contient des caractères génériques et que le paramètre Destination n'est pas spécifié, la commande xcopy suppose que le nom du répertoire de destination est destination et un nouveau répertoire est donc créé. Ensuite, xcopy copie tous les fichiers spécifiés dans ce répertoire. Par défaut, la commande xcopy demande à l'utilisateur si la Destination est un fichier ou un répertoire.

/s
À moins qu'ils ne soient vides, copie les répertoires et les sous-répertoires. En l'absence de cette option de ligne de commande, xcopy travaille dans un seul répertoire.

/e
Copie tous les sous-répertoires, même s'ils sont vides. Utilisez /e en combinaison avec les options de ligne de commande /s et /t.

/t
Copie uniquement la structure (l'arborescence) du sous-répertoire et non les fichiers. Pour copier des répertoires vides, vous devez inclure l'option de ligne de commande /e.

/k
Copie les fichiers et conserve l'attribut de lecture seule pour les fichiers de destination si les fichiers sources possèdent cet attribut. Par défaut, xcopy supprime l'attribut de lecture seule.

/r
Copie les fichiers avec un attribut de lecture seule.

/h
Copie les fichiers dotés des attributs fichier caché et fichier système. Par défaut, la commande xcopy ne copie pas les fichiers cachés ou les fichiers système.

/a
Copie uniquement les fichiers sources dotés de l'attribut archive. Cette option de ligne de commande ne permet pas de modifier l'attribut archive du fichier source. Pour plus d'informations sur l'activation de cet attribut à l'aide de la commande attrib, voir la section Rubriques connexes.

/m
Copie les fichiers sources dotés de l'attribut archive. Contrairement à l'option de ligne de commande /a, l'option /m permet de désactiver l'attribut archive des fichiers spécifiés dans la source. Pour plus d'informations sur l'activation de cet attribut à l'aide de la commande attrib, voir la section Rubriques connexes.

/n
Crée des copies en utilisant les noms de fichier ou de répertoire abrégés NTFS. Cette option de ligne de commande est requise lors de la copie de fichiers ou de répertoires d'un volume NTFS vers un volume FAT ou lorsque que les conventions de noms de fichier du système de fichiers FAT (8.3) sont exigées sur le système de fichiers de destination. Le système de fichiers de destination peut être le système FAT ou NTFS.

/o
Copie les informations relatives à l'appartenance des fichiers et à la liste de contrôle d'accès discrétionnaire (DACL, Discretionary access control list)

/x
Copie les paramètres d'audit des fichiers et les informations relatives à la liste de contrôle d'accès du système (SACL, System access control list) (implique l'utilisation de l'option /o).

/exclude: NomFichier1[+[ NomFichier2]][+[NomFichier3]]
Spécifie la liste des fichiers contenant des chaînes.

/y
Supprime la demande de confirmation de remplacement d'un fichier de destination existant.

/-y
Affiche la demande de confirmation de remplacement d'un fichier de destination existant.

/z
Permet la copie sur un réseau en mode redémarrage.

/?
Affiche l'aide à partir de l'invite de commandes.

Notes
  • Utilisation de l'option /v

    Windows XP et la famille de produits Windows Server 2003 n’utilisent pas cette commande. Elle est incluse à des fins de compatibilité avec les fichiers MS-DOS existants, mais n’a aucune incidence dans la ligne de commande, car la fonctionnalité est automatique.

  • Utilisation de /exclude

    Présente chaque chaîne sur une ligne distincte dans chaque fichier. Si l'une quelconque des chaînes présentées correspond à une partie du chemin d'accès absolu du fichier à copier, ce fichier est alors exclus du processus de copie. Par exemple, si vous spécifiez la chaîne "\Obj\", vous excluez tous les fichiers qui figurent sous le répertoire Obj. Si vous spécifiez la chaîne ".obj", vous excluez tous les fichiers avec l'extension .obj.

  • Utilisation de /z

    Si la connexion est perdue pendant la phase de copie (notamment si le serveur qui est mis hors connexion entrave la connexion), l'exécution de la commande reprend dès que la connexion est rétablie. L'utilisation de cette option permet également d'afficher le pourcentage de copie réalisée pour chaque fichier.

  • Utilisation de l'option /y dans la variable d'environnement COPYCMD

    Vous pouvez utiliser l'option /y dans la variable d'environnement COPYCMD. Cette option peut être remplacée par /-y sur la ligne de commande. Par défaut, l'utilisateur est invité à la remplacer, excepté s'il exécute la commande copy à partir d'un script de commandes.

  • Copie de fichiers cryptés

    La copie de fichiers cryptés sur un volume qui ne prend pas en charge les résultats au format EFS génère une erreur. Commencez par décrypter les fichiers ou par les copier sur un volume qui prend en charge le système EFS de fichiers cryptés.

  • Ajout de fichiers

    Pour ajouter des fichiers, spécifiez un fichier de destination unique et plusieurs fichiers sources (en utilisant des caractères génériques ou le format fichier1+fichier2+fichier3).

  • Valeur par défaut du paramètre Destination

    Si vous omettez le paramètre Destination, la commande xcopy copie les fichiers dans le répertoire en cours.

  • Comment indiquer si la destination est un fichier ou un répertoire

    Si le paramètre Destination ne fait référence à aucun répertoire existant et qu'il ne se termine pas par une barre oblique inverse (\), le message suivant s'affiche :

    Est-ce que [répertoire de destination] spécifie un nom de fichier ou un nom de répertoire de la destination  (F = fichier, R = répertoire) ?
    
    Appuyez sur F si vous souhaitez que les fichiers soient copiés dans un fichier. Appuyez sur R si vous souhaitez que les fichiers soient copiés dans un répertoire.

    Vous pouvez supprimer l'affichage de ce message en utilisant l'option de ligne de commande /i. La commande xcopy suppose alors que la destination est un répertoire si la source correspond à plusieurs fichiers ou à un répertoire.

  • Utilisation de la commande xcopy pour affecter l'attribut archive aux fichiers de Destination

    La commande xcopy crée des fichiers avec l'attribut archive même si le fichier source ne possède pas cet attribut. Pour plus d'informations sur les attributs de fichier et sur attrib, voir la section Rubriques connexes.

  • Comparaison des commandes xcopy et diskcopy

    Si un disque contient des fichiers stockés dans des sous-répertoires et que vous voulez copier le contenu de ce disque sur un disque de format différent, utilisez la commande xcopy au lieu de la commande diskcopy. Comme la commande diskcopy copie les disques piste par piste, les disques sources et de destination doivent être au même format. Cette obligation n'existe pas pour la commande xcopy. Utilisez plutôt xcopy à moins que vous ne souhaitiez avoir une copie complète de l'image d'un disque.

  • Codes de sortie pour la commande xcopy

    Pour traiter les codes de sortie renvoyés par la commande xcopy, utilisez le paramètre NiveauErreur sur la ligne de commande if dans un programme de commandes. Pour obtenir un exemple d'un programme de commandes qui traite les codes de sortie en utilisant la commande if, voir la section Rubriques connexes. Le tableau suivant énumère chaque code de sortie accompagné d'une description.

     

    Code de sortie Description

    0

    Les fichiers ont été copiés sans erreur.

    1

    Il n'existe pas de fichiers à copier.

    2

    L'utilisateur a appuyé sur Ctrl+C pour arrêter l'exécution de la commande xcopy.

    4

    Une erreur d'initialisation s'est produite. La mémoire ou l'espace disque est insuffisant, ou vous avez entré un nom de lecteur ou une syntaxe non valide sur la ligne de commande.

    5

    Une erreur d'écriture s'est produite sur le disque.

Exemples

Pour copier tous les fichiers et sous-répertoires (y compris tout sous-répertoire vide) du lecteur A vers le lecteur B, tapez :

xcopy a: b: /s /e

Dans l'exemple précédent, pour inclure tout fichier système ou tout fichier caché, ajoutez l'option de ligne de commande /h :

xcopy a: b: /s /e /h

Pour mettre à jour les fichiers du répertoire \Rapports à partir des fichiers du répertoire \Données qui ont été modifiés depuis le 29 décembre 1993, tapez :

xcopy \données \rapports /d:29-12-1993

Dans l'exemple précédent, pour mettre à jour tous les fichiers du répertoire \Rapports quelle qu'en soit la date, tapez :

xcopy \données \rapports /u

Pour obtenir la liste des fichiers qui doivent être copiés par la commande ci-dessus, sans toutefois copier les fichiers, tapez :

xcopy \rawdata \reports /d:12-29-1993 /l > xcopy.out

Le fichier Xcopy.out contient la liste de tous les fichiers devant être copiés.

Pour copier le répertoire \Clients et tous ses sous-répertoires dans le répertoire \\Public\Adresses sur le lecteur H du réseau, conserver l'attribut de lecture seule et demander l'affichage d'une invite lorsqu'un nouveau fichier est créé sur le lecteur H:, tapez :

xcopy \client h:\public\adresse /s /e /k /p

Pour exécuter la commande précédente, assurez-vous que la commande xcopy crée le répertoire \Adresse s'il n'existe pas, supprimez l'affichage du message qui apparaît lors de la création d'un répertoire et ajoutez l'option de ligne de commande \i de la façon suivante :

xcopy \client h:\public\adresse /s /e /k /p /i

Vous pouvez créer un programme de commandes assurant les opérations xcopy et utiliser la commande if dans ce programme afin de traiter le code de sortie en cas d'erreur. Le programme de commandes ci-dessous, par exemple, utilise des paramètres remplaçables pour la source et la destination de xcopy :

@echo off rem COPYIT.BAT transfère tous les fichiers de tous les sous-répertoires rem du lecteur ou du répertoire source (%1) au lecteur ou répertoire de destination



rem du lecteur ou du répertoire (%2)



xcopy %1 %2 /s /e



if errorlevel 4 goto lowmemory if errorlevel 2 goto abort if errorlevel 0 goto exit :lowmemory echo Mémoire insuffisante pour copier les fichiers ou echo lecteur ou syntaxe de ligne de commande non valide. goto exit



:abort echo Vous avez appuyé sur Ctrl+C pour mettre fin à la copie. goto exit :exit 

Pour utiliser ce programme de commandes afin de copier dans le lecteur B tous les fichiers du répertoire C:\PrgmCode et de ses sous-répertoires, tapez :

copyit c:\prgmcode b:

L'interpréteur de commandes substitue C:\Prgmcode à %1 et B: à %2, puis utilise xcopy avec les options de ligne de commande /e et /s. Si xcopy rencontre une erreur, le programme de commandes lit le code de sortie et passe à l'étiquette indiquée dans l'instruction correspondante IF ERRORLEVEL, puis affiche le message approprié et le programme de commandes se ferme.

Légende de mise en forme

 

Mise en forme Signification

Italique

Informations que l'utilisateur doit fournir

Gras

Éléments que l'utilisateur doit taper tels qu'ils sont indiqués

Points de suspension (...)

Paramètre pouvant être répété plusieurs fois dans une ligne de commande

Entre crochets ([])

Éléments facultatifs

Entre accolades ({}), avec séparation des options par une barre verticale (|). Exemple : {pair|impair}

Ensemble d'options parmi lesquelles l'utilisateur doit en choisir une seule

Police Courier

Code ou données de programme

Voir aussi

Cela vous a-t-il été utile ?
(1500 caractères restants)
Merci pour vos suggestions.

Ajouts de la communauté

Afficher:
© 2014 Microsoft