Edit

Share via

Start-AzureStorSimpleLegacyVolumeContainerMigrationPlan

  • Reference
Module:
Azure

Starts the creation of a migration plan.

Note

The cmdlets referenced in this documentation are for managing legacy Azure resources that use Azure Service Manager (ASM) APIs. This legacy PowerShell module isn't recommended when creating new resources since ASM is scheduled for retirement. For more information, see Azure Service Manager retirement.

The Az PowerShell module is the recommended PowerShell module for managing Azure Resource Manager (ARM) resources with PowerShell.

Syntax

Start-AzureStorSimpleLegacyVolumeContainerMigrationPlan
     -LegacyConfigId <String>
     -LegacyContainerNames <String[]>
     [-Profile <AzureSMProfile>]
     [<CommonParameters>]
Start-AzureStorSimpleLegacyVolumeContainerMigrationPlan
     -LegacyConfigId <String>
     [-All]
     [-Profile <AzureSMProfile>]
     [<CommonParameters>]

Description

The Start-AzureStorSimpleLegacyVolumeContainerMigrationPlan cmdlet starts the creation of a migration plan. The creation of a migration plan is asynchronous. To see the status of the migration plan, use the Get-AzureStorSimpleLegacyVolumeContainerMigrationPlan cmdlet.

Examples

Example 1: Start a migration plan

PS C:\>Start-AzureStorSimpleLegacyVolumeContainerMigrationPlan -LegacyConfigId "c5a831e1-7888-44f4-adf1-92994be630c3" -LegacyContainerNames "OneSDKAzureCloud"
Successfully started estimating the Migration Plan. Please check details with Get-AzureStorSimpleLegacyVolumeContainerMigrationPlan

This command starts creation of a migration plan for the legacy container named OneSDKAzureCloud. The command returns a message about the status of the plan, and to use the Get-AzureStorSimpleLegacyVolumeContainerMigrationPlan cmdlet for up to date information.

Example 2: Start migration plan for all volume containers

PS C:\>Start-AzureStorSimpleLegacyVolumeContainerMigrationPlan -LegacyConfigId "c5a831e1-7888-44f4-adf1-92994be630c3" -All
Successfully started estimating the Migration Plan. Please check details with Get-AzureStorSimpleLegacyVolumeContainerMigrationPlan

This command starts creation of migration plan for all legacy volume containers in the configuration file that is imported.

Parameters

-All

Indicates that this cmdlet starts migration time estimates for all volume containers in the imported configuration file.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-LegacyConfigId

Specifies the unique ID of the configuration of the legacy appliance.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-LegacyContainerNames

Specifies an array of volume container names for which to create a migration plan.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Profile

Specifies the Azure profile from which this cmdlet reads. If you do not specify a profile, this cmdlet reads from the local default profile.

Type:AzureSMProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

None

Outputs

String

This cmdlet returns the status of the migration plan job if it has been successfully started in the appliance.