Compartir a través de


CopyFiles@1: tarea Copiar archivos v1

Use esta tarea para copiar archivos de una carpeta de origen a una carpeta de destino usando patrones de coincidencia. (Los patrones de coincidencia solo coincidirán con las rutas de acceso de archivo, no las rutas de acceso de carpeta).

Nota

Hay una versión más reciente de esta tarea disponible en 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.

Entradas

SourceFolder - Carpeta de origen
string.

Opcional. Carpeta que contiene los archivos que desea copiar. Si la carpeta está vacía, la tarea copia los archivos de la carpeta raíz del repositorio como si $(Build.SourcesDirectory) se hubiera especificado.

Si la compilación produce artefactos fuera del directorio de orígenes, especifique $(Agent.BuildDirectory) para copiar archivos del directorio creado para la canalización.


Contents - Contenido
string. Obligatorio. Valor predeterminado: **.

Rutas de acceso de archivo que se van a incluir como parte de la copia. Esta cadena admite varias líneas de patrones de coincidencia.

Por ejemplo:

  • * copia todos los archivos de la carpeta de origen especificada.
  • ** copia todos los archivos de la carpeta de origen especificada y todos los archivos de todas las subcarpetas.
  • **\bin\** copia todos los archivos de forma recursiva desde cualquier carpeta bin.

El patrón se usa para comprobar la coincidencia solo de las rutas de acceso de archivo, no de las rutas de acceso de carpeta. Especifique patrones, como **\bin\** en lugar de **\bin.

Use el separador de ruta de acceso que coincida con el tipo de agente de compilación. Por ejemplo, / se debe usar para los agentes de Linux. A continuación se muestran más ejemplos.


TargetFolder - Carpeta de destino
string. Obligatorio.

La carpeta de destino o la ruta de acceso UNC que contendrá los archivos copiados. Puede usar variables. Ejemplo: $(build.artifactstagingdirectory).


CleanTargetFolder - Limpiar carpeta de destino
boolean. Valor predeterminado: false.

Opcional. Elimina todos los archivos existentes en la carpeta de destino antes del proceso de copia.


OverWrite - Sobrescribir
boolean. Valor predeterminado: false.

Opcional. Reemplaza los archivos existentes en la carpeta de destino.


flattenFolders - Aplanar carpetas
boolean. Valor predeterminado: false.

Opcional. Aplana la estructura de carpetas y copia todos los archivos en la carpeta de destino especificada.


Opciones de control de tareas

Todas las tareas tienen opciones de control además de las entradas de tareas. Para obtener más información, vea Opciones de control y propiedades de tareas comunes.

Variables de salida

Ninguno.

Comentarios

Hay una versión más reciente de esta tarea disponible en CopyFiles@2.

Si no coinciden archivos, la tarea seguirá informando de que se ha realizado correctamente. Si ya existe un archivo coincidente en la carpeta de destino, la tarea notificará un error a menos que Overwrite se establezca en true.

Requisitos

Requisito Descripción
Tipos de canalización YAML, compilación clásica
Se ejecuta en Agente, DeploymentGroup
Peticiones None
Capabilities Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
Restricciones de comandos Any
Variables que se pueden establecer Any
Versión del agente 1.91.0 o superior
Categoría de la tarea: Utilidad

Consulte también