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. |