Move-MapiFolder

Description

This cmdlet moves a selected folder to be a child of another folder.

Syntax
Note: Parameters in orange are optional.
Move-MapiFolder
-SourceFolderMapiObject<Mapi.NET.Folder>
-DestinationFolderMapiObject<Mapi.NET.Folder>
Move-MapiFolder
-StoreMapiObject<Mapi.NET.Store>
-SourceFolderPathString
-DestinationFolderPathString
-PathDelimiterString
Parameters
StoreA 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.
SourceFolderA Mapi.NET.Folder object that represents the source folder to be copied.
DestinationFolderA Mapi.NET.Folder object that represents the target parent folder under which the SourceFolder will be copied.
SourceFolderPathA string that is the full folder path for the source folder, relative to the message store provided in the Store parameter.
DestinationFolderPathA 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.
PathDelimiterAn optional SwitchParameter, which when present defines the path delimiter used in the SourceFolderPath and DestinationFolderPath parameters. The default path delimiter is a /" character.
Remarks

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.