BuildMaster Documentation

Files - Copy Files

  • Last Modified: 2020-06-26

This is generated from the built-in components of BuildMaster 6.2.13, and may be different than what you have installed (especially if you have extensions); go to [User Icon] > Documentation within your BuildMaster instance to see exactly what operations are available.

Copy Files

Copies files on a server.

Script usage:

Copy-Files(
	[Include: <@(text)>],
	[Exclude: <@(text)>],
	[From: <text>],
	To: <text>,
	[Verbose: <true/false>],
	[Overwrite: <true/false>],
	[RenameFrom: <text>],
	[RenameTo: <text>],
	[RenameRegex: <true/false>]
);

This operation may be prefixed with Files::, although this is a built-in namespace and isn't really necessary.

Arguments:

Name Format Script Usage Usage Notes
Include
@(text)
Include
See KB#1119 to learn more about masking syntax.
Exclude
@(text)
Exclude
See KB#1119 to learn more about masking syntax.
Source directory
text
From
Target directory
text
To
This argument is required.
Verbose
true/false
Verbose
Overwrite target files
true/false
Overwrite
Rename from
text
RenameFrom
Rename to
text
RenameTo
Use regular expression
true/false
RenameRegex

Example:

# copy all files and all subdirectories beneath it to the target,
# and log each individual file that is copied, and overwrite any files
Copy-Files(
    From: E:\Source,
    To: F:\Target,
    Include: **,
    Verbose: true,
    Overwrite: true
);

Is this documentation incorrect or incomplete? Help us by contributing!

This documentation is licensed under CC-BY-SA-4.0 and stored in GitHub.

Generated from commit ced119d5 on master