Udostępnij za pośrednictwem


Set-AzRedisCache

Modyfikuje usługę Azure Cache for Redis.

Składnia

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

Opis

Polecenie cmdlet Set-AzRedisCache modyfikuje usługę Azure Cache for Redis.

Przykłady

Przykład 1. Modyfikowanie usługi 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               : []

To polecenie aktualizuje zasady maxmemory-policy dla usługi Azure Cache fo Redis o nazwie MyCache.

Przykład 2: Modyfikowanie usługi Azure Cache for Redis — jeśli chcesz wyłączyć trwałość danych RDB lub 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               : []

To polecenie cmdlet wyłącza trwałość danych kopii zapasowej bazy danych RDB dla usługi Azure Cache for Redis. Można również wyłączyć trwałą pamięć podręczną kopii zapasowej AOF.

Przykład 3. Modyfikowanie usługi Azure Cache for Redis — jeśli chcesz dodać trwałość danych po utworzeniu pamięci podręcznej Azure Redis Cache.

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

To polecenie cmdlet umożliwia trwałość kopii zapasowej bazy danych rdb na istniejącej pamięci podręcznej. Możesz również włączyć trwałość kopii zapasowej.

Przykład 4. Modyfikowanie usługi Azure Cache for Redis — jeśli chcesz zmienić częstotliwość tworzenia kopii zapasowej bazy danych rdb.

Na przykład — obecnie robisz migawkę bazy danych RDB co 30 minut, ale chcesz zmienić, aby wykonać migawkę 15 minut.

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

Przykład 5: Modyfikowanie usługi Azure Cache for Redis — jeśli chcesz zmienić trwałość danych AOF na tworzenie kopii zapasowej bazy danych 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               : []

To polecenie cmdlet ułatwia zmianę metody trwałości.

Przykład 6. Skalowanie wystąpienia usługi Azure Cache for Redis — aktualizacja do innego rozmiaru.

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

To polecenie zwiększa lub zmniejsza rozmiar pamięci wystąpienia.

Przykład 7. Skalowanie wystąpienia usługi Azure Cache for Redis — aktualizacja do innej warstwy.

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

To polecenie ułatwia zmianę warstwy pamięci podręcznej. Możesz zmienić warstwę z Podstawowa na Standardowa lub Standardowa na Premium.

Przykład 8. Skalowanie wystąpienia usługi Azure Cache for Redis — włączanie klastrowania 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               : []

To polecenie cmdlet ułatwia włączenie klastrowania dla wystąpienia usługi Azure Cache for Redis. Aby zwiększyć liczbę fragmentów, najpierw należy włączyć klastrowanie.

Przykład 9. Skalowanie wystąpienia usługi Azure Cache for Redis — skalowanie w poziomie i skalowanie w poziomie klastra Redis.

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

To polecenie zwiększa lub zmniejsza rozmiar klastra.

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DisableAccessKeyAuthentication

Opcjonalnie: Uwierzytelnianie w usłudze Redis za pośrednictwem kluczy dostępu jest wyłączone po ustawieniu wartości true. Wartość domyślna to false.

Typ:String
Position:Named
Domyślna wartość:false
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-EnableNonSslPort

Wskazuje, czy port inny niż SSL jest włączony. Wartość domyślna to $False (port bez protokołu SSL jest wyłączony).

Typ:Nullable<T>[Boolean]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-IdentityType

Określa typ tożsamości używanej dla usługi Azure Cache for Redis. Prawidłowe wartości: "SystemAssigned" lub "UserAssigned" lub "SystemAssignedUserAssigned" lub "None"

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-MinimumTlsVersion

Określ wersję protokołu TLS wymaganą przez klientów do nawiązania połączenia z pamięcią podręczną.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Name

Określa nazwę usługi Azure Cache for Redis do zaktualizowania.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-RedisConfiguration

Określa ustawienia konfiguracji usługi Redis. Dopuszczalne wartości tego parametru to:

  • usługa rdb z włączoną obsługą kopii zapasowej. Określa, że włączono trwałość danych usługi Redis. Tylko warstwa Premium.
  • rdb-storage-connection-string. Określa parametry połączenia z kontem magazynu dla trwałości danych usługi Redis. Tylko warstwa Premium.
  • rdb-backup-frequency. Określa częstotliwość tworzenia kopii zapasowych dla trwałości danych usługi Redis. Tylko warstwa Premium.
  • maxmemory-reserved. Konfiguruje pamięć zarezerwowaną dla procesów innych niż pamięć podręczna. Warstwy Standardowa i Premium.
  • maxmemory-policy. Konfiguruje zasady eksmisji dla pamięci podręcznej. Wszystkie warstwy cenowe.
  • notify-keyspace-events. Konfiguruje powiadomienia dotyczące przestrzeni kluczy. Warstwy Standardowa i Premium.
  • hash-max-ziplist-entries. Konfiguruje optymalizację pamięci dla małych zagregowanych typów danych. Warstwy Standardowa i Premium.
  • hash-max-ziplist-value. Konfiguruje optymalizację pamięci dla małych zagregowanych typów danych. Warstwy Standardowa i Premium.
  • set-max-intset-entries. Konfiguruje optymalizację pamięci dla małych zagregowanych typów danych. Warstwy Standardowa i Premium.
  • zset-max-ziplist-entries. Konfiguruje optymalizację pamięci dla małych zagregowanych typów danych. Warstwy Standardowa i Premium.
  • zset-max-ziplist-value. Konfiguruje optymalizację pamięci dla małych zagregowanych typów danych. Warstwy Standardowa i Premium.
  • Baz danych. Konfiguruje liczbę baz danych. Tę właściwość można skonfigurować tylko podczas tworzenia pamięci podręcznej. Warstwy Standardowa i Premium. Aby uzyskać więcej informacji, zobacz Zarządzanie usługą Azure Redis Cache przy użyciu programu Azure PowerShellhttp://go.microsoft.com/fwlink/?LinkId=800051 (http://go.microsoft.com/fwlink/?LinkId=800051).
  • preferred-data-archive-auth-method Preferowana metoda uwierzytelniania do komunikowania się z kontem magazynu używanym na potrzeby archiwizacji danych, określenie sygnatury dostępu współdzielonego lub identyfikatora zarządzanego, wartość domyślna to SAS
  • preferred-data-persistence-auth-method Preferowana metoda uwierzytelniania do komunikowania się z kontem magazynu używanym na potrzeby trwałości danych, określenie sygnatury dostępu współdzielonego lub identyfikatora zarządzanego, wartość domyślna to SAS
Typ:Hashtable
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-RedisVersion

Wersja usługi Redis. Powinno to mieć postać "główna[pomocnicza]" (wymagana jest tylko wartość główna) lub wartość "latest", która odnosi się do najnowszej stabilnej wersji usługi Redis, która jest dostępna. Obsługiwane wersje: 4.0, 6.0 (najnowsza wersja). Wartość domyślna to "latest".

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ResourceGroupName

Określa nazwę grupy zasobów, która zawiera pamięć podręczną Redis Cache.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ShardCount

Określa liczbę fragmentów do utworzenia w pamięci podręcznej klastra Premium.

Typ:Nullable<T>[Int32]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Size

Określa rozmiar pamięci podręcznej Redis Cache. Prawidłowe wartości to:

  • 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 Wartość domyślna to 1 GB lub C1.
Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Sku

Określa jednostkę SKU pamięci podręcznej Redis Cache do utworzenia. Prawidłowe wartości to:

  • Podstawowy
  • Norma
  • Premium Wartość domyślna to Standardowa.
Typ:String
Dopuszczalne wartości:Basic, Standard, Premium
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Tag

Tabela skrótów reprezentująca tagi.

Typ:Hashtable
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-TenantSettings

Ten parametr został przestarzały.

Typ:Hashtable
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-UpdateChannel

Opcjonalnie: określa kanał aktualizacji miesięcznych aktualizacji usługi Redis, które będą odbierane przez pamięć podręczną Redis Cache. Pamięci podręczne korzystające z kanału aktualizacji "Wersja zapoznawcza" pobierają najnowsze aktualizacje usługi Redis co najmniej 4 tygodnie przed pamięciami podręcznymi kanału "Stable". Wartość domyślna to "Stable". Możliwe wartości to: "Stable", "Preview"

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-UserAssignedIdentity

Określa co najmniej jedną tożsamość użytkownika rozdzieloną przecinkami, która ma być skojarzona z usługą Azure Cache for Redis. Odwołania do tożsamości użytkownika będą identyfikatorami zasobów usługi ARM w postaci : "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identities/{identityName}"

Typ:String[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ZonalAllocationPolicy

Opcjonalnie: Opcjonalnie: określa sposób przydzielania stref dostępności do pamięci podręcznej Redis Cache. Opcja "Automatyczne" umożliwia nadmiarowość strefy, a platforma Azure automatycznie wybiera strefy na podstawie dostępności regionalnej i pojemności. Element "UserDefined" wybierze strefy dostępności przekazane za pomocą parametru "zones". Wartość "NoZones" spowoduje utworzenie nieostrej pamięci podręcznej. Jeśli wartość "zonalAllocationPolicy" nie zostanie przekazana, zostanie ona ustawiona na wartość "UserDefined", gdy strefy są przekazywane, w przeciwnym razie zostanie ustawiona wartość "Automatyczna" w regionach, w których strefy są obsługiwane i "NoZones" w regionach, w których strefy nie są obsługiwane.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

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

Dane wyjściowe

RedisCacheAttributesWithAccessKeys