Name

FileSystemObject.MoveFolder Method

Syntax

                  oFileSysObj
                  .MoveFolder source, destination
oFileSysObj

Use: Required

Data Subtype: FileSystemObject object

Any object variable returning a FileSystemObject object.

source

Use: Required

Data Subtype: String

The path to the folder or folders to be moved.

destination

Use: Required

Data Subtype: String

The path to the location where the folder or folders are to be moved.

Description

Moves a folder along with its files and subfolders from one location to another.

Rules at a Glance

  • source must end with either a wildcard character or no path separator.

  • Wildcard characters can be used in source, but 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 MoveFolder method is recursive.

  • If destination ends with a path separator or Source ends with a wildcard, MoveFolder assumes the folder in Source exists in Destination. For example:

    C:\
       Rootone
          SubFolder1
          SubFolder2
       RootTwo

    The command MoveFolder "c:\Rootone\*", "C:\RootTwo\" produces this folder structure:

    C:\
       Rootone
    
       RootTwo
          SubFolder1
          SubFolder2

    The command MoveFolder "c:\Rootone", "C:\RootTwo\" produces this folder structure:

    C:\
    
       RootTwo
          Rootone
             SubFolder1
             SubFolder2
  • source and destination can be either absolute or relative paths.

  • source and destination can be network paths or share names.

Programming Tips & Gotchas

  • MoveFolder resolves both ...

Get VBScript in a Nutshell now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.