WindowsMachineFileCopy@1 - Windows machine file copy v1 task
Use this task to copy files to remote Windows machines.
Inputs
SourcePath
- Source
string
. Required.
Specifies the absolute path of the source folder or file on the local machine or a UNC Share, like c:\fabrikamfiber
or \\fabrikamshare\fabrikamfiber
.
EnvironmentName
- Machines
string
.
Specifies a comma-separated list of machine IP addresses or FQDNs, for example, dbserver.fabrikam.com,192.168.12.34
. You can also specify the output variable of other tasks, for example $(variableName)
.
AdminUserName
- Admin Login
string
.
Specifies the administrator login for the target machines.
AdminPassword
- Password
string
.
Specifies the password for the administrator login for the target machines. Variables defined in build/release definitions as $(passwordVariable)
are accepted. You can mark the variable type as secret
to secure it.
TargetPath
- Destination Folder
string
. Required.
Specifies the local path on the target machine or an accessible UNC path for copying the files from the source, like d:\fabrikam
or \\fabrikam\Web
.
CleanTargetBeforeCopy
- Clean Target
boolean
. Default value: false
.
Cleans the destination folder before copying the files.
CopyFilesInParallel
- Copy Files in Parallel
boolean
. Default value: true
.
Copies files in parallel to the machines.
AdditionalArguments
- Additional Arguments
string
.
Specifies additional robocopy arguments that are applied when copying files, like /min:33553332 /l
.
ResourceFilteringMethod
- Select Machines By
string
. Allowed values: machineNames
(Machine Names), tags
. Default value: machineNames
.
MachineNames
- Filter Criteria
string
.
This input is only valid for machine groups and is not supported for a flat list of machines or output variables yet.
Specifies a comma-separated list of machines, like dbserver.fabrikam.com, webserver.fabrikam.com, 192.168.12.34
, or tags, like Role:DB; OS:Win8.1
. If multiple tags are provided, the task will run in all machines with the specified tags. The default runs the task in all machines.
Task control options
All tasks have control options in addition to their task inputs. For more information, see Control options and common task properties.
Output variables
None.
Requirements
Requirement | Description |
---|---|
Pipeline types | YAML, Classic build, Classic release |
Runs on | All |
Demands | None |
Capabilities | This task does not satisfy any demands for subsequent tasks in the job. |
Command restrictions | Any |
Settable variables | Any |
Agent version | 1.104.0 or greater |
Task category | Deploy |