File Copier Tasks YAML

File Utilities Build Tasks

The 'File Utilities Build Tasks' package contains the following tasks. The table show the possible variables that can be used in YAML Azure DevOps Pipeline configurations

FileCopy V4

Copies files between locations

YAML snippet

# File Copy with filters
# Description - Copies files between locations
- task: FileCopy@4
  inputs: 
     # Required arguments
     sourceFolder: 
     targetFolder: 
     include: *
     filter: *

Arguments

• Argument: sourceFolder
  • Description: The source folders, comma delimited
  • Type: string
  • Required: true
  • Default (if defined):
• Argument: targetFolder
  • Description: The target folder
  • Type: string
  • Required: true
  • Default (if defined):
• Argument: include
  • Description: The files types to match, comma delimited
  • Type: string
  • Required: true
  • Default (if defined): *
• Argument: filter
  • Description: The file pattern to match
  • Type: string
  • Required: true
  • Default (if defined): *

GetArtifactFromUncShare V4

Gets the contents of a remote TFS server build's drop location

YAML snippet

# Get Artifact From UNC Share
# Description - Gets the contents of a remote TFS server build's drop location
- task: GetArtifactFromUncShare@4
  inputs: 
     # Required arguments
     tfsUri: 
     teamproject: 
     defname: 
     artifactname: 
     localdir: $(SYSTEM.ARTIFACTSDIRECTORY)

Arguments

• Argument: tfsUri
  • Description: The URI of the TFS server e.g. http://myserver:8080/tfs/defaultcollection
  • Type: string
  • Required: true
  • Default (if defined):
• Argument: teamproject
  • Description: The name of the source team project
  • Type: string
  • Required: true
  • Default (if defined):
• Argument: defname
  • Description: The name of the build definition.
  • Type: string
  • Required: true
  • Default (if defined):
• Argument: artifactname
  • Description: The name of the build artifact.
  • Type: string
  • Required: true
  • Default (if defined):
• Argument: buildnumber
  • Description: Number of the build to download (if blank latest complete build used)
  • Type: string
  • Required: false
  • Default (if defined):

Advanced

• Argument: username
  • Description: User name to access remote server (if blank default creds. used)
  • Type: string
  • Required: false
  • Default (if defined):
• Argument: password
  • Description: Password to access remote server (if blank default creds. used)
  • Type: string
  • Required: false
  • Default (if defined):
• Argument: localdir
  • Description: The root directory to store the artifact in, defaults to $(SYSTEM.ARTIFACTSDIRECTORY)
  • Type: string
  • Required: true
  • Default (if defined): $(SYSTEM.ARTIFACTSDIRECTORY)

XmlFileUpdateTask V4

Update an attribute in an Xml file based on XPath filter

YAML snippet

# Update XML file attribute
# Description - Update an attribute in an Xml file based on XPath filter
- task: XmlFileUpdateTask@4
  inputs: 
     # Required arguments
     filename: 
     xpath: 
     value: 

Arguments

• Argument: filename
  • Description: The file to update e.g: $(SYSTEM.ARTIFACTSDIRECTORY)\myfile.dll.config
  • Type: string
  • Required: true
  • Default (if defined):
• Argument: xpath
  • Description: The Xpath query to select a node e.g: /configuration/appSettings/add[@key='A variable']
  • Type: string
  • Required: true
  • Default (if defined):
• Argument: attribute
  • Description: The attribute name to update e.g. value (if not set InnerText of node will be updated)
  • Type: string
  • Required: false
  • Default (if defined):
• Argument: value
  • Description: The new value to set e.g. 'new value'
  • Type: string
  • Required: true
  • Default (if defined):
• Argument: recurse
  • Description: If true will search for files recursivally, default is true.
  • Type: boolean
  • Required: false
  • Default (if defined): True