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.