Command
Copy-List
Description
The command to copy lists or libraries from a SharePoint site to another.
Tips:
You will find how to adapt any Copy-List script to perform an incremental migration in the Incremental update using PowerShell article.
To learn how to replicate your copy options from the app in PowerShell click here.
Index
Examples
Get Lists to Copy
$srcSite = Connect-Site -Url "http://myfarm1/sites/mysourcesite" $dstSite = Connect-Site -Url "http://myfarm1/sites/mydestinationsite" $toCopy = Get-List -Site $srcSite Copy-List -List $toCopy -DestinationSite $dstSite
Copy All Lists
$srcSite = Connect-Site -Url "http://myfarm1/sites/mysourcesite" $dstSite = Connect-Site -Url "http://myfarm1/sites/mydestinationsite" Copy-List -All -SourceSite $srcSite -DestinationSite $dstSite
Copy Some Lists
$srcSite = Connect-Site -Url "http://myfarm1/sites/mysourcesite" $dstSite = Connect-Site -Url "http://myfarm1/sites/mydestinationsite" Copy-List -SourceSite $srcSite -Name MyTitle*,MySpecificTitle -DestinationSite $dstSite
Note: The * symbol is used to call multiple objects with a similar name.
Copy All Lists Pre-Check
$srcSite = Connect-Site -Url "http://myfarm1/sites/mysourcesite" $dstSite = Connect-Site -Url "http://myfarm1/sites/mydestinationsite" Copy-List -All -SourceSite $srcSite -DestinationSite $dstSite -WhatIf
Copy and Rename One List
$srcSite = Connect-Site -Url "http://myfarm1/sites/mysourcesite" $dstSite = Connect-Site -Url "http://myfarm1/sites/mydestinationsite" Copy-List -SourceSite $srcSite -Name MyTitle*,MySpecificTitle -DestinationSite $dstSite -ListTitleUrlSegment "MyTitleNewUrl" -ListTitle "MyNewTitle"
Note: The * symbol is used to call multiple objects with a similar name.
Syntax
Copy-List-List <List[]>-DestinationSite <Site>[-ListTitle <String>][-ListTitleUrlSegment <String>][-NoContent <SwitchParameter>][-VersionLimit <Int32>][-NoCustomPermissions <SwitchParameter>][-NoWorkflows <SwitchParameter>][-NoSiteFeatures <SwitchParameter>][-NoWebParts <SwitchParameter>][-NoCustomizedListForms <SwitchParameter>][-NoListViews <SwitchParameter>][-NoNintexWorkflowHistory <SwitchParameter>][-UserAlerts <SwitchParameter>][-NormalMode <SwitchParameter>][-WaitForImportCompletion <SwitchParameter>][-ForceNewListExperience <SwitchParameter>][-WhatIf <SwitchParameter>][-CopySettings <CopySettings>][-MappingSettings <MappingSettings>][-TaskName <String>]
Copy-List-Name <String[]>-SourceSite <Site>-DestinationSite <Site>[-ListTitle <String>][-ListTitleUrlSegment <String>][-NoContent <SwitchParameter>][-VersionLimit <Int32>][-NoCustomPermissions <SwitchParameter>][-NoWorkflows <SwitchParameter>][-NoSiteFeatures <SwitchParameter>][-NoWebParts <SwitchParameter>][-NoCustomizedListForms <SwitchParameter>][-NoListViews <SwitchParameter>][-NoNintexWorkflowHistory <SwitchParameter>][-UserAlerts <SwitchParameter>][-NormalMode <SwitchParameter>][-WaitForImportCompletion <SwitchParameter>][-ForceNewListExperience <SwitchParameter>][-WhatIf <SwitchParameter>][-CopySettings <CopySettings>][-MappingSettings <MappingSettings>][-TaskName <String>]
Copy-List-All <SwitchParameter>-SourceSite <Site>-DestinationSite <Site>[-ListTitle <String>][-ListTitleUrlSegment <String>][-NoContent <SwitchParameter>][-VersionLimit <Int32>][-NoCustomPermissions <SwitchParameter>][-NoWorkflows <SwitchParameter>][-NoSiteFeatures <SwitchParameter>][-NoWebParts <SwitchParameter>][-NoCustomizedListForms <SwitchParameter>][-NoListViews <SwitchParameter>][-NoNintexWorkflowHistory <SwitchParameter>][-UserAlerts <SwitchParameter>][-NormalMode <SwitchParameter>][-WaitForImportCompletion <SwitchParameter>][-ForceNewListExperience <SwitchParameter>][-WhatIf <SwitchParameter>][-CopySettings <CopySettings>][-MappingSettings <MappingSettings>][-TaskName <String>]
Parameters
-All <SwitchParameter>
Specifies that they all be copied.
Required? | True |
Default value | None |
Accept pipeline input? | False |
Accept wildcard characters? | False |
Parameter set name | All |
Aliases | None |
-CopySettings <CopySettings>
Specifies the copy settings.
Required? | False |
Default value | None |
Accept pipeline input? | True (ByValue, ByPropertyName) |
Accept wildcard characters? | False |
Parameter set name | (All) |
Aliases | None |
-DestinationSite <Site>
Specifies the destination site.
Required? | True |
Default value | None |
Accept pipeline input? | False |
Accept wildcard characters? | False |
Parameter set name | (All) |
Aliases | None |
-ForceNewListExperience <SwitchParameter>
Specifies that the command will convert lists to the New Microsoft 365 Experience when possible.
Required? | False |
Default value | None |
Accept pipeline input? | False |
Accept wildcard characters? | False |
Parameter set name | (All) |
Aliases | None |
-List <List[]>
Specifies the source lists or libraries to copy.
Required? | True |
Default value | None |
Accept pipeline input? | True (ByValue, ByPropertyName) |
Accept wildcard characters? | False |
Parameter set name | Default |
Aliases | None |
-ListTitle <String>
Specifies the new list title. This parameter must be used with the 'ListTitleUrlSegment' parameter and can not be used when copying more than one list.
Required? | False |
Default value | None |
Accept pipeline input? | False |
Accept wildcard characters? | False |
Parameter set name | (All) |
Aliases | None |
-ListTitleUrlSegment <String>
Specifies the new list url. This parameter must be used with the 'ListTitle' parameter and can not be used when copying more than one list.
Required? | False |
Default value | None |
Accept pipeline input? | False |
Accept wildcard characters? | False |
Parameter set name | (All) |
Aliases | None |
-MappingSettings <MappingSettings>
Specifies the mapping settings.
Required? | False |
Default value | None |
Accept pipeline input? | False |
Accept wildcard characters? | False |
Parameter set name | (All) |
Aliases | None |
-Name <String[]>
Specifies the name (Wildcards supported).
Required? | True |
Default value | None |
Accept pipeline input? | False |
Accept wildcard characters? | True |
Parameter set name | Name |
Aliases | None |
-NoContent <SwitchParameter>
Specifies that all list items, documents, folders and document sets inside the lists and libraries won't be copied.
Required? | False |
Default value | None |
Accept pipeline input? | False |
Accept wildcard characters? | False |
Parameter set name | (All) |
Aliases | None |
-NoCustomizedListForms <SwitchParameter>
Specifies that customized list forms and content type forms won't be copied.
Required? | False |
Default value | None |
Accept wildcard characters? | False |
Parameter set name | (All) |
Aliases | None |
-NoCustomPermissions <SwitchParameter>
Specifies that everything will be set to inherit the permissions from its parent.
Required? | False |
Default value | None |
Accept pipeline input? | False |
Accept wildcard characters? | False |
Parameter set name | (All) |
Aliases | None |
-NoListViews <SwitchParameter>
Specifies that list views won't be copied.
Required? | False |
Default value | None |
Accept pipeline input? | False |
Accept wildcard characters? | False |
Parameter set name | (All) |
Aliases | None |
-NoNintexWorkflowHistory <SwitchParameter>
Specifies that the history for Nintex workflows associated with the migrated objects won't be copied to the destination.
Required? | False |
Default value | None |
Accept pipeline input? | False |
Accept wildcard characters? | False |
Parameter set name | (All) |
Aliases | None |
-NormalMode <SwitchParameter>
Specifies that the normal mode should be used.
Note: Insane mode is always used by default in PowerShell.
Required? | False |
Default value | None |
Accept pipeline input? | False |
Accept wildcard characters? | False |
Parameter set name | (All) |
Aliases | None |
-NoSiteFeatures <SwitchParameter>
Specifies that all the site and site collection features that are required by the elements being copied won't be automatically activated.
Required? | False |
Default value | None |
Accept pipeline input? | False |
Accept wildcard characters? | False |
Parameter set name | (All) |
Aliases | None |
-NoWebParts <SwitchParameter>
Specifies that the web parts won't be copied when copying pages.
Required? | False |
Default value | None |
Accept pipeline input? | False |
Accept wildcard characters? | False |
Parameter set name | (All) |
Aliases | None |
-NoWorkflows <SwitchParameter>
Specifies that the workflows associated with the migrated objects won't be copied to the destination.
Required? | False |
Default value | None |
Accept pipeline input? | False |
Accept wildcard characters? | False |
Parameter set name | (All) |
Aliases | None |
-SourceSite <Site>
Specifies the source site.
Required? | True |
Default value | None |
Accept pipeline input? | True (ByValue, ByPropertyName) |
Accept wildcard characters? | False |
Parameter set name | Name, All |
Aliases | None |
-TaskName <String>
Specifies a name for the task.
Required? | False |
Default value | None |
Accept pipeline input? | False |
Accept wildcard characters? | False |
Parameter set name | (All) |
Aliases | None |
-UserAlerts <SwitchParameter>
Specifies that the User Alerts associated with the migrated objects will be copied to the destination.
Required? | False |
Default value | None |
Accept pipeline input? | False |
Accept wildcard characters? | False |
Parameter set name | (All) |
Aliases | None |
-VersionLimit <Int32>
Specifies to copy the X latest version, while always conserving at least one Major version.
Required? | False |
Default value | None |
Accept pipeline input? | False |
Accept wildcard characters? | False |
Parameter set name | (All) |
Aliases | None |
-WaitForImportCompletion <SwitchParameter>
Specifies that the command will wait for azure insane mode import to be completed.
Required? | False |
Default value | None |
Accept pipeline input? | False |
Accept wildcard characters? | False |
Parameter set name | (All) |
Aliases | None |
-WhatIf <SwitchParameter>
Specifies that a pre-check will be executed instead of a migration. For more information, see Run a Pre-Check in PowerShell.
Required? | False |
Default value | None |
Accept pipeline input? | False |
Accept wildcard characters? | False |
Parameter set name | (All) |
Aliases | None |