NavigationCmdletProvider.MoveItem(String, String) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Moves the item specified by path to the specified destination.
protected:
virtual void MoveItem(System::String ^ path, System::String ^ destination);protected:
virtual void MoveItem(Platform::String ^ path, Platform::String ^ destination); virtual void MoveItem(std::wstring const & path, std::wstring const & destination);protected virtual void MoveItem (string path, string destination);abstract member MoveItem : string * string -> unit
override this.MoveItem : string * string -> unitProtected Overridable Sub MoveItem (path As String, destination As String)Parameters
- path
- String
The path to the item to be moved.
- destination
- String
The path of the destination container.
Remarks
Providers override this method to give the user the ability to move provider objects using the move-item cmdlet.
Providers that declare ProviderCapabilities of ExpandWildcards, Filter, Include, or Exclude should ensure that the path and items being moved meets those requirements by accessing the appropriate property from the base class.
By default overrides of this method should not move objects over existing items unless the Force property is set to true. For instance, the FileSystem provider should not move c:\temp\foo.txt over c:\bar.txt if c:\bar.txt already exists unless the Force parameter is true.
If destination exists and is a container then Force isn't required and path should be moved into the destination container as a child.
The default implementation of this method throws an PSNotSupportedException.