Edit

Share via


Import-AzureStorSimpleLegacyVolumeContainer

Starts the migration of volume containers.

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

MigrateSpecificContainer

Import-AzureStorSimpleLegacyVolumeContainer
    -LegacyConfigId <String>
    -LegacyContainerNames <String[]>
    [-SkipACRs]
    [-Force]
    [-Profile <AzureSMProfile>]
    [<CommonParameters>]

MigrateAllContainer

Import-AzureStorSimpleLegacyVolumeContainer
    -LegacyConfigId <String>
    [-All]
    [-SkipACRs]
    [-Force]
    [-Profile <AzureSMProfile>]
    [<CommonParameters>]

Description

The Import-AzureStorSimpleLegacyVolumeContainer cmdlet starts the migration of volume containers from a legacy appliance to the target appliance.

Examples

Example 1: Import a legacy volume container

PS C:\>Import-AzureStorSimpleLegacyVolumeContainer -LegacyConfigId "c5a831e1-7888-44f4-adf1-92994be630c3" -LegacyContainerNames "OneSDKAzureCloud"
Import started, Please check status with Get-AzureStorSimpleLegacyVolumeContainerStatus cmdlet

This command imports a legacy volume container for the named container. The cmdlet starts the import, and then returns a message.

Example 2: Import all legacy volume containers

PS C:\>Import-AzureStorSimpleLegacyVolumeContainer -LegacyConfigId "c5a831e1-7888-44f4-adf1-92994be630c3" -All
Import started, Please check status with Get-AzureStorSimpleLegacyVolumeContainerStatus cmdlet

This command imports all legacy volume containers from configuration file imported. The cmdlet starts the import, and then returns a message.

Parameters

-All

Indicates that this cmdlet imports all volume containers in the imported configuration file to the target device.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

MigrateAllContainer
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Force

Indicates that this cmdlet imports volume container on a different device, even if volume container has been imported on a different device.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-LegacyConfigId

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

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-LegacyContainerNames

Specifies an array of volume container names for which the migration plan applies.

Parameter properties

Type:

String[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

MigrateSpecificContainer
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments: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.

Parameter properties

Type:AzureSMProfile
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SkipACRs

Indicates that the import process skips access control records for migration.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Outputs

String

This command returns the status of the migration import volume container job if it has been successfully started in the appliance.