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