Move-PnPFolder

Move a folder to another location in the current web

Syntax

Move-PnPFolder
    -Folder <String>
                  -TargetFolder <String>
                  [-Web <WebPipeBind>]
                  [-Connection <SPOnlineConnection>]

Examples

------------------EXAMPLE 1------------------

Move-PnPFolder -Folder Documents/Reports -TargetFolder 'Archived Reports'

This will move the folder Reports in the Documents library to the 'Archived Reports' library

------------------EXAMPLE 2------------------

Move-PnPFolder -Folder 'Shared Documents/Reports/2016/Templates' -TargetFolder 'Shared Documents/Reports'

This will move the folder Templates to the new location in 'Shared Documents/Reports'

Parameters

-Connection

Optional connection to be used by the cmdlet. Retrieve the value for this parameter by either specifying -ReturnConnection on Connect-PnPOnline or by executing Get-PnPConnection.

Only applicable to: SharePoint Online

Type:SPOnlineConnection
Position:Named
Accept pipeline input:False
Accept wildcard characters:False
-Folder

The folder to move

Only applicable to: SharePoint Online

Type:String
Position:Named
Accept pipeline input:False
Accept wildcard characters:False
-TargetFolder

The new parent location to which the folder should be moved to

Only applicable to: SharePoint Online

Type:String
Position:Named
Accept pipeline input:False
Accept wildcard characters:False
-Web

This parameter allows you to optionally apply the cmdlet action to a subweb within the current web. In most situations this parameter is not required and you can connect to the subweb using Connect-PnPOnline instead. Specify the GUID, server relative url (i.e. /sites/team1) or web instance of the web to apply the command to. Omit this parameter to use the current web.

Only applicable to: SharePoint Online

Type:WebPipeBind
Position:Named
Accept pipeline input:False
Accept wildcard characters:False

Outputs

Microsoft.SharePoint.Client.Folder