使用此任务将文件复制到远程 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\username、 username 和 machine-name\username 等格式。 不支持 UPN 格式(如 username@___domain.com
)和内置系统帐户(如 NT Authority\System)。
AdminUserName
-
管理员登录
string
。
指定目标主机上的域或本地管理帐户的用户名。 支持 ___domain\username、 username 和 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
.
任务控制选项
除任务输入之外,所有任务都具有控制选项。 有关详细信息,请参阅 控件选项和常见任务属性。
输出变量
没有。
注解
使用此任务可以复制在 Windows 计算机上安装应用程序所需的应用程序文件和其他对象,例如 PowerShell 脚本和 PowerShell-DSC 模块。 它使用 RoboCopy,这是为快速复制数据而构建的命令行实用程序。
为什么在使用此任务时会收到系统错误 53?
通常,当找不到指定的路径时,会发生这种情况。 这可能是由于防火墙阻止了文件和打印机共享所需的端口,或者路径规范无效。 有关详细信息,请参阅 TechNet 上的 错误 53 。
版本 2.0 中的新增功能
- 正在添加代理支持。
- 删除了对旧版 DTL 计算机的支持。