Copy File

 

Updated: May 13, 2016

Applies To: System Center 2012 SP1 - Orchestrator, System Center 2012 - Orchestrator, System Center 2012 R2 Orchestrator

The Copy File activity copies a file from one directory to another. You can also copy files to network shares that are available using UNC paths. Use the Copy File activity to copy important files that have been created or modified in a folder that is being monitored by the Monitor Folder activity to a backup location.

Configuring the Copy File Activity

Before you configure the Copy File activity, you need to know which files you are copying and the destination path where you will put the copies.

Use the following information to configure the Copy File activity.

Details Tab

Settings	Configuration Instructions
File	Type the path and name of the file that you want to copy. You can use the * and ? wildcards to specify the file name or path. These wildcards behave the same way as in the Windows Command Prompt.
Include sub-folders	Select this option to copy any files within the sub-folders of the path you have specified that match the filename that you have specified.
Folder	Type the path of the folder where you want the files to be copied to.
If the destination exists	Select the action that you want to take if a file with the same name already exists in the destination folder:  Overwrite: Select this option to overwrite the existing file with the file that is being copied.  Fail: Select this option to cause the Copy File activity to fail if the filename already exists.  Create a file with a unique name: Select this option to append a value to the filename to create a unique name that does not conflict with an existing name.

Advanced Tab

Settings	Configuration Instructions
File age	Specify Is less than or Is more than to copy the files that are older or newer, respectively, than the number of days that you specify.
days	Enter the number of days that you will use with the File age measure.
Date of transfer	Set the date of the file at the destination to the date when it was copied to the folder.
Same as original	Set the date of the file at the destination to the date of the original file.

Published Data

The following table lists the published data items.

Item	Description
Origin folder	The path of the base folder where the file was copied from.
Destination folder	The destination folder where the file was copied to.
Total number of files to be transferred	The number of files that matched the criteria that you specified.
Number of successful file operations	The number of files that were successfully copied.
Number of failed file operations	The number of files that failed to copy.
File operation status	Determines whether the copy succeeded or failed.
File path	The path of the file that was copied.
File name	The name of the file that was copied.
Name and path of the file relative to the origin folder	The relative path of the file starting from the origin folder.
If destination exists	The option that was selected to handle the operation if the destination file already exists.
File age date options	The option that was selected to evaluate the file age.
File age days	The number of days that was provided to evaluate the file age.
Modified date option	The option that was selected for the date to be assigned to the destination file.
Name and path of the destination file	The name and path that the file was copied to.
Name and path of the origin file	The name and path that the file was copied from.
Include sub-folders	Indicates whether the Include sub-folders check box was selected.
Origin folder	The path of the base folder where the file was copied from.
Destination folder	The destination folder where the file was copied to.
Total number of files to be transferred	The number of files that matched the criteria that you specified.
Number of successful file operations	The number of files that were successfully copied.
Number of failed file operations	The number of files that failed to copy.
File operation status	Determines whether the copy succeeded or failed.
File path	The path of the file that was copied.
File name	The name of the file that was copied.
Name and path of the file relative to the origin folder	The relative path of the file starting from the origin folder.
If destination exists	The option that was selected to handle the operation if the destination file already exists.
File age date options	The option that was selected to evaluate the file age.
File age days	The number of days that was provided to evaluate the file age.
Modified date option	The option that was selected for the date to be assigned to the destination file.
Name and path of the destination file	The name and path that the file was copied to.
Name and path of the origin file	The name and path that the file was copied from.
Include sub-folders	Indicates whether the Include sub-folders check box was selected.