Set-AzureRmStorageAccount

Referensi

Modul:: AzureRM.Storage

Memodifikasi akun Penyimpanan.

Peringatan

Modul AzureRM PowerShell telah resmi tidak digunakan lagi per 29 Februari 2024. Pengguna disarankan untuk bermigrasi dari AzureRM ke modul Az PowerShell untuk memastikan dukungan dan pembaruan yang berkelanjutan.

Meskipun modul AzureRM mungkin masih berfungsi, modul tersebut tidak lagi dipertahankan atau didukung, menempatkan penggunaan berkelanjutan berdasarkan kebijaksanaan dan risiko pengguna. Silakan merujuk ke sumber daya migrasi kami untuk panduan tentang transisi ke modul Az.

Sintaks

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>]

Deskripsi

Cmdlet Set-AzureRmStorageAccount memodifikasi akun Azure Storage. Anda dapat menggunakan cmdlet ini untuk mengubah jenis akun, memperbarui domain pelanggan, atau menetapkan tag pada akun Penyimpanan.

Contoh

Contoh 1: Atur jenis akun Penyimpanan

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

Perintah ini mengatur jenis akun Penyimpanan ke Standard_RAGRS.

Contoh 2: Mengatur domain kustom untuk akun Penyimpanan

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

Perintah ini mengatur domain kustom untuk akun Penyimpanan.

Contoh 3: Mengatur nilai tingkat akses

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

Perintah mengatur nilai Tingkat Akses menjadi dingin.

Contoh 4: Mengatur domain dan tag kustom

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

Perintah mengatur domain kustom dan tag untuk akun Storage.

Contoh 5: Atur Encryption KeySource ke 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

Perintah ini mengatur Encryption KeySource dengan Keyvault baru yang dibuat.

Contoh 6: Atur Encryption KeySource ke "Microsoft.Storage"

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

Perintah ini mengatur Encryption KeySource ke "Microsoft.Storage"

Contoh 7: Mengatur properti NetworkRuleSet dari akun Storage dengan JSON

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"})

Perintah ini mengatur properti NetworkRuleSet dari akun Storage dengan JSON

Contoh 8: Dapatkan properti NetworkRuleSet dari akun Storage, dan atur ke akun Storage lain

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

Perintah pertama ini mendapatkan properti NetworkRuleSet dari akun Storage, dan perintah kedua mengaturnya ke akun Storage lain

Contoh 9: Tingkatkan akun Penyimpanan dengan Jenis "Penyimpanan" atau "BlobStorage" ke akun Penyimpanan jenis "StorageV2"

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

Perintah meningkatkan akun Penyimpanan dengan Jenis "Penyimpanan" atau "BlobStorage" ke akun Penyimpanan jenis "StorageV2".

Parameter

-AccessTier

Menentukan tingkat akses akun Penyimpanan yang dimodifikasi cmdlet ini. Nilai yang dapat diterima untuk parameter ini adalah: Panas dan Dingin. Jika Anda mengubah tingkat akses, itu dapat mengakibatkan biaya tambahan. Untuk informasi selengkapnya, lihat Azure Blob Storage: Tingkat penyimpanan panas dan dingin. Jika akun Penyimpanan memiliki Kind as StorageV2 atau BlobStorage, Anda dapat menentukan parameter AccessTier . Jika akun Penyimpanan memiliki Kind as Storage, jangan tentukan parameter AccessTier .

Jenis:	String
Nilai yang diterima:	Hot, Cool
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-AsJob

Jalankan cmdlet di latar belakang

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-AssignIdentity

Buat dan tetapkan Identitas akun Penyimpanan baru untuk akun Penyimpanan ini untuk digunakan dengan layanan manajemen utama seperti Azure KeyVault.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

Jenis:	SwitchParameter
Alias:	cf
Position:	Named
Nilai default:	False
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-CustomDomainName

Menentukan nama domain kustom.

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-DefaultProfile

Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan Azure.

Jenis:	IAzureContextContainer
Alias:	AzureRmContext, AzureCredential
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-EnableHttpsTrafficOnly

Menunjukkan apakah akun Penyimpanan hanya mengaktifkan lalu lintas HTTPS atau tidak.

Jenis:	Boolean
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	True
Terima karakter wildcard:	False

-Force

Memaksa perubahan ditulis ke akun Storage.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-KeyName

Jika menggunakan -KeyvaultEncryption untuk mengaktifkan enkripsi dengan Key Vault, tentukan properti Keyname dengan opsi ini.

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	True
Terima input alur:	False
Terima karakter wildcard:	False

-KeyvaultEncryption

Menunjukkan apakah akan menggunakan Microsoft KeyVault untuk kunci enkripsi atau tidak saat menggunakan Enkripsi Layanan Penyimpanan. Jika KeyName, KeyVersion, dan KeyVaultUri semuanya diatur, KeySource akan diatur ke Microsoft.Keyvault apakah parameter ini diatur atau tidak.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-KeyVaultUri

Saat menggunakan Enkripsi Key Vault dengan menentukan parameter -KeyvaultEncryption, gunakan opsi ini untuk menentukan URI ke Key Vault.

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	True
Terima input alur:	False
Terima karakter wildcard:	False

-KeyVersion

Saat menggunakan Enkripsi Key Vault dengan menentukan parameter -KeyvaultEncryption, gunakan opsi ini untuk menentukan URI ke Versi Kunci.

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	True
Terima input alur:	False
Terima karakter wildcard:	False

-Name

Menentukan nama akun Penyimpanan yang akan diubah.

Jenis:	String
Alias:	StorageAccountName, AccountName
Position:	1
Nilai default:	None
Diperlukan:	True
Terima input alur:	True
Terima karakter wildcard:	False

-NetworkRuleSet

NetworkRuleSet digunakan untuk menentukan sekumpulan aturan konfigurasi untuk firewall dan jaringan virtual, serta untuk mengatur nilai untuk properti jaringan seperti layanan yang diizinkan untuk melewati aturan dan cara menangani permintaan yang tidak cocok dengan aturan yang ditentukan.

Jenis:	PSNetworkRuleSet
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-ResourceGroupName

Menentukan nama grup sumber daya untuk mengubah akun Penyimpanan.

Jenis:	String
Position:	0
Nilai default:	None
Diperlukan:	True
Terima input alur:	True
Terima karakter wildcard:	False

-SkuName

Menentukan nama SKU akun Penyimpanan. Nilai yang dapat diterima untuk parameter ini adalah:

Standard_LRS - Penyimpanan redundan lokal.
Standard_ZRS - Penyimpanan zona-redundan.
Standard_GRS - Penyimpanan geo-redundan.
Standard_RAGRS - Membaca penyimpanan geo-redundan akses.
Premium_LRS - Penyimpanan premium yang berlebihan secara lokal. Anda tidak dapat mengubah jenis Standard_ZRS dan Premium_LRS ke tipe akun lainnya. Anda tidak dapat mengubah jenis akun lain menjadi Standard_ZRS atau Premium_LRS.

Jenis:	String
Alias:	StorageAccountType, AccountType, Type
Nilai yang diterima:	Standard_LRS, Standard_ZRS, Standard_GRS, Standard_RAGRS, Premium_LRS
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	True
Terima karakter wildcard:	False

-StorageEncryption

Menunjukkan apakah akan mengatur enkripsi akun Penyimpanan untuk menggunakan kunci yang dikelola Microsoft atau tidak.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Tag

Pasangan kunci-nilai dalam bentuk tabel hash yang ditetapkan sebagai tag di server. Misalnya: @{key0="value0"; key1=$null; key2="value2"}

Jenis:	Hashtable
Alias:	Tags
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	True
Terima karakter wildcard:	False

-UpgradeToStorageV2

Tingkatkan Jenis akun Penyimpanan dari Penyimpanan atau BlobStorage ke StorageV2.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-UseSubDomain

Menunjukkan apakah akan mengaktifkan validasi CName tidak langsung.

Jenis:	Nullable<T>[Boolean]
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

Jenis:	SwitchParameter
Alias:	wi
Position:	Named
Nilai default:	False
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

Input

String

Hashtable

Boolean

Output

PSStorageAccount

Bagikan melalui

Set-AzureRmStorageAccount

Sintaks

Deskripsi

Contoh

Contoh 1: Atur jenis akun Penyimpanan

Contoh 2: Mengatur domain kustom untuk akun Penyimpanan

Contoh 3: Mengatur nilai tingkat akses

Contoh 4: Mengatur domain dan tag kustom

Contoh 5: Atur Encryption KeySource ke Keyvault

Contoh 6: Atur Encryption KeySource ke "Microsoft.Storage"

Contoh 7: Mengatur properti NetworkRuleSet dari akun Storage dengan JSON

Contoh 8: Dapatkan properti NetworkRuleSet dari akun Storage, dan atur ke akun Storage lain

Contoh 9: Tingkatkan akun Penyimpanan dengan Jenis "Penyimpanan" atau "BlobStorage" ke akun Penyimpanan jenis "StorageV2"

Parameter

-AccessTier

-AsJob

-AssignIdentity

-Confirm

-CustomDomainName

-DefaultProfile

-EnableHttpsTrafficOnly

-Force

-KeyName

-KeyvaultEncryption

-KeyVaultUri

-KeyVersion

-Name

-NetworkRuleSet

-ResourceGroupName

-SkuName

-StorageEncryption

-Tag

-UpgradeToStorageV2

-UseSubDomain

-WhatIf

Input

Output

Sumber Daya Tambahan:

Bagikan melalui

Set-AzureRmStorageAccount

Sintaks

Deskripsi

Contoh

Contoh 1: Atur jenis akun Penyimpanan

Contoh 2: Mengatur domain kustom untuk akun Penyimpanan

Contoh 3: Mengatur nilai tingkat akses

Contoh 4: Mengatur domain dan tag kustom

Contoh 5: Atur Encryption KeySource ke Keyvault

Contoh 6: Atur Encryption KeySource ke "Microsoft.Storage"

Contoh 7: Mengatur properti NetworkRuleSet dari akun Storage dengan JSON

Contoh 8: Dapatkan properti NetworkRuleSet dari akun Storage, dan atur ke akun Storage lain

Contoh 9: Tingkatkan akun Penyimpanan dengan Jenis "Penyimpanan" atau "BlobStorage" ke akun Penyimpanan jenis "StorageV2"

Parameter

-AccessTier

-AsJob

-AssignIdentity

-Confirm

-CustomDomainName

-DefaultProfile

-EnableHttpsTrafficOnly

-Force

-KeyName

-KeyvaultEncryption

-KeyVaultUri

-KeyVersion

-Name

-NetworkRuleSet

-ResourceGroupName

-SkuName

-StorageEncryption

-Tag

-UpgradeToStorageV2

-UseSubDomain

-WhatIf

Input

Output

Link Terkait

Sumber Daya Tambahan: