Set-AzureRmStorageAccount

リファレンス

モジュール:: AzureRM.Storage

ストレージアカウントを変更します。

警告

AzureRM PowerShell モジュールは、2024 年 2 月 29 日に正式に非推奨になりました。引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。

AzureRM モジュールの機能は今後も使用できますが、メンテナンスやサポートは行われないため、引き続きの使用はユーザーの判断に委ねられ、リスクが発生することがあります。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。

構文

Set-AzureRmStorageAccount
   [-ResourceGroupName] <String>
   [-Name] <String>
   [-Force]
   [-SkuName <String>]
   [-AccessTier <String>]
   [-CustomDomainName <String>]
   [-UseSubDomain <Boolean>]
   [-Tag <Hashtable>]
   [-EnableHttpsTrafficOnly <Boolean>]
   [-StorageEncryption]
   [-AssignIdentity]
   [-NetworkRuleSet <PSNetworkRuleSet>]
   [-UpgradeToStorageV2]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzureRmStorageAccount
   [-ResourceGroupName] <String>
   [-Name] <String>
   [-Force]
   [-SkuName <String>]
   [-AccessTier <String>]
   [-CustomDomainName <String>]
   [-UseSubDomain <Boolean>]
   [-Tag <Hashtable>]
   [-EnableHttpsTrafficOnly <Boolean>]
   [-KeyvaultEncryption]
   -KeyName <String>
   -KeyVersion <String>
   -KeyVaultUri <String>
   [-AssignIdentity]
   [-NetworkRuleSet <PSNetworkRuleSet>]
   [-UpgradeToStorageV2]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

Set-AzureRmStorageAccount コマンドレットは、Azure Storage アカウントを変更します。このコマンドレットを使用して、アカウントの種類を変更したり、顧客ドメインを更新したり、ストレージアカウントでタグを設定したりすることができます。

例

例 1: ストレージアカウントの種類を設定する

PS C:\>Set-AzureRmStorageAccount -ResourceGroupName "MyResourceGroup" -AccountName "mystorageaccount" -Type "Standard_RAGRS"

このコマンドは、ストレージアカウントの種類をStandard_RAGRSに設定します。

例 2: ストレージアカウントのカスタムドメインを設定する

PS C:\>Set-AzureRmStorageAccount -ResourceGroupName "MyResourceGroup" -AccountName "mystorageaccount" -CustomDomainName "www.contoso.com" -UseSubDomain $True

このコマンドは、ストレージアカウントのカスタムドメインを設定します。

例 3: アクセス層の値を設定する

PS C:\>Set-AzureRmStorageAccount -ResourceGroupName "MyResourceGroup" -AccountName "mystorageaccount" -AccessTier Cool

このコマンドは、Access Tier の値をクールに設定します。

例 4: カスタムドメインとタグを設定する

PS C:\>Set-AzureRmStorageAccount -ResourceGroupName "MyResourceGroup" -AccountName "mystorageaccount" -CustomDomainName "www.domainname.com" -UseSubDomain $true -Tag @{tag0="value0";tag1="value1";tag2="value2"}

このコマンドは、ストレージアカウントのカスタムドメインとタグを設定します。

例 5: 暗号化 KeySource を Keyvault に設定する

PS C:\>Set-AzureRmStorageAccount -ResourceGroupName "MyResourceGroup" -AccountName "mystorageaccount" -AssignIdentity
PS C:\>$account = Get-AzureRmStorageAccount -ResourceGroupName "MyResourceGroup" -AccountName "mystorageaccount"

PS C:\>$keyVault = New-AzureRmKeyVault -VaultName "MyKeyVault" -ResourceGroupName "MyResourceGroup" -Location "EastUS2"
PS C:\>$key = Add-AzureKeyVaultKey -VaultName "MyKeyVault" -Name "MyKey" -Destination 'Software'
PS C:\>Set-AzureRmKeyVaultAccessPolicy -VaultName "MyKeyVault" -ObjectId $account.Identity.PrincipalId -PermissionsToKeys wrapkey,unwrapkey,get

PS C:\>Set-AzureRmStorageAccount -ResourceGroupName "MyResourceGroup" -AccountName "mystorageaccount" -KeyvaultEncryption -KeyName $key.Name -KeyVersion $key.Version -KeyVaultUri $keyVault.VaultUri

このコマンドは、新しく作成された Keyvault で暗号化 KeySource を設定します。

例 6: 暗号化キーソースを "Microsoft.Storage" に設定する

PS C:\>Set-AzureRmStorageAccount -ResourceGroupName "MyResourceGroup" -AccountName "mystorageaccount" -StorageEncryption

このコマンドは、Encryption KeySource を "Microsoft.Storage" に設定します

例 7: JSON を使用してストレージアカウントの NetworkRuleSet プロパティを設定する

PS C:\>Set-AzureRmStorageAccount -ResourceGroupName "MyResourceGroup" -AccountName "mystorageaccount" -NetworkRuleSet (@{bypass="Logging,Metrics";
    ipRules=(@{IPAddressOrRange="20.11.0.0/16";Action="allow"},
            @{IPAddressOrRange="10.0.0.0/7";Action="allow"});
    virtualNetworkRules=(@{VirtualNetworkResourceId="/subscriptions/s1/resourceGroups/g1/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1";Action="allow"},
                        @{VirtualNetworkResourceId="/subscriptions/s1/resourceGroups/g1/providers/Microsoft.Network/virtualNetworks/vnet2/subnets/subnet2";Action="allow"});
    defaultAction="allow"})

このコマンドは、JSON を使用してストレージアカウントの NetworkRuleSet プロパティを設定します

例 8: ストレージアカウントから NetworkRuleSet プロパティを取得し、別のストレージアカウントに設定する

PS C:\> $networkRuleSet = (Get-AzureRmStorageAccount -ResourceGroupName "MyResourceGroup" -AccountName "mystorageaccount").NetworkRuleSet 
PS C:\> Set-AzureRmStorageAccount -ResourceGroupName "MyResourceGroup" -AccountName "mystorageaccount2" -NetworkRuleSet $networkRuleSet

この最初のコマンドは、ストレージアカウントから NetworkRuleSet プロパティを取得し、2 番目のコマンドで別のストレージアカウントに設定します

例 9: 種類が "Storage" または "BlobStorage" のストレージアカウントを "StorageV2" の種類のストレージアカウントにアップグレードする

PS C:\> Set-AzureRmStorageAccount -ResourceGroupName "MyResourceGroup" -AccountName "mystorageaccount" -UpgradeToStorageV2

このコマンドは、種類が "Storage" または "BlobStorage" のストレージアカウントを "StorageV2" の種類のストレージアカウントにアップグレードします。

パラメーター

-AccessTier

このコマンドレットが変更するストレージアカウントのアクセス層を指定します。このパラメーターに使用できる値は、Hot と Cool です。アクセス層を変更すると、追加料金が発生する可能性があります。詳細については、「 Azure Blob Storage: ホットストレージ層とクールストレージ層」を参照してください。ストレージアカウントの Kind が StorageV2 または BlobStorage の場合は、 AccessTier パラメーターを指定できます。ストレージアカウントにストレージとして Kind がある場合は、 AccessTier パラメーターを指定しないでください。

型:	String
指定可能な値:	Hot, Cool
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-AsJob

バックグラウンドでコマンドレットを実行する

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-AssignIdentity

Azure KeyVault などのキー管理サービスで使用するために、このストレージアカウントの新しいストレージアカウント ID を生成して割り当てます。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Confirm

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

型:	SwitchParameter
Aliases:	cf
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CustomDomainName

カスタムドメインの名前を指定します。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DefaultProfile

Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。

型:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-EnableHttpsTrafficOnly

ストレージアカウントが HTTPS トラフィックのみを有効にするかどうかを示します。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-Force

変更をストレージアカウントに強制的に書き込みます。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-KeyName

-KeyvaultEncryption を使用して Key Vault での暗号化を有効にする場合は、このオプションで Keyname プロパティを指定します。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-KeyvaultEncryption

Storage Service Encryption を使用するときに、暗号化キーに Microsoft KeyVault を使用するかどうかを示します。 KeyName、KeyVersion、KeyVaultUri がすべて設定されている場合、このパラメーターが設定されているかどうかに関係なく、KeySource は Microsoft.Keyvault に設定されます。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-KeyVaultUri

-KeyvaultEncryption パラメーターを指定して Key Vault Encryption を使用する場合は、このオプションを使用して Key Vault の URI を指定します。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-KeyVersion

-KeyvaultEncryption パラメーターを指定して Key Vault Encryption を使用する場合は、このオプションを使用してキーバージョンの URI を指定します。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Name

変更するストレージアカウントの名前を指定します。

型:	String
Aliases:	StorageAccountName, AccountName
配置:	1
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-NetworkRuleSet

NetworkRuleSet は、ファイアウォールと仮想ネットワークの一連の構成規則を定義したり、ルールをバイパスできるサービスや、定義されたルールのいずれにも一致しない要求を処理する方法などのネットワークプロパティの値を設定するために使用されます。

型:	PSNetworkRuleSet
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ResourceGroupName

ストレージアカウントを変更するリソースグループの名前を指定します。

型:	String
配置:	0
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-SkuName

ストレージアカウントの SKU 名を指定します。このパラメーターの有効値は、次のとおりです。

Standard_LRS - ローカル冗長ストレージ。
Standard_ZRS - ゾーン冗長ストレージ。
Standard_GRS - geo 冗長ストレージ。
Standard_RAGRS - 読み取りアクセス geo 冗長ストレージ。
Premium_LRS - Premium ローカル冗長ストレージ。 Standard_ZRSとPremium_LRSの種類を他の種類のアカウントに変更することはできません。他のアカウントの種類をStandard_ZRSまたはPremium_LRSに変更することはできません。

型:	String
Aliases:	StorageAccountType, AccountType, Type
指定可能な値:	Standard_LRS, Standard_ZRS, Standard_GRS, Standard_RAGRS, Premium_LRS
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-StorageEncryption

Microsoft マネージドキーを使用するようにストレージアカウントの暗号化を設定するかどうかを示します。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Tag

サーバー上のタグとして設定されたハッシュテーブルの形式のキーと値のペア。例: @{key0="value0";key1=$null;key2="value2"}

型:	Hashtable
Aliases:	Tags
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-UpgradeToStorageV2

ストレージアカウントの種類を Storage または BlobStorage から StorageV2 にアップグレードします。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-UseSubDomain

間接 CName 検証を有効にするかどうかを示します。

型:	Nullable<T>[Boolean]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-WhatIf

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

型:	SwitchParameter
Aliases:	wi
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

入力

String

Hashtable

Boolean

出力

PSStorageAccount

次の方法で共有

Set-AzureRmStorageAccount

構文

説明

例

例 1: ストレージアカウントの種類を設定する

例 2: ストレージアカウントのカスタムドメインを設定する

例 3: アクセス層の値を設定する

例 4: カスタムドメインとタグを設定する

例 5: 暗号化 KeySource を Keyvault に設定する

例 6: 暗号化キーソースを "Microsoft.Storage" に設定する

例 7: JSON を使用してストレージアカウントの NetworkRuleSet プロパティを設定する

例 8: ストレージアカウントから NetworkRuleSet プロパティを取得し、別のストレージアカウントに設定する

例 9: 種類が "Storage" または "BlobStorage" のストレージアカウントを "StorageV2" の種類のストレージアカウントにアップグレードする

パラメーター

-AccessTier

-AsJob

-AssignIdentity

-Confirm

-CustomDomainName

-DefaultProfile

-EnableHttpsTrafficOnly

-Force

-KeyName

-KeyvaultEncryption

-KeyVaultUri

-KeyVersion

-Name

-NetworkRuleSet

-ResourceGroupName

-SkuName

-StorageEncryption

-Tag

-UpgradeToStorageV2

-UseSubDomain

-WhatIf

入力

出力

その他のリソース

次の方法で共有

Set-AzureRmStorageAccount

構文

説明

例

例 1: ストレージ アカウントの種類を設定する

例 2: ストレージ アカウントのカスタム ドメインを設定する

例 3: アクセス層の値を設定する

例 4: カスタム ドメインとタグを設定する

例 5: 暗号化 KeySource を Keyvault に設定する

例 6: 暗号化キーソースを "Microsoft.Storage" に設定する

例 7: JSON を使用してストレージ アカウントの NetworkRuleSet プロパティを設定する

例 8: ストレージ アカウントから NetworkRuleSet プロパティを取得し、別のストレージ アカウントに設定する

例 9: 種類が "Storage" または "BlobStorage" のストレージ アカウントを "StorageV2" の種類のストレージ アカウントにアップグレードする

パラメーター

-AccessTier

-AsJob

-AssignIdentity

-Confirm

-CustomDomainName

-DefaultProfile

-EnableHttpsTrafficOnly

-Force

-KeyName

-KeyvaultEncryption

-KeyVaultUri

-KeyVersion

-Name

-NetworkRuleSet

-ResourceGroupName

-SkuName

-StorageEncryption

-Tag

-UpgradeToStorageV2

-UseSubDomain

-WhatIf

入力

出力

関連リンク

その他のリソース

例 1: ストレージアカウントの種類を設定する

例 2: ストレージアカウントのカスタムドメインを設定する

例 4: カスタムドメインとタグを設定する

例 7: JSON を使用してストレージアカウントの NetworkRuleSet プロパティを設定する

例 8: ストレージアカウントから NetworkRuleSet プロパティを取得し、別のストレージアカウントに設定する

例 9: 種類が "Storage" または "BlobStorage" のストレージアカウントを "StorageV2" の種類のストレージアカウントにアップグレードする