Set-SPOMigrationPackageAzureSource
Cmdlet to create Azure containers, upload migration package files into the appropriate containers and snapshot the uploaded content.
Syntax
Set-SPOMigrationPackageAzureSource
-AccountKey <String>
-AccountName <String>
[-AzureQueueName <String>]
[-EncryptionMetaInfo <MigrationFileEncryptionInfo[]>]
[-EncryptionParameters <EncryptionParameters>]
[-FileContainerName <String>]
-MigrationSourceLocations <MigrationPackageLocation>
[-NoLogFile]
[-NoSnapshotCreation]
[-NoUpload]
[-Overwrite]
[-PackageContainerName <String>]
[<CommonParameters>] Set-SPOMigrationPackageAzureSource
-AccountKey <String>
-AccountName <String>
[-AzureQueueName <String>]
[-EncryptionMetaInfo <MigrationFileEncryptionInfo[]>]
[-EncryptionParameters <EncryptionParameters>]
[-FileContainerName <String>]
[-NoLogFile]
[-NoSnapshotCreation]
[-NoUpload]
[-Overwrite]
[-PackageContainerName <String>]
-SourceFilesPath <String>
-SourcePackagePath <String>
[<CommonParameters>] Set-SPOMigrationPackageAzureSource
[-EncryptionMetaInfo <MigrationFileEncryptionInfo[]>]
[-EncryptionParameters <EncryptionParameters>]
-MigrationPackageAzureLocations <MigrationPackageAzureLocations>
-MigrationSourceLocations <MigrationPackageLocation>
[-NoLogFile]
[-NoSnapshotCreation]
[-NoUpload]
[-Overwrite]
[<CommonParameters>] Set-SPOMigrationPackageAzureSource
[-EncryptionMetaInfo <MigrationFileEncryptionInfo[]>]
[-EncryptionParameters <EncryptionParameters>]
-MigrationPackageAzureLocations <MigrationPackageAzureLocations>
[-NoLogFile]
[-NoSnapshotCreation]
[-NoUpload]
[-Overwrite]
-SourceFilesPath <String>
-SourcePackagePath <String>
[<CommonParameters>] Description
This cmdlet contains more than one parameter set. You may only use parameters from one parameter set and you may not combine parameters from different parameter sets. For more information about how to use parameter sets, see Cmdlet Parameter Sets.
This cmdlet returns a Microsoft.Online.SharePoint.Migration. MigrationPackageAzureLocations object, which can be used as a source for this cmdlet or, more commonly, as a source for the Submit-SPOMigrationJob cmdlet.
Examples
EXAMPLE 1
$azurelocations = Set-SPOMigrationPackageAzureSource -SourcePath \\fileserver\share\folder1 -OutputPackagePath d:\MigrationPackages\Folder1_TgtPkg -FileContainerUri migration-files -PackageContainerUri migration-package -AccountName migrationstore -AccountKey "nmcXQ+1NctB7BlRVm+8+qWUn6GUFIH7E5ZQPThcjg8SfFWTJ34HthyOEoROwxHYIajpOYxYDt7qUwSEBQlLWoA=="This example creates migration package containers in Azure storage using the supplied account credentials, uploads the package files into them, snapshots the files and lastly returns the connection strings to a PowerShell variable.
EXAMPLE 2
Set-SPOMigrationPackageAzureSource -SourcePath \\fileserver\share\folder1 -OutputPackagePath d:\MigrationPackages\Folder1_TgtPkg -MigrationPackageAzureLocations $azurelocations -AccountName migrationstore -AccountKey "nmcXQ+1NctB7BlRVm+8+qWUn6GUFIH7E5ZQPThcjg8SfFWTJ34HthyOEoROwxHYIajpOYxYDt7qUwSEBQlLWoA==" -NoUploadThis example uses existing migration package containers in Azure storage to snapshot previously uploaded files and then returns the connection strings to a PowerShell variable.
Parameters
-AccountKey
The account key for the Azure Storage account.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Online |
-AccountName
The account name for the Azure Storage account.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Online |
-AzureQueueName
An optional name of the Azure Storage Reporting Queue where import operations lists events during import. This value must be in lower case and conform to Azure's queue naming rules.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Online |
-EncryptionMetaInfo
PARAMVALUE: MigrationFileEncryptionInfo[]
| Type: | MigrationFileEncryptionInfo[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Online |
-EncryptionParameters
An EncryptionParameters object. See New-SPOMigrationEncryptionParameters for more information.
| Type: | EncryptionParameters |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Online |
-FileContainerName
The optional name of the Azure Blob Storage container that will be created if it does not currently exist. It will hold the uploaded package content files. The value must be in lower case and conform to Azure's container naming rules. If this not supplied a name will be generated using the format -files.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Online |
-MigrationPackageAzureLocations
A set of fully qualified URLs and SAS tokens representing the Azure Blob Storage containers that hold the package content and metadata files and an optional Azure Storage Reporting Queue. This object is returned during successful processing of the Set-SPOMigrationPackageAzureSource
| Type: | MigrationPackageAzureLocations |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Online |
-MigrationSourceLocations
Possible Source locations to migrate.
| Type: | MigrationPackageLocation |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Online |
-NoLogFile
Indicates to not create a log file. The default is to create a new CopyMigrationPackage log file within the directory specified within the SourcePackagePath parameter.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Online |
-NoSnapshotCreation
Indicates to not perform snapshots on the content in the containers. The default is to snapshot each of the packages files in the containers.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Online |
-NoUpload
Indicates to not upload the package files. The default is to upload all the package files.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Online |
-Overwrite
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Online |
-PackageContainerName
The optional name of the Azure Blob Storage container that will be created if it does not currently exist. It will hold the uploaded package metadata files. The value must be in lower case and conform to Azure's container naming rules. If this not supplied a name will be generated using the format -package.
| Type: | String |
| 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 package's source content files exist.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Online |
-SourcePackagePath
The directory location where the package's metadata files exist.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Online |
Inputs
None
Outputs
System.Object
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for