Move-PnPFolder.md

external help file	applicable	schema
	SharePoint Server 2013, SharePoint Server 2016, SharePoint Online	2.0.0

Move-PnPFolder

SYNOPSIS

Move a folder to another location in the current web

SYNTAX

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

EXAMPLES

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

PS:> 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------------------

PS:> 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

-Folder

The folder to move

Type: String
Parameter Sets: (All)

Required: True
Position: Named
Accept pipeline input: False

-TargetFolder

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

Type: String
Parameter Sets: (All)

Required: True
Position: Named
Accept pipeline input: False

-Connection

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

Type: SPOnlineConnection
Parameter Sets: (All)

Required: False
Position: Named
Accept pipeline input: 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.

Type: WebPipeBind
Parameter Sets: (All)

Required: False
Position: Named
Accept pipeline input: False

RELATED LINKS

SharePoint Developer Patterns and Practices