Note

Access to this page requires authorization. You can try signing in or .

Access to this page requires authorization. You can try .

Start-AzStorageAccountMigration

Account Migration request can be triggered for a storage account to change its redundancy level. The migration updates the non-zonal redundant storage account to a zonal redundant account or vice-versa in order to have better reliability and availability. Zone-redundant storage (ZRS) replicates your storage account synchronously across three Azure availability zones in the primary region.

Syntax

CustomerExpanded (Default)

Start-AzStorageAccountMigration
 -AccountName <String>
 -ResourceGroupName <String>
 -TargetSku <String>
 [-SubscriptionId <String>]
 [-Name <String>]
 [-Type <String>]
 [-Force]
 [-DefaultProfile <PSObject>]
 [-AsJob]
 [-NoWait]
 [-PassThru]
 [-WhatIf]
 [-Confirm]
 [<CommonParameters>]

CustomerViaJsonFilePath

Start-AzStorageAccountMigration
 -AccountName <String>
 -ResourceGroupName <String>
 -JsonFilePath <String>
 [-SubscriptionId <String>]
 [-Force]
 [-DefaultProfile <PSObject>]
 [-AsJob]
 [-NoWait]
 [-PassThru]
 [-WhatIf]
 [-Confirm]
 [<CommonParameters>]

CustomerViaJsonString

Start-AzStorageAccountMigration
 -AccountName <String>
 -ResourceGroupName <String>
 -JsonString <String>
 [-SubscriptionId <String>]
 [-Force]
 [-DefaultProfile <PSObject>]
 [-AsJob]
 [-NoWait]
 [-PassThru]
 [-WhatIf]
 [-Confirm]
 [<CommonParameters>]

CustomerViaIdentityExpanded

Start-AzStorageAccountMigration
 -InputObject <IStorageIdentity>
 -TargetSku <String>
 [-Name <String>]
 [-Type <String>]
 [-Force]
 [-DefaultProfile <PSObject>]
 [-AsJob]
 [-NoWait]
 [-PassThru]
 [-WhatIf]
 [-Confirm]
 [<CommonParameters>]

Description

Account Migration request can be triggered for a storage account to change its redundancy level. The migration updates the non-zonal redundant storage account to a zonal redundant account or vice-versa in order to have better reliability and availability. Zone-redundant storage (ZRS) replicates your storage account synchronously across three Azure availability zones in the primary region.

Examples

Example 1: Start a Storage account migration

Start-AzStorageAccountMigration -AccountName myaccount -ResourceGroupName myresourcegroup -TargetSku Standard_LRS -Name migration1 -AsJob

This command starts a migration to Standard_LRS for Storage account myaccount under resource group myresourcegroup.

Example 2: Start a Storage account migration by pipeline

Get-AzStorageAccount -ResourceGroupName myresourcegroup -Name myaccount | Start-AzStorageAccountMigration -TargetSku Standard_LRS -AsJob

The first command gets a Storage account Id, and then the second command starts a migration to Standard_LRS for Storage account myaccount under resource group myresourcegroup.

Example 3: Start a Storage account migration with Json string input

$properties = '{
 "properties": {
 "targetSkuName": "Standard_ZRS"
 }
}'
 Start-AzStorageAccountMigration -ResourceGroupName myresourcegroup -AccountName myaccount -JsonString $properties -AsJob

This command starts a Storage account migration by inputting the TargetSkuName property with a Json string.

Example 4: Start a Storage account migration with a Json file path input

# Before executing the cmdlet, make sure you have a json file that contains {"properties": {"targetSkuName": <TargetSKU>}}
Start-AzStorageAccountMigration -ResourceGroupName myresourcegroup -AccountName myaccount -JsonFilePath properties.json -AsJob

This command starts a Storage account migration by inputting the TargetSkuName property with a Json file path.

Parameters

-AccountName

The name of the storage account within the specified resource group. Storage account names must be between 3 and 24 characters in length and use numbers and lower-case letters only.

Parameter properties

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

Parameter sets

-AsJob

Run the command as a job

Parameter properties

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

Parameter sets

-Confirm

Prompts you for confirmation before running the cmdlet.

Parameter properties

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

Parameter sets

-DefaultProfile

The DefaultProfile parameter is not functional. Use the SubscriptionId parameter when available if executing the cmdlet against a different subscription.

Parameter properties

Type:PSObject
Default value:None
Supports wildcards:False
DontShow:False
Aliases:AzureRMContext, AzureCredential

Parameter sets

-Force

Forces the cmdlet to convert the account's redundancy configuration without prompting for confirmation.

Parameter properties

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

Parameter sets

-InputObject

Identity Parameter

Parameter properties

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

Parameter sets

-JsonFilePath

Path of Json file supplied to the Customer operation

Parameter properties

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

Parameter sets

-JsonString

Json string supplied to the Customer operation

Parameter properties

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

Parameter sets

-Name

current value is 'default' for customer initiated migration

Parameter properties

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

Parameter sets

-NoWait

Run the command asynchronously

Parameter properties

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

Parameter sets

-PassThru

Returns true when the command succeeds

Parameter properties

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

Parameter sets

-ResourceGroupName

The name of the resource group within the user's subscription. The name is case insensitive.

Parameter properties

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

Parameter sets

-SubscriptionId

The ID of the target subscription.

Parameter properties

Type:String
Default value:(Get-AzContext).Subscription.Id
Supports wildcards:False
DontShow:False

Parameter sets

-TargetSku

Target sku name for the account

Parameter properties

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

Parameter sets

-Type

SrpAccountMigrationType in ARM contract which is 'accountMigrations'

Parameter properties

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

Parameter sets

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Parameter properties

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

Parameter sets

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.

Inputs

IStorageIdentity

Outputs

Boolean


Feedback

Was this page helpful?