Rename File

 

Updated: May 13, 2016

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

The Rename File activity renames files on the local file system or on a network location specified using a UNC path. You can automatically rename files to a standard format according to your data center procedures.

Before you configure the Rename File activity, you need to determine the following:

  • The original file name you are renaming.

  • The new name of the file

Use the following information to configure the Rename File activity.

Details Tab

SettingsConfiguration Instructions
FolderType the path of the folder that contains the files that you want to rename.
Include sub-foldersSelect this option to rename any files in the subfolders of the folder that you specified that match the file names that you want to rename.
DestinationThis list displays all the file names that will be renamed when this activity runs. To add a filename, click Add to open the Rename Properties dialog box, and specify the Old name and then specify the file New name.

To edit the list of file names, click Edit. To remove file names, click Remove.

Advanced Tab

SettingsConfiguration Instructions
File ageSpecify Is less than or Is more than to rename the files that are older or newer, respectively, than the number of days that you specify.
daysType the number of days that you will use with the File age measure.
Date of renameSelect this option to set the date of the file at the destination to the date when it was renamed.
Same as originalSelect this option to set the date of the file at the destination to the date of the original file.
Destination already existsSelect the action that you want to take if a file with the same name already exists in the folder:

 Overwrite: Select this option to overwrite the existing file with the file that is being renamed.

 Fail: Select this option to cause the Rename 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.

Published Data

The following table lists the published data items.

ItemDescription
File pathThe path of the file that was renamed.
Include sub-foldersIndicates whether this option was selected.
Destination folderThe destination folder of the file that was renamed.
If destination existsThe option that was selected for handling the filename if the file existed in the destination folder.
Modified date optionThe option that was selected for assigning a modified date to the file in the destination folder.
File age daysThe number of days used in the File age filter.
Destination dateThe option that was selected for assigning a destination date to the file in the destination folder.
Total number of files to be renamedThe number of files that were renamed by the operation.
Number of successful file operationsThe number of successful operations that occurred.
Number of failed file operationsThe number of failed operations that occurred.
Origin folderThe folder where the file originated from.
Name and path of the destination fileThe name and path of the destination file.
File nameThe filename of the origin file.
Name and path of the file relative to the origin folderThe relative path of the file, relative to the origin folder.
Name and path of the origin fileThe name and path of the origin file.
File operation statusThe status of the rename operation.
Pattern that matched fileThe pattern that the user entered that matched the file or files that were found.
Pattern file renamed toThe pattern that the file or files were renamed.
Show: