Set-AzRedisCache

bir Redis için Azure Cache değiştirir.

Sözdizimi

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>]
   [-Tag <Hashtable>]
   [-IdentityType <String>]
   [-UserAssignedIdentity <String[]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Set-AzRedisCache cmdlet'i bir Redis için Azure Cache değiştirir.

Örnekler

Örnek 1: değiştirme Redis için Azure Cache

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

Bu komut, MyCache adlı Azure Cache fo Redis'iniz için maxmemory-policy değerini güncelleştirir.

Örnek 2: Redis için Azure Cache Değiştirme - RDB veya AOF Veri Kalıcılığını Devre Dışı Bırakmak istiyorsanız.

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

Bu cmdlet, Redis için Azure Cache için RDB yedekleme verilerinin kalıcılığını devre dışı bırakır. AOF yedekleme kalıcı önbelleğini de devre dışı bırakabilirsiniz.

Örnek 3: Redis için Azure Cache Değiştirme - Azure Redis Cache oluşturulduktan sonra veri kalıcılığı eklemek istiyorsanız.

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

Bu cmdlet, zaten var olan bir önbellekte rdb-backup kalıcılığını etkinleştirir. Ayrıca aof-backup kalıcılığını etkinleştirebilirsiniz.

Örnek 4: Redis için Azure Cache Değiştir - Rdb yedekleme sıklığını değiştirmek istiyorsanız.

Örneğin - Şu anda her 30 dakikada bir RDB anlık görüntüsü alıyor, ancak 15 dakika anlık görüntü alacak şekilde değiştirmek istiyorsunuz.

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

Örnek 5: Redis için Azure Cache Değiştir - AOF yedekleme verilerinin kalıcılığını RDB yedeklemesi olarak değiştirmek istiyorsanız.

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

Bu cmdlet kalıcılık yönteminin değiştirilmesine yardımcı olur.

Örnek 6: bir Redis için Azure Cache Örneğini ölçeklendirme - Farklı bir boyuta güncelleştirin.

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

Bu komut örneğinizin bellek boyutunu artırır veya azaltır.

Örnek 7: bir Redis için Azure Cache Örneğini ölçeklendirme - Farklı katmana güncelleştirme.

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

Bu komut, önbelleğinizin katmanını değiştirmenize yardımcı olur. Temel'den Standart'a veya Standart'tan Premium'a geçiş yapabilirsiniz.

Örnek 8: bir Redis için Azure Cache Örneğini ölçeklendirme - Redis Kümeleme'yi etkinleştirme.

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

Bu cmdlet, Redis için Azure Cache örneğiniz için kümeleyi etkinleştirmenize yardımcı olur. Parça sayısını artırmak için önce kümelemenin etkinleştirilmesi gerekir.

Örnek 9: Redis için Azure Cache Örneğini Ölçeklendirme - Ölçeği daraltmak/genişletmek için Redis Kümesini kullanın.

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

Bu komut küme boyutunu artırır veya azaltır.

Parametreler

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Tür:SwitchParameter
Diğer adlar:cf
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-DefaultProfile

Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.

Tür:IAzureContextContainer
Diğer adlar:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-DisableAccessKeyAuthentication

İsteğe bağlı: Erişim anahtarları aracılığıyla Redis'e kimlik doğrulaması, true olarak ayarlandığında devre dışı bırakılır. Varsayılan değer yanlış'tır.

Tür:String
Position:Named
Default value:false
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-EnableNonSslPort

SSL olmayan bağlantı noktasının etkinleştirilip etkinleştirilmediğini gösterir. Varsayılan değer $False (SSL olmayan bağlantı noktası devre dışıdır).

Tür:Nullable<T>[Boolean]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-IdentityType

Redis için Azure Cache için kullanılan kimlik türünü belirtir. Geçerli değerler: "SystemAssigned" veya "UserAssigned" ya da "SystemAssignedUserAssigned" veya "None"

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-MinimumTlsVersion

İstemcilerin önbelleğe bağlanması için gereken TLS sürümünü belirtin.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Name

Güncelleştirilecek Redis için Azure Cache adını belirtir.

Tür:String
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-RedisConfiguration

Redis yapılandırma ayarlarını belirtir. Bu parametrenin kabul edilebilir değerleri şunlardır:

  • rdb-backup etkin. Redis veri kalıcılığının etkinleştirildiğini belirtir. Yalnızca premium katman.
  • rdb-storage-connection-string. Redis veri kalıcılığı için Depolama hesabına bağlantı dizesi belirtir. Yalnızca premium katman.
  • rdb-backup-frequency. Redis veri kalıcılığı için yedekleme sıklığını belirtir. Yalnızca premium katman.
  • maxmemory-reserved. Önbellek dışı işlemler için ayrılmış belleği yapılandırır. Standart ve Premium katmanlar.
  • maxmemory-policy. Önbellek için çıkarma ilkesini yapılandırır. Tüm fiyatlandırma katmanları.
  • notify-keyspace-events. Anahtar alanı bildirimlerini yapılandırıyor. Standart ve premium katmanlar.
  • hash-max-ziplist-entries. Küçük toplama veri türleri için bellek iyileştirmeyi yapılandırıyor. Standart ve Premium katmanlar.
  • hash-max-ziplist-value. Küçük toplama veri türleri için bellek iyileştirmeyi yapılandırıyor. Standart ve Premium katmanlar.
  • set-max-intset-entrys. Küçük toplama veri türleri için bellek iyileştirmeyi yapılandırıyor. Standart ve Premium katmanlar.
  • zset-max-ziplist-entries. Küçük toplama veri türleri için bellek iyileştirmeyi yapılandırıyor. Standart ve Premium katmanlar.
  • zset-max-ziplist-value. Küçük toplama veri türleri için bellek iyileştirmeyi yapılandırıyor. Standart ve Premium katmanlar.
  • Veritaban -ları. Veritabanı sayısını yapılandırıyor. Bu özellik yalnızca önbellek oluşturma sırasında yapılandırılabilir. Standart ve Premium katmanlar. Daha fazla bilgi için bkz. Azure PowerShellhttp://go.microsoft.com/fwlink/?LinkId=800051http://go.microsoft.com/fwlink/?LinkId=800051 () ile Azure Redis Cache'i yönetme.
  • preferred-data-archive-auth-method Veri arşivi için kullanılan depolama hesabıyla iletişim kurmak, SAS veya ManagedIdentity belirtmek için tercih edilen kimlik doğrulama yöntemi, varsayılan değer SAS'dir
  • preferred-data-persistence-auth-method Veri kalıcılığı için kullanılan depolama hesabıyla iletişim kurmak için tercih edilen kimlik doğrulama yöntemi, SAS veya ManagedIdentity belirtin, varsayılan değer SAS'dir
Tür:Hashtable
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-RedisVersion

Redis sürümü. Bu, 'major[.minor]' biçiminde (yalnızca 'major' gereklidir) veya kullanılabilen en son kararlı Redis sürümünü ifade eden 'en son' değerinde olmalıdır. Desteklenen sürümler: 4.0, 6.0 (en son). Varsayılan değer 'en son' değeridir.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-ResourceGroupName

Redis Cache'i içeren kaynak grubunun adını belirtir.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-ShardCount

Premium küme önbelleğinde oluşturulacak parça sayısını belirtir.

Tür:Nullable<T>[Int32]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Size

Redis Cache'in boyutunu belirtir. Geçerli değerler:

  • P1
  • P2
  • P3
  • P4
  • P5
  • C0
  • C1
  • C2
  • C3
  • C4
  • C5
  • C6
  • 250 MB
  • 1 GB
  • 2,5 GB
  • 6 GB
  • 13 GB
  • 26 GB
  • 53 GB
  • 120 GB Varsayılan değer 1 GB veya C1'dir.
Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Sku

Oluşturulacak Redis Cache'in SKU'su belirtir. Geçerli değerler:

  • Temel
  • Standart
  • Premium Varsayılan değer Standart'tır.
Tür:String
Kabul edilen değerler:Basic, Standard, Premium
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Tag

Etiketleri temsil eden karma tablo.

Tür:Hashtable
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-TenantSettings

Bu parametre kullanım dışı bırakıldı.

Tür:Hashtable
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-UpdateChannel

İsteğe bağlı: Redis Cache'inizin alacağı aylık Redis güncelleştirmeleri için güncelleştirme kanalını belirtir. 'Önizleme' güncelleştirme kanalını kullanan önbellekler, 'Kararlı' kanal önbelleklerinden en az 4 hafta önce en son Redis güncelleştirmelerini alır. Varsayılan değer 'Kararlı'dır. Olası değerler şunlardır: 'Kararlı', 'Önizleme'

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-UserAssignedIdentity

Redis için Azure Cache ilişkilendirilecek bir veya daha fazla virgülle ayrılmış kullanıcı kimliği belirtir. Kullanıcı kimliği başvuruları şu biçimde ARM kaynak kimlikleri olacaktır: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identities/{identityName}'

Tür:String[]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Tür:SwitchParameter
Diğer adlar:wi
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

Girişler

String

Hashtable

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

Çıkışlar

RedisCacheAttributesWithAccessKeys