Partager via


CopyFiles@1 - Tâche Copier des fichiers v1

Utilisez cette tâche pour copier des fichiers d’un dossier source vers un dossier cible à l’aide de modèles de correspondance. (Les modèles de correspondance correspondent uniquement aux chemins d’accès aux fichiers, et non aux chemins de dossier).

Notes

Une version plus récente de cette tâche est disponible sur CopyFiles@2.

Syntax

# Copy Files v1
# Copy files from source folder to target folder using minimatch patterns (The minimatch patterns will only match file paths, not folder paths).
- task: CopyFiles@1
  inputs:
    #SourceFolder: # string. Source Folder. 
    Contents: '**' # string. Required. Contents. Default: **.
    TargetFolder: # string. Required. Target Folder. 
  # Advanced
    #CleanTargetFolder: false # boolean. Clean Target Folder. Default: false.
    #OverWrite: false # boolean. Overwrite. Default: false.
    #flattenFolders: false # boolean. Flatten Folders. Default: false.

Entrées

SourceFolder - Dossier source
string.

facultatif. Dossier qui contient les fichiers que vous souhaitez copier. Si le dossier est vide, la tâche copie les fichiers du dossier racine du référentiel comme spécifié $(Build.SourcesDirectory) .

Si votre build produit des artefacts en dehors du répertoire source, spécifiez $(Agent.BuildDirectory) pour copier des fichiers à partir du répertoire créé pour le pipeline.


Contents - Contenu
string. Obligatoire. Valeur par défaut : **.

Chemins d’accès de fichiers à inclure dans le cadre de la copie. Cette chaîne prend en charge plusieurs lignes de modèles de correspondance.

Par exemple :

  • * copie tous les fichiers du dossier source spécifié.
  • ** copie tous les fichiers du dossier source spécifié et tous les fichiers de tous les sous-dossiers.
  • **\bin\** copie tous les fichiers de manière récursive à partir de n’importe quel dossier bin.

Le modèle est utilisé pour faire correspondre uniquement les chemins d’accès aux fichiers, et non les chemins d’accès aux dossiers. Spécifiez des modèles, par **\bin\** exemple au lieu de **\bin.

Utilisez le séparateur de chemin qui correspond au type de votre agent de build. Par exemple, / doit être utilisé pour les agents Linux. Voici quelques autres exemples.


TargetFolder - Dossier cible
string. Obligatoire.

Dossier cible ou chemin UNC qui contiendra les fichiers copiés. Vous pouvez utiliser des variables. Exemple : $(build.artifactstagingdirectory).


CleanTargetFolder - Nettoyer le dossier cible
boolean. Valeur par défaut : false.

facultatif. Supprime tous les fichiers existants dans le dossier cible avant le processus de copie.


OverWrite - Écraser
boolean. Valeur par défaut : false.

facultatif. Remplace les fichiers existants dans le dossier cible.


flattenFolders - Dossiers aplatits
boolean. Valeur par défaut : false.

facultatif. Aplatit la structure des dossiers et copie tous les fichiers dans le dossier cible spécifié.


Options de contrôle de la tâche

Toutes les tâches ont des options de contrôle en plus de leurs entrées de tâches. Pour plus d’informations, consultez Options de contrôle et propriétés de tâche courantes.

Variables de sortie

Aucun.

Notes

Une version plus récente de cette tâche est disponible sur CopyFiles@2.

Si aucun fichier ne correspond, la tâche signale toujours la réussite. Si un fichier correspondant existe déjà dans le dossier cible, la tâche signale l’échec, sauf si Overwrite est défini sur true.

Configuration requise

Condition requise Description
Types de pipelines YAML, build classique
S’exécute sur Agent, DeploymentGroup
Demandes None
Capabilities Cette tâche ne répond à aucune demande pour les tâches suivantes dans le travail.
Restrictions de commandes Quelconque
Variables settables Quelconque
Version de l’agent 1.91.0 ou version ultérieure
Catégorie de la tâche Utilitaire

Voir aussi