Edit

Share via

Import-AzureStorSimpleLegacyVolumeContainer

  • Reference
Module:
Azure

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

Import-AzureStorSimpleLegacyVolumeContainer
      -LegacyConfigId <String>
      -LegacyContainerNames <String[]>
      [-SkipACRs]
      [-Force]
      [-Profile <AzureSMProfile>]
      [<CommonParameters>]
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 commandlet

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 commandlet

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.

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

-Force

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
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 the migration plan applies.

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

-SkipACRs

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

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

Outputs

String

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