|Store||A Mapi.NET.Store object that represents the message store in which the folder paths reference. Note: to copy a folder to a different message store, use the SourceFolder/DestinationFolder pattern.|
|SourceFolder||A Mapi.NET.Folder object that represents the source folder to be copied.|
|DestinationFolder||A Mapi.NET.Folder object that represents the target parent folder under which the SourceFolder will be copied.|
|SourceFolderPath||A string that is the full folder path for the source folder, relative to the message store provided in the Store parameter.|
|DestinationFolderPath||A string that is the full folder path for the target parent folder, under which the folder will be copied. The path must be relative to the message store provided.|
|PathDelimiter||An optional SwitchParameter, which when present defines the path delimiter used in the SourceFolderPath and DestinationFolderPath parameters. The default path delimiter is a /" character.|
This cmdlet move a folder to a new destination.
Similar to Copy-MapiFolder, this cmdlet can move a folder and its content to another folder in the same message store or another message store.
In order to move a folder to a different message store, use of the SourceFolder and DestinationFolder parameters are required. The *FolderPath parameters are scoped to folders in the message store of the Store parameter.
Note that moving a folder is not a simple "pointer change" in the underlying database. The EntryID of an item in a folder is a combination of values, of which part of the value is the identifier of the parent folder for the item. As such, moving a folder also means that all items in that folder (but not items in subfolders) must be modified as well to change their EntryIDs. If a folder has 1000s of items, the move operation can take several minutes ore more to complete.