WindowsMachineFileCopy@2 — задача копирования файлов компьютера Windows версии 2

Статья
06/11/2024

Используйте эту задачу для копирования файлов на удаленные компьютеры Windows.

Синтаксис

# Windows machine file copy v2
# Copy files to remote Windows machines.
- task: WindowsMachineFileCopy@2
  inputs:
    SourcePath: # string. Required. Source. 
    MachineNames: # string. Required. Machines. 
    AdminUserName: # string. Required. Admin Login. 
    AdminPassword: # string. Required. Password. 
    TargetPath: # string. Required. Destination Folder. 
  # Advanced Options
    #CleanTargetBeforeCopy: false # boolean. Clean Target. Default: false.
    #CopyFilesInParallel: true # boolean. Copy Files in Parallel. Default: true.
    #AdditionalArguments: # string. Additional Arguments.

# Windows machine file copy v2
# Copy files to remote Windows machines.
- task: WindowsMachineFileCopy@2
  inputs:
    SourcePath: # string. Required. Source. 
    #MachineNames: # string. Machines. 
    #AdminUserName: # string. Admin Login. 
    #AdminPassword: # string. Password. 
    TargetPath: # string. Required. Destination Folder. 
  # Advanced Options
    #CleanTargetBeforeCopy: false # boolean. Clean Target. Default: false.
    #CopyFilesInParallel: true # boolean. Copy Files in Parallel. Default: true.
    #AdditionalArguments: # string. Additional Arguments.

# Windows Machine File Copy v2
# Copy files to remote machine(s).
- task: WindowsMachineFileCopy@2
  inputs:
    SourcePath: # string. Required. Source. 
    #MachineNames: # string. Machines. 
    #AdminUserName: # string. Admin Login. 
    #AdminPassword: # string. Password. 
    TargetPath: # string. Required. Destination Folder. 
  # Advanced Options
    #CleanTargetBeforeCopy: false # boolean. Clean Target. Default: false.
    #CopyFilesInParallel: true # boolean. Copy Files in Parallel. Default: true.
    #AdditionalArguments: # string. Additional Arguments.

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

SourcePath - Источник
string. Обязательный.

Путь к копируемой файлам. Задает абсолютный путь к исходной папке или файлу на локальном компьютере или к UNC-ресурсу, например c:\fabrikamfiber или \\fabrikamshare\fabrikamfiber. Можно использовать предопределенные системные переменные, такие как $(Build.Repository.LocalPath) (рабочая папка на компьютере агента), что позволяет легко указать расположение артефактов сборки на компьютере, на котором размещен агент автоматизации.

MachineNames - Машины
string. Обязательный.

Указывает разделенный запятыми список IP-адресов или полных доменных имен компьютеров, при необходимости включая номер порта.
Например: dbserver.fabrikam.com, dbserver_int.fabrikam.com:5986, 192.168.12.34 можно также указать выходную переменную других задач, например $(variableName), или использовать имя группы ресурсов Azure.

MachineNames - Машины
string.

Указывает разделенный запятыми список IP-адресов или полных доменных имен компьютеров, при необходимости включая номер порта. Например: dbserver.fabrikam.com, dbserver_int.fabrikam.com:5986, 192.168.12.34. Можно также указать выходную переменную других задач, например $(variableName), или использовать имя группы ресурсов Azure.

AdminUserName - Вход Администратор
string. Обязательный.

Указывает имя пользователя домена или локальной учетной записи администратора на целевых узлах. Поддерживаются такие форматы, как домен\имя_пользователя, имя_пользователя и имя_компьютера\имя_пользователя . Форматы имени участника-пользователя, такие как username@domain.com, и встроенные системные учетные записи, такие как NT Authority\System, не поддерживаются.

AdminUserName - Вход Администратор
string.

AdminPassword - Пароль
string. Обязательный.

Указывает пароль для входа администратора для целевых компьютеров. Переменные, определенные в конвейерах сборки или выпуска, например $(passwordVariable), принимаются. Вы можете пометить переменную как secret , чтобы защитить ее.

AdminPassword - Пароль
string.

TargetPath - Конечная папка
string. Обязательный.

Указывает локальный путь на целевых компьютерах или доступный UNC-путь для копирования файлов из источника, например d:\fabrikam или \\fabrikam\Web.

CleanTargetBeforeCopy - Очистка целевого объекта
boolean. Значение по умолчанию: false.

Удаляет все файлы в целевой папке перед копированием в нее новых файлов.

CopyFilesInParallel - Параллельное копирование файлов
boolean. Значение по умолчанию: true.

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

AdditionalArguments - Дополнительные аргументы
string.

Указывает дополнительные аргументы RoboCopy, которые применяются при копировании файлов, например /min:33553332 /l.

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

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

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

Нет.

Remarks

Используйте эту задачу для копирования файлов приложений и других артефактов, таких как скрипты PowerShell и модули PowerShell-DSC, необходимые для установки приложения на компьютерах Windows. Она использует RoboCopy, программу командной строки, созданную для быстрого копирования данных.

Почему при использовании этой задачи возникает системная ошибка 53?

Обычно это происходит, когда не удается найти указанный путь. Это может быть вызвано тем, что брандмауэр блокирует необходимые порты для общего доступа к файлам и принтерам или из-за недопустимой спецификации пути. Дополнительные сведения см. в статье Ошибка 53 на сайте TechNet.

Новые возможности версии 2.0

Добавлена поддержка прокси-сервера.
Удалена поддержка устаревших компьютеров DTL.

Требования

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

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