WindowsMachineFileCopy@2 - Windows 计算机文件复制 v2 任务

使用此任务将文件复制到远程 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 地址或 FQDN 的逗号分隔列表(可选包括端口号)。
例如: dbserver.fabrikam.com, dbserver_int.fabrikam.com:5986, 192.168.12.34 还可以指定其他任务的输出变量,例如 $(variableName),也可以使用 Azure 资源组的名称。


MachineNames - 机器
string.

指定计算机 IP 地址或 FQDN 的逗号分隔列表(可选包括端口号)。 例如:dbserver.fabrikam.com, dbserver_int.fabrikam.com:5986, 192.168.12.34。 还可以指定其他任务的输出变量,例如 $(variableName),也可以使用 Azure 资源组的名称。


AdminUserName - 管理员登录
string. 必需。

指定目标主机上的域或本地管理帐户的用户名 () 。 支持 域\用户名用户名machine-name\username 等格式。 不支持 UPN 格式(如 username@domain.com)和内置系统帐户(如 NT Authority\System)。


AdminUserName - 管理员登录
string.

指定目标主机上的域或本地管理帐户的用户名 () 。 支持 域\用户名用户名machine-name\username 等格式。 不支持 UPN 格式(如 username@domain.com)和内置系统帐户(如 NT Authority\System)。


AdminPassword - 密码
string. 必需。

指定目标计算机的管理员登录名的密码。 接受在生成或发布管道(如 $(passwordVariable))中定义的变量。 可以将变量 secret 标记为 来保护它。


AdminPassword - 密码
string.

指定目标计算机的管理员登录名的密码。 接受在生成或发布管道(如 $(passwordVariable))中定义的变量。 可以将变量 secret 标记为 来保护它。


TargetPath - 目标文件夹
string. 必需。

指定目标计算机上的本地路径或用于从源复制文件的可访问 UNC 路径,例如 d:\fabrikam\\fabrikam\Web


CleanTargetBeforeCopy - 清理目标
boolean. 默认值:false

删除目标文件夹中的所有文件,然后再将新文件复制到目标文件夹。


CopyFilesInParallel - 并行复制文件
boolean. 默认值:true

将文件并行复制到所有目标计算机,从而加快复制过程。


AdditionalArguments - 其他参数
string.

指定复制文件时应用的其他 RoboCopy 参数,如 /min:33553332 /l


任务控件选项

除任务输入外,所有任务都有控制选项。 有关详细信息,请参阅 控制选项和常见任务属性

输出变量

无。

备注

使用此任务复制应用程序文件和其他项目,如 PowerShell 脚本和 PowerShell-DSC 模块,这些项目是将应用程序安装在 Windows 计算机上所必需的。 它使用 RoboCopy,这是为快速复制数据而构建的命令行实用工具。

为什么使用此任务时收到系统错误 53?

通常,当无法找到指定的路径时,就会发生这种情况。 这可能是由于防火墙阻止了文件和打印机共享所需的端口,或者路径规范无效。 有关详细信息,请参阅 TechNet 上的 错误 53

版本 2.0 中的新增功能

  • 正在添加代理支持。
  • 删除了对旧版 DTL 计算机的支持。

要求

要求 说明
管道类型 YAML,经典内部版本,经典发布
运行平台 Agent、DeploymentGroup
需求
功能 此任务不满足作业中后续任务的任何要求。
命令限制 Any
可设置的变量 Any
代理版本 1.104.0 或更高版本
任务类别 部署