Поделиться через


CopyFiles@1 — задача копирования файлов версии 1

Используйте эту задачу для копирования файлов из исходной папки в целевую папку с помощью шаблонов соответствия. (Шаблоны соответствия будут соответствовать только путям к файлам, но не к папкам).

Примечание

На CopyFiles@2 доступна более новая версия этой задачи.

Синтаксис

# 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.

Входные данные

SourceFolder - Исходная папка
string.

Необязательный элемент. Папка, содержащая файлы, которые нужно скопировать. Если папка пуста, задача копирует файлы из корневой папки репозитория так, как будто $(Build.SourcesDirectory) она была указана.

Если сборка создает артефакты за пределами исходного каталога, укажите $(Agent.BuildDirectory) для копирования файлов из каталога, созданного для конвейера.


Contents - Содержимое
string. Обязательный. Значение по умолчанию: **.

Пути к файлам, включаемые в копию. Эта строка поддерживает несколько строк шаблонов соответствия.

Пример:

  • * копирует все файлы в указанной исходной папке.
  • ** копирует все файлы в указанной исходной папке и все файлы во всех вложенных папках.
  • **\bin\** рекурсивно копирует все файлы из любой папки bin.

Шаблон используется для сопоставления только путей к файлам, а не путей к папкам. Укажите шаблоны, например , вместо **\bin\****\bin.

Используйте разделитель пути, соответствующий типу агента сборки. Например, / должен использоваться для агентов Linux. Ниже приведены дополнительные примеры.


TargetFolder - Целевая папка
string. Обязательный.

Целевая папка или UNC-путь, который будет содержать скопированные файлы. Можно использовать переменные. Например, $(build.artifactstagingdirectory).


CleanTargetFolder - Очистка целевой папки
boolean. Значение по умолчанию: false.

Необязательный элемент. Удаляет все существующие файлы в целевой папке перед процессом копирования.


OverWrite - Перезаписать
boolean. Значение по умолчанию: false.

Необязательный элемент. Заменяет существующие файлы в целевой папке.


flattenFolders - Плоские папки
boolean. Значение по умолчанию: false.

Необязательный элемент. Преобразует структуру папок в плоскую структуру и копирует все файлы в указанную целевую папку.


Параметры управления задачами

Помимо входных данных, все задачи имеют параметры управления. Дополнительные сведения см. в разделе Параметры управления и общие свойства задачи.

Выходные переменные

Нет.

Remarks

На CopyFiles@2 доступна более новая версия этой задачи.

Если файлы не совпадают, задача по-прежнему будет сообщать об успешном выполнении. Если соответствующий файл уже существует в целевой папке, задача сообщит о сбое, если Overwrite для параметра не задано значение true.

Требования

Требование Описание
Типы конвейеров YAML, классическая сборка
Выполняется в Агент, DeploymentGroup
Требования Нет
Capabilities Эта задача не удовлетворяет требованиям для последующих задач в задании.
Ограничения команд Любой
Устанавливаемые переменные Любой
Версия агента 1.91.0 или более поздней версии
Категория задач Служебная программа

См. также раздел