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.

输入

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。 必填。

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


AdminUserName - 管理员登录
string

指定目标主机上的域或本地管理帐户的用户名。 支持 ___domain\usernameusernamemachine-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.


任务控制选项

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

输出变量

没有。

注解

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

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

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

版本 2.0 中的新增功能

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

要求

要求 DESCRIPTION
管道类型 YAML,经典版本,经典版本
运行时间 代理,DeploymentGroup
需求 没有
功能 此任务不满足作业中后续任务的任何要求。
命令限制 任意
Settable 变量 任意
代理版本 1.104.0 或更高版本
任务类别 部署