Bagikan melalui


Set-AzRedisCache

Memodifikasi Azure Cache for Redis.

Sintaks

Set-AzRedisCache
   [-ResourceGroupName <String>]
   -Name <String>
   [-Size <String>]
   [-Sku <String>]
   [-RedisConfiguration <Hashtable>]
   [-EnableNonSslPort <Boolean>]
   [-TenantSettings <Hashtable>]
   [-ShardCount <Int32>]
   [-MinimumTlsVersion <String>]
   [-DisableAccessKeyAuthentication <Boolean>]
   [-RedisVersion <String>]
   [-UpdateChannel <String>]
   [-ZonalAllocationPolicy <String>]
   [-Tag <Hashtable>]
   [-IdentityType <String>]
   [-UserAssignedIdentity <String[]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Deskripsi

Cmdlet Set-AzRedisCache memodifikasi Azure Cache for Redis.

Contoh

Contoh 1: Memodifikasi Azure Cache for Redis

Set-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -RedisConfiguration @{"maxmemory-policy" = "allkeys-random"}

PrimaryKey         : ******
          SecondaryKey       : ******
          ResourceGroupName  : mygroup
          Id                 : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/myCache
          Location           : North Central US
          Name               : MyCache
          Type               : Microsoft.Cache/Redis
          HostName           : mycache.redis.cache.windows.net
          Port               : 6379
          ProvisioningState  : creating
          SslPort            : 6380
          RedisConfiguration : {[maxmemory-policy, allkeys-random]}
          EnableNonSslPort   : False
          RedisVersion       : 2.8
          Size               : 250MB
          Sku                : Standard
          Tag                : {}
          Zone               : []

Perintah ini memperbarui kebijakan maxmemory untuk Azure Cache fo Redis Anda bernama MyCache.

Contoh 2: Ubah Azure Cache for Redis - Jika Anda ingin Menonaktifkan Persistensi Data RDB atau AOF.

Set-AzRedisCache -Name "MyCache"  -RedisConfiguration @{"rdb-backup-enabled" = "false"}

PrimaryKey         : ******
          SecondaryKey       : ******
          ResourceGroupName  : MyGroup
          Id                 : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/MyCache
          Location           : Central US
          Name               : mycache
          Type               : Microsoft.Cache/Redis
          HostName           : mycache.redis.cache.windows.net
          Port               : 6379
          ProvisioningState  : Succeeded
          SslPort            : 6380
          RedisConfiguration : {[maxmemory-policy, allkeys-random], [maxclients, 7500], [maxmemory-reserved, 200],
                                [maxfragmentationmemory-reserved, 300], [rdb-backup-enabled, false]...} 
          EnableNonSslPort   : False
          RedisVersion       : 4.0.14
          Size               : 6GB
          Sku                : Premium
          Tag                : {}
          Zone               : []

Cmdlet ini menonaktifkan persistensi data cadangan RDB untuk Azure Cache for Redis. Anda juga dapat menonaktifkan cache persisten cadangan AOF.

Contoh 3: Ubah Azure Cache for Redis - Jika Anda ingin menambahkan persistensi data setelah azure redis cache dibuat.

Set-AzRedisCache -Name "MyCache" -RedisConfiguration @{"rdb-backup-enabled" = "true"; "rdb-storage-connection-string" = "DefaultEndpointsProtocol=https;AccountName=mystorageaccount;AccountKey=******;EndpointSuffix=mySuffix"; "rdb-backup-frequency" = "30"}

PrimaryKey         : ******
          SecondaryKey       : ******
          ResourceGroupName  : MyGroup
          Id                 : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/MyCache
          Location           : Central US
          Name               : mycache
          Type               : Microsoft.Cache/Redis
          HostName           : mycache.redis.cache.windows.net
          Port               : 6379
          ProvisioningState  : Succeeded
          SslPort            : 6380
          RedisConfiguration : {[maxmemory-policy, allkeys-random], [maxclients, 7500], [maxmemory-reserved, 200],
                                [maxfragmentationmemory-reserved, 300], [rdb-backup-enabled, true]....} 
          EnableNonSslPort   : False
          RedisVersion       : 4.0.14
          Size               : 6GB
          Sku                : Premium
          Tag                : {}
          Zone               : []

Cmdlet ini memungkinkan persistensi cadangan rdb pada cache yang sudah ada. Anda juga dapat mengaktifkan persistensi cadangan aof.

Contoh 4: Ubah Azure Cache for Redis - Jika Anda ingin mengubah frekuensi pencadangan rdb.

Misalnya - Saat ini Anda mengambil rekam jepret RDB dalam setiap 30 menit, tetapi Anda ingin mengubah untuk mengambil rekam jepret 15 menit.

Set-AzRedisCache -Name "MyCache" -RedisConfiguration @{"rdb-backup-frequency" = "15"}

PrimaryKey         : ******
          SecondaryKey       : ******
          ResourceGroupName  : MyGroup
          Id                 : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/MyCache
          Location           : Central US
          Name               : mycache
          Type               : Microsoft.Cache/Redis
          HostName           : mycache.redis.cache.windows.net
          Port               : 6379
          ProvisioningState  : Succeeded
          SslPort            : 6380
          RedisConfiguration : {[maxmemory-policy, allkeys-random], [maxclients, 7500], [maxmemory-reserved, 200],
                                [maxfragmentationmemory-reserved, 300], [rdb-backup-enabled, true]....} 
          EnableNonSslPort   : False
          RedisVersion       : 4.0.14
          Size               : 6GB
          Sku                : Premium
          Tag                : {}
          Zone               : []

Contoh 5: Ubah Azure Cache for Redis - Jika Anda ingin mengubah persistensi data cadangan AOF ke cadangan RDB.

Set-AzRedisCache -Name "MyCache"  -RedisConfiguration @{"aof-backup-enabled"= "false"; "rdb-backup-enabled" = "true"; "rdb-storage-connection-string" = "DefaultEndpointsProtocol=https;AccountName=mystorageaccount;AccountKey=******;EndpointSuffix=mySuffix"; "rdb-backup-frequency" = "30"}

PrimaryKey         : ******
          SecondaryKey       : ******
          ResourceGroupName  : MyGroup
          Id                 : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/MyCache
          Location           : Central US
          Name               : mycache
          Type               : Microsoft.Cache/Redis
          HostName           : mycache.redis.cache.windows.net
          Port               : 6379
          ProvisioningState  : Succeeded
          SslPort            : 6380
          RedisConfiguration : {[maxmemory-policy, allkeys-random], [maxclients, 7500], [maxmemory-reserved, 200],
                                [maxfragmentationmemory-reserved, 300], [rdb-backup-enabled, true]....} 
          EnableNonSslPort   : False
          RedisVersion       : 4.0.14
          Size               : 6GB
          Sku                : Premium
          Tag                : {}
          Zone               : []

Cmdlet ini membantu dalam mengubah metode persistensi.

Contoh 6: Skalakan Instans Azure Cache for Redis - Perbarui ke ukuran yang berbeda.

Set-AzRedisCache -Name "MyCache" -Size "P2" -Sku "Premium"

PrimaryKey         : ******
          SecondaryKey       : ******
          ResourceGroupName  : MyGroup
          Id                 : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/MyCache
          Location           : Central US
          Name               : mycache
          Type               : Microsoft.Cache/Redis
          HostName           : mycache.redis.cache.windows.net
          Port               : 6379
          ProvisioningState  : Scaling
          SslPort            : 6380
          RedisConfiguration : {[maxmemory-policy, allkeys-random], [maxclients, 7500], [maxmemory-reserved, 200],
                                [maxfragmentationmemory-reserved, 300]....} 
          EnableNonSslPort   : False
          RedisVersion       : 4.0.14
          Size               : 6GB
          Sku                : Premium
          Tag                : {}
          Zone               : []

Perintah ini meningkatkan atau mengurangi ukuran memori instans Anda.

Contoh 7: Menskalakan Instans Azure Cache for Redis - Perbarui ke tingkat yang berbeda.

Set-AzRedisCache -Name "MyCache" -Size "P1" -Sku "Premium"

PrimaryKey         : ******
          SecondaryKey       : ******
          ResourceGroupName  : MyGroup
          Id                 : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/MyCache
          Location           : Central US
          Name               : mycache
          Type               : Microsoft.Cache/Redis
          HostName           : mycache.redis.cache.windows.net
          Port               : 6379
          ProvisioningState  : Scaling
          SslPort            : 6380
          RedisConfiguration : {[maxmemory-policy, allkeys-random], [maxclients, 7500], [maxmemory-reserved, 200],
                                [maxfragmentationmemory-reserved, 300]....} 
          EnableNonSslPort   : False
          RedisVersion       : 4.0.14
          Size               : 1GB
          Sku                : Standard
          Tag                : {}
          Zone               : []

Perintah ini membantu Anda mengubah tingkat cache Anda. Anda dapat mengubah dari Dasar ke Standar, atau Standar ke Premium.

Contoh 8: Menskalakan Instans Azure Cache for Redis - Aktifkan Pengklusteran Redis.

Set-AzRedisCache -Name "MyCache" -ShardCount 1

PrimaryKey         : ******
          SecondaryKey       : ******
          ResourceGroupName  : MyGroup
          Id                 : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/MyCache
          Location           : Central US
          Name               : mycache
          Type               : Microsoft.Cache/Redis
          HostName           : mycache.redis.cache.windows.net
          Port               : 6379
          ProvisioningState  : Scaling
          SslPort            : 6380
          RedisConfiguration : {[maxmemory-policy, allkeys-random], [maxclients, 7500], [maxmemory-reserved, 200],
                                [maxfragmentationmemory-reserved, 300]....} 
          EnableNonSslPort   : False
          RedisVersion       : 4.0.14
          Size               : 6GB
          Sku                : Premium
          ShardCount         :
          Tag                : {}
          Zone               : []

Cmdlet ini membantu Anda mengaktifkan pengklusteran untuk instans Azure Cache for Redis Anda. Untuk meningkatkan jumlah shard, harus mengaktifkan pengklusteran terlebih dahulu.

Contoh 9: Menskalakan Instans Azure Cache for Redis - Gunakan Kluster Redis untuk menskalakan masuk/keluar.

Set-AzRedisCache -Name "MyCache" -ShardCount 2

PrimaryKey         : ******
          SecondaryKey       : ******
          ResourceGroupName  : MyGroup
          Id                 : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/MyCache
          Location           : Central US
          Name               : mycache
          Type               : Microsoft.Cache/Redis
          HostName           : mycache.redis.cache.windows.net
          Port               : 6379
          ProvisioningState  : Scaling
          SslPort            : 6380
          RedisConfiguration : {[maxmemory-policy, allkeys-random], [maxclients, 7500], [maxmemory-reserved, 200],
                                [maxfragmentationmemory-reserved, 300]....} 
          EnableNonSslPort   : False
          RedisVersion       : 4.0.14
          Size               : 6GB
          Sku                : Premium
          ShardCount         : 1
          Tag                : {}
          Zone               : []

Perintah ini menambah atau mengurangi ukuran kluster.

Parameter

-Confirm

Meminta konfirmasi sebelum menjalankan cmdlet.

Jenis:SwitchParameter
Alias:cf
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:AzContext, AzureRmContext, AzureCredential
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-DisableAccessKeyAuthentication

Opsional: Autentikasi ke Redis melalui kunci akses dinonaktifkan saat diatur sebagai true. Nilai defaultnya adalah false.

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

-EnableNonSslPort

Menunjukkan apakah port non-SSL diaktifkan. Nilai default adalah $False (port non-SSL dinonaktifkan).

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

-IdentityType

Menentukan jenis identitas yang digunakan untuk Azure Cache for Redis. Nilai yang valid: "SystemAssigned" atau "UserAssigned" atau "SystemAssignedUserAssigned" atau "None"

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

-MinimumTlsVersion

Tentukan versi TLS yang diperlukan oleh klien untuk menyambungkan ke cache.

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

-Name

Menentukan nama Azure Cache for Redis yang akan diperbarui.

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

-RedisConfiguration

Menentukan pengaturan konfigurasi Redis. Nilai yang dapat diterima untuk parameter ini adalah:

  • rdb-backup-enabled. Menentukan bahwa persistensi data Redis diaktifkan. Tingkat premium saja.
  • rdb-storage-connection-string. Menentukan string koneksi ke akun Penyimpanan untuk persistensi data Redis. Tingkat premium saja.
  • rdb-backup-frequency. Menentukan frekuensi pencadangan untuk persistensi data Redis. Tingkat premium saja.
  • maxmemory-reserved. Mengonfigurasi memori yang dicadangkan untuk proses non-cache. Tingkat Standar dan Premium.
  • maxmemory-policy. Mengonfigurasi kebijakan pengeluaran untuk cache. Semua tingkat harga.
  • notify-keyspace-events. Mengonfigurasi pemberitahuan keyspace. Tingkat standar dan premium.
  • hash-max-ziplist-entries. Mengonfigurasi pengoptimalan memori untuk jenis data agregat kecil. Tingkat Standar dan Premium.
  • hash-max-ziplist-value. Mengonfigurasi pengoptimalan memori untuk jenis data agregat kecil. Tingkat Standar dan Premium.
  • set-max-intset-entries. Mengonfigurasi pengoptimalan memori untuk jenis data agregat kecil. Tingkat Standar dan Premium.
  • zset-max-ziplist-entries. Mengonfigurasi pengoptimalan memori untuk jenis data agregat kecil. Tingkat Standar dan Premium.
  • zset-max-ziplist-value. Mengonfigurasi pengoptimalan memori untuk jenis data agregat kecil. Tingkat Standar dan Premium.
  • Database. Mengonfigurasi jumlah database. Properti ini hanya dapat dikonfigurasi pada pembuatan cache. Tingkat Standar dan Premium. Untuk informasi selengkapnya, lihat Mengelola Azure Redis Cache dengan Azure PowerShellhttp://go.microsoft.com/fwlink/?LinkId=800051 (http://go.microsoft.com/fwlink/?LinkId=800051).
  • metode autentikasi pilihan-arsip-arsip-data metode autentikasi untuk berkomunikasi ke akun penyimpanan yang digunakan untuk arsip data, tentukan SAS atau ManagedIdentity, nilai defaultnya adalah SAS
  • metode autentikasi pilihan-data-persistence-auth-method Untuk berkomunikasi ke akun penyimpanan yang digunakan untuk persistensi data, tentukan SAS atau ManagedIdentity, nilai defaultnya adalah SAS
Jenis:Hashtable
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-RedisVersion

Versi Redis. Ini harus dalam bentuk 'major[.minor]' (hanya 'mayor' yang diperlukan) atau nilai 'terbaru' yang mengacu pada versi Redis stabil terbaru yang tersedia. Versi yang didukung: 4.0, 6.0 (terbaru). Nilai defaultnya adalah 'terbaru'.

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

-ResourceGroupName

Menentukan nama grup sumber daya yang berisi Redis Cache.

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

-ShardCount

Menentukan jumlah shard yang akan dibuat pada cache kluster Premium.

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

-Size

Menentukan ukuran Redis Cache. Nilai yang valid adalah:

  • P1
  • P2
  • P3
  • P4
  • P5
  • C0
  • C1
  • C2
  • C3
  • C4
  • C5
  • C6
  • 250MB
  • 1GB
  • 2,5 GB
  • 6GB
  • 13GB
  • 26GB
  • 53GB
  • 120GB Nilai defaultnya adalah 1GB atau C1.
Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-Sku

Menentukan SKU Cache Redis yang akan dibuat. Nilai yang valid adalah:

  • Dasar
  • Standar
  • Premium Nilai defaultnya adalah Standar.
Jenis:String
Nilai yang diterima:Basic, Standard, Premium
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-Tag

Tabel hash yang mewakili tag.

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

-TenantSettings

Parameter ini tidak digunakan lagi.

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

-UpdateChannel

Opsional: Menentukan saluran pembaruan untuk pembaruan Redis bulanan yang akan diterima Redis Cache Anda. Cache yang menggunakan saluran pembaruan 'Pratinjau' mendapatkan pembaruan Redis terbaru setidaknya 4 minggu sebelum cache saluran 'Stabil'. Nilai defaultnya adalah 'Stabil'. Nilai yang mungkin termasuk: 'Stabil', 'Pratinjau'

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

-UserAssignedIdentity

Menentukan satu atau beberapa identitas pengguna yang dipisahkan koma untuk dikaitkan dengan Azure Cache for Redis. Referensi identitas pengguna akan menjadi id sumber daya ARM dalam formulir: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identities/{identityName}'

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

-WhatIf

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

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

-ZonalAllocationPolicy

Opsional: Opsional: Menentukan bagaimana zona ketersediaan dialokasikan ke cache Redis. 'Otomatis' memungkinkan redundansi zona dan Azure akan secara otomatis memilih zona berdasarkan ketersediaan dan kapasitas regional. 'UserDefined' akan memilih zona ketersediaan yang diteruskan oleh Anda menggunakan parameter 'zona'. 'NoZones' akan menghasilkan cache non-zonal. Jika 'zonalAllocationPolicy' tidak diteruskan, itu akan diatur ke 'UserDefined' ketika zona diteruskan, jika tidak, itu akan diatur ke 'Otomatis' di wilayah di mana zona didukung dan 'NoZones' di wilayah di mana zona tidak didukung.

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

Input

Nullable<T>[[System.Boolean, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

Nullable<T>[[System.Int32, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

Output