Copy the contents of one directory to another directory. The source
and destination directory can reside on different computers. A number
of options are available: create the destination directory, setup permissions,
copy permissions etc.
This action is typically used in a script that is intended to manage
existing user accounts and move for instance home directories. By combining
the action Copy directory and Delete directory
the Move directory action can be implemented. Besides copying
the files and directories, the security permissions can be setup for the
destination directories and files. For the permissions, three options
are available:
|
Property Name |
Description |
Typical setting |
Remarks |
|
Source directory |
The name of source directory. The source directory
can be specified in two ways: For local directories: <logical drive>\\<directory>\\<directory>
etc. Example: 'C:\\UserData\\Marketing'. For remote and local directories:
\\\\<computer>\\ <share>\\ <directory>\\ <directory>.
Example: '\\\\SERVER_A\\Users\\Data'. The source directory must exist. |
|
|
|
Destination directory |
The name of destination directory. The destination
directory can be specified in two ways: For local directories: <logical
drive>\\<directory>\\<directory> etc. Example: 'C:\\UserData\\Marketing'.
For remote and local directories: \\\\<computer>\\<share>\\<directory>\\<directory>.
Example: '\\\\SERVER_A\\Users\\Data'. If the destination directory does
not exist, it can be created. |
|
If the destination directory does not exist,
it can be created by setting property Create
destination directory to Yes.
This will create the full path if necessary. |
|
Create destination directory |
A flag indicating that the destination directory
must be created if it does not exist. Default value: 'Yes'. |
Yes |
If not specified, the default value Yes
is applied. |
|
Copy subdirectories |
Specify 'Yes' to copy the complete directory
tree, including subdirectories and files, and subdirectories of subdirectories. |
Yes |
If not specified, the default value Yes
is applied. |
|
Copy directories, no files |
Specify 'Yes' to copy directories only, no
files. Default value: 'No'. If you specify 'Yes', no files are copied,
only the directory tree is copied to the destination directory. |
No |
If not specified, the default value
No is applied. |
|
Use backup and restore privileges |
A flag indicating that backup and restore
privileges must be used to copy the directory. This property is required
in case the logged on user has no access rights to the directories and
files that must be copied. The logged on user must have the corresponding
access rights configured on the target computer to use these privileges
successfully. Default value: 'Yes'. |
Yes |
If not specified, the default value Yes
is applied. The access rights are configured using policies. Depending
on the environment, Domain security, Domain
Controller Security or Local Security policies
apply. The backup and restore privileges are configured by settings the
Backup files and directories and
Restore files and directories
policies of the User Rights Assignment
for the logged on user account. |
|
Continue on error |
A flag indicating that the copy directory
action must continue if an error occurs when copying a file or directory.
Default value: 'Yes'. |
Yes |
If set to Yes the copy action continues, but an error
will be reported and is returned by the action. |
|
Overwrite existing files |
A flag indicating that existing destination
files must be overwritten if they already exist. If you specify 'No' instead,
an error is generated and the file is not overwritten. Default value:
'Yes'. |
Yes |
|
|
Copy security option |
Copy security settings from the source directory
and files to the destination directory and files. The security settings
include the access rights, owner and auditing settings. If the security
is not explicitly specified, the security settings of the destination
parent directory determine the new security settings. |
|
See Deployment section. |
|
Setup security option |
Setup the security settings for the target
directory and files. The security settings include the access rights,
owner and auditing settings. The security settings are specified with
property 'Security settings'. If the security is not explicitly specified,
the security settings of the destination parent directory determine the
new security settings. |
|
See Deployment section. |
|
Security |
The new security settings for the target directory
and files. If you want to use this option, you must set the value of property
'Setup security option' to 'Yes'. |
|
This property is only used when the value
of property Setup security option is set to Yes. For more information, see Security
- Overview |
