VBScript in a Nutshell

Name

FileSystemObject.CopyFolder Method

Syntax

                  oFileSysObj
                  .CopyFolder Source, Destination [, OverwriteFiles]

oFileSysObj

Use: Required

Data Subtype: FileSystemObject object

Any object variable returning a FileSystemObject object.

Source

Use: Required

Data Subtype: String

The path and name of the folder to be copied from.

Destination

Use: Required

Data Subtype: String

The path for the folder where the copy is to be made.

OverwriteFiles

Use: Optional

Data Subtype: Boolean

Flag indicating whether existing files are to be overwritten (True) or not (False). Its default value is True; files of the same name will be overwritten if they already exist in Destination.

Description

Copies the contents of one or more folders, including their subfolders, to another location.

Rules at a Glance

• Source must end with either a wildcard character or no path separator. If it ends with a wildcard character, all matching subfolders and their contents will be copied. Wildcard characters can be used in Source only for the last component.

• Wildcard characters can’t be used in Destination.

• All subfolders and files contained within the source folder are copied to Destination unless disallowed by the wildcard characters. That is, the CopyFolder method is recursive.

• If Destination ends with a path separator or Source ends with a wildcard, CopyFolder assumes that the folder stated in Source exists in Destination or should otherwise be created. For example, given the following folder structure:

  C:\ Rootone SubFolder1 SubFolder2 ...