New-SPOMigrationPackage

Reference

Module:: Microsoft.Online.SharePoint.PowerShell

Applies to:: SharePoint Online

Note: This cmdlet has been deprecated. To migrate to SharePoint and Microsoft 365 using PowerShell, see Migrate to SharePoint using PowerShell.

Cmdlet to create a new migration package based on source files in a local or network shared folder.

Syntax

New-SPOMigrationPackage
   [-SourceFilesPath] <String>
   [-OutputPackagePath] <String>
   [[-TargetWebUrl] <String>]
   [[-TargetDocumentLibraryPath] <String>]
   [[-TargetDocumentLibrarySubFolderPath] <String>]
   [-IgnoreHidden]
   [-IncludeFileSharePermissions]
   [-NoAzureADLookup]
   [-NoLogFile]
   [-ReplaceInvalidCharacters]
   [<CommonParameters>]

Description

Cmdlet to create a new migration package based on source files in a local or network shared folder.

Note

Limits on the SPO package size and file size

Limit	Max Size (Gb)	Description
Package Size	2-4	The whole package can't exceed 4Gb
File Size	2	A single file inside the source folder can't exceed 2 Gb.
Target Size	-	target site should remain non-accessible to end user until migration is complete

Note

Limits on HTTP Get

Limit	API Get (chars)	Description
Action GET on API	260 chars	The size of the API GET request can't exceed 260 chars

Examples

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

New-SPOMigrationPackage -SourceFilesPath \\fileserver\share\folder1 -OutputPackagePath d:\MigrationPackages\Folder1_SrcPkg

New-SPOMigrationPackage -SourceFilesPath \\fileserver\share\folder1 -OutputPackagePath d:\MigrationPackages\Folder1_SrcPkg -TargetWebUrl https://contoso.sharepoint.com/sites/TargetSite/TargetWeb -TargetDocumentLibraryPath "Shared Documents" -TargetDocumentLibrarySubFolderPath "Sub Folder/Target Folder"

This example creates a new set of migration source package metadata files, using default URL values, in the d:\MigrationPackages\Folder1_SrcPkg directory based on content files found in the \fileserver\share\folder1 source location.

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

New-SPOMigrationPackage -SourceFilesPath \\fileserver\share\folder1 -OutputPackagePath d:\MigrationPackages\Folder1_SrcPkg -TargetWebUrl https://contoso.sharepoint.com/sites/TargetSite/TargetWeb -TargetDocumentLibraryPath "Shared Documents"

This example creates a new set of migration source package metadata files in the d:\MigrationPackages\Folder1_SrcPkg directory based on content files found in the \fileserver\share\folder1 source location. The package is prepared using the document library path "https://contoso.sharepoint.com/sites/TargetSite/TargetWeb/Shared Documents".

Parameters

-IgnoreHidden

Switch to ignore hidden files and folders.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Online

-IncludeFileSharePermissions

Used to include permissions and sharing information into the generated manifest files in the package metadata.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Online

-NoAzureADLookup

Switch to not lookup local user accounts in Microsoft Entra ID.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Online

-NoLogFile

Used to not create a log file. The default is to create a new CreateMigrationPackage log file within the directory specified within the OutputPackagePath parameter.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Online

-OutputPackagePath

The directory location where the output package metadata files will be saved. If the directory does not exist, it will be created.

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Online

-ReplaceInvalidCharacters

Switch to replace characters in file and folder names that would be invalid in SharePoint Online.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Online

-SourceFilesPath

The directory location where the source content files exist. This directory will be enumerated to create the package metadata files.

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Online

-TargetDocumentLibraryPath

The web relative document library to use as the document library part of the base URL in the package metadata. If this is not supplied, "Documents" will be used within the package metadata instead.

Type:	String
Position:	3
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Online

-TargetDocumentLibrarySubFolderPath

Specifies the document library relative subfolder to use as the folder path part of the base URL in the package metadata. If this is not provided, no value will be used within the package metadata. The files will be homed under the document library root.

Type:	String
Position:	4
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Online

-TargetWebUrl

The fully qualified web URL to use as the web address part of the base URL in the package metadata. If this is not provided, "http://fileserver/sites/user" will be used instead within the package metadata.

Type:	String
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Online

Inputs

None

Outputs

System.Object

Share via