WindowsMachineFileCopy@1 - Windows machine file copy v1 task

Article
07/02/2024

Use this task to copy files to remote Windows machines.

Syntax

# Windows machine file copy v1
# Copy files to remote Windows machines.
- task: WindowsMachineFileCopy@1
  inputs:
    SourcePath: # string. Required. Source. 
    #EnvironmentName: # 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. 
    #ResourceFilteringMethod: 'machineNames' # 'machineNames' | 'tags'. Select Machines By. Default: machineNames.
    #MachineNames: # string. Filter Criteria.

# Windows Machine File Copy v1
# Copy files to remote machine(s).
- task: WindowsMachineFileCopy@1
  inputs:
    SourcePath: # string. Required. Source. 
    #EnvironmentName: # 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. 
    #ResourceFilteringMethod: 'machineNames' # 'machineNames' | 'tags'. Select Machines By. Default: machineNames.
    #MachineNames: # string. Filter Criteria.

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	Agent, DeploymentGroup
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

Share via