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==" -NoUpload

This 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 <GUID>-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 <GUID>-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