---
title: "Copy-Files"
---
Copies files on a server.
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.
| Name | Format | Script Usage | Usage Notes | 
|---|---|---|---|
| Include | @(text) | Include | See KB#1119 to learn more about masking syntax. Value note: "* (top-level items)". | 
| Exclude | @(text) | Exclude | See KB#1119 to learn more about masking syntax. | 
| Source directory | text | From | Value note: "$WorkingDirectory". | 
| ☆ 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 | Default value is "False". | 
# 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
);