Start-AzStorageAccountMigration

  • リファレンス
モジュール:
Az.Storage

ストレージ アカウントの冗長性レベルを変更するために、アカウント移行要求をトリガーできます。 移行では、信頼性と可用性を向上させるために、ゾーン冗長以外のストレージ アカウントをゾーン冗長アカウントに更新するか、その逆に更新します。 ゾーン冗長ストレージ (ZRS) は、プライマリ リージョンの 3 つの Azure 可用性ゾーン間でストレージ アカウントを同期的にレプリケートします。

構文

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

説明

ストレージ アカウントの冗長性レベルを変更するために、アカウント移行要求をトリガーできます。 移行では、信頼性と可用性を向上させるために、ゾーン冗長以外のストレージ アカウントをゾーン冗長アカウントに更新するか、その逆に更新します。 ゾーン冗長ストレージ (ZRS) は、プライマリ リージョンの 3 つの Azure 可用性ゾーン間でストレージ アカウントを同期的にレプリケートします。

例

例 1: ストレージ アカウントの移行を開始する

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

このコマンドは、リソース グループ myresourcegroup のストレージ アカウント myaccount のStandard_LRSへの移行を開始します。

例 2: パイプラインによるストレージ アカウントの移行を開始する

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

最初のコマンドはストレージ アカウント ID を取得し、次に 2 番目のコマンドは、リソース グループ myresourcegroup のストレージ アカウント myaccount のStandard_LRSへの移行を開始します。

例 3: Json 文字列入力を使用してストレージ アカウントの移行を開始する

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

このコマンドは、Json 文字列を使用して TargetSkuName プロパティを入力することで、ストレージ アカウントの移行を開始します。

例 4: Json ファイル パス入力を使用してストレージ アカウントの移行を開始する

# 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

このコマンドは、Json ファイル パスを使用して TargetSkuName プロパティを入力することで、ストレージ アカウントの移行を開始します。

パラメーター

-AccountName

指定されたリソース グループ内のストレージ アカウントの名前。 ストレージ アカウント名の長さは 3 ～ 24 文字で、数字と小文字のみを使用する必要があります。

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

-AsJob

コマンドをジョブとして実行する

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

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

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

-DefaultProfile

DefaultProfile パラメーターは機能しません。 別のサブスクリプションに対してコマンドレットを実行する場合は、使用可能な場合は SubscriptionId パラメーターを使用します。

Type:PSObject
Aliases:AzureRMContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

ID パラメーターを構築するには、INPUTOBJECT プロパティの NOTES セクションを参照し、ハッシュ テーブルを作成します。

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

-JsonFilePath

Customer 操作に指定された Json ファイルのパス

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

-JsonString

Customer 操作に指定された Json 文字列

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

-Name

現在の値は、顧客が開始した移行の "既定値" です

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

-NoWait

コマンドを非同期的に実行する

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

-PassThru

コマンドが成功したときに true を返します。

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

-ResourceGroupName

ユーザーのサブスクリプション内のリソース グループの名前。 名前の大文字と小文字は区別されます。

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

-SubscriptionId

ターゲット サブスクリプションの ID。

Type:String
Position:Named
Default value:(Get-AzContext).Subscription.Id
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TargetSku

アカウントのターゲット SKU 名

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

-Type

'accountMigrations' である ARM コントラクトの SrpAccountMigrationType

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

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

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

入力

IStorageIdentity

出力

Boolean