Set-AzRedisCache
Upraví Azure Cache for Redis.
Syntax
Default (Výchozí)
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>]
Description
Rutina Set-AzRedisCache upravuje Azure Cache for Redis.
Příklady
Příklad 1: Úprava 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 : []
Tento příkaz aktualizuje zásady maxmemory-policy pro vaši službu Azure Cache fo Redis s názvem MyCache .
Příklad 2: Úprava služby Azure Cache for Redis – Pokud chcete zakázat trvalost dat RDB nebo 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 : []
Tato rutina zakáže trvalost zálohovaných dat RDB pro Azure Cache for Redis. Můžete také zakázat trvalou mezipaměť zálohování AOF.
Příklad 3: Úprava služby Azure Cache for Redis – Pokud chcete po vytvoření mezipaměti Azure Redis přidat trvalost dat.
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 : []
Tato rutina umožňuje trvalost zálohování rdb v již existující mezipaměti. Můžete také povolit trvalost zálohování.
Příklad 4: Úprava služby Azure Cache for Redis – Pokud chcete změnit frekvenci zálohování rdb.
Například – V současné době pořizujete snímek RDB každých 30 minut, ale chcete změnit pořízení snímku 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 : []
Příklad 5: Úprava služby Azure Cache for Redis – Pokud chcete změnit trvalost dat AOF na zálohování 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 : []
Tato rutina pomáhá při změně metody trvalosti.
Příklad 6: Škálování instance Azure Cache for Redis – Aktualizace na jinou velikost
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 : []
Tento příkaz zvýší nebo zmenší velikost paměti vaší instance.
Příklad 7: Škálování instance Azure Cache for Redis – Aktualizace na jinou úroveň
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 : []
Tento příkaz vám pomůže změnit úroveň mezipaměti. Můžete přejít z úrovně Basic na Standard nebo Standard na Premium.
Příklad 8: Škálování instance Azure Cache for Redis – Povolení clusteringu 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 : []
Tato rutina vám pomůže povolit clustering pro instanci Azure Cache for Redis. Pokud chcete zvýšit počet horizontálních oddílů, musíte nejprve povolit clustering.
Příklad 9: Škálování instance Azure Cache for Redis – Horizontální navýšení nebo snížení kapacity pomocí clusteru 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 : []
Tento příkaz zvětší nebo zmenší velikost clusteru.
Parametry
-Confirm
Před spuštěním cmdletu vás vyzve k potvrzení.
Vlastnosti parametru
Typ: SwitchParameter
Default value: None Podporuje zástupné znaky: False DontShow: False Aliasy: viz
Sady parametrů
(All)
Position: Named Povinné: False Hodnota z kanálu: False Hodnota z kanálu podle názvu vlastnosti: False Hodnota ze zbývajících argumentů: False
-DefaultProfile
Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.
Vlastnosti parametru
Typ: IAzureContextContainer
Default value: None Podporuje zástupné znaky: False DontShow: False Aliasy: AzContext, AzureRmContext, AzureCredential
Sady parametrů
(All)
Position: Named Povinné: False Hodnota z kanálu: False Hodnota z kanálu podle názvu vlastnosti: False Hodnota ze zbývajících argumentů: False
-DisableAccessKeyAuthentication
Volitelné: Ověřování pro Redis prostřednictvím přístupových klíčů je zakázané, pokud je nastavená hodnota true. Výchozí hodnotou je nepravda.
Vlastnosti parametru
Typ: String
Default value: false Podporuje zástupné znaky: False DontShow: False
Sady parametrů
(All)
Position: Named Povinné: False Hodnota z kanálu: False Hodnota z kanálu podle názvu vlastnosti: True Hodnota ze zbývajících argumentů: False
-EnableNonSslPort
Určuje, jestli je povolený port bez SSL.
Výchozí hodnota je $False (port bez SSL je zakázaný).
Vlastnosti parametru
Sady parametrů
(All)
Position: Named Povinné: False Hodnota z kanálu: False Hodnota z kanálu podle názvu vlastnosti: True Hodnota ze zbývajících argumentů: False
-IdentityType
Určuje typ identity, který se používá pro Azure Cache for Redis. Platné hodnoty: SystemAssigned nebo UserAssigned nebo SystemAssignedUserAssigned nebo None
Vlastnosti parametru
Typ: String
Default value: None Podporuje zástupné znaky: False DontShow: False
Sady parametrů
(All)
Position: Named Povinné: False Hodnota z kanálu: False Hodnota z kanálu podle názvu vlastnosti: True Hodnota ze zbývajících argumentů: False
-MinimumTlsVersion
Zadejte verzi protokolu TLS vyžadovanou klienty pro připojení k mezipaměti.
Vlastnosti parametru
Typ: String
Default value: None Podporuje zástupné znaky: False DontShow: False
Sady parametrů
(All)
Position: Named Povinné: False Hodnota z kanálu: False Hodnota z kanálu podle názvu vlastnosti: True Hodnota ze zbývajících argumentů: False
-Name
Určuje název azure Cache for Redis, který se má aktualizovat.
Vlastnosti parametru
Typ: String
Default value: None Podporuje zástupné znaky: False DontShow: False
Sady parametrů
(All)
Position: Named Povinné: True Hodnota z kanálu: False Hodnota z kanálu podle názvu vlastnosti: True Hodnota ze zbývajících argumentů: False
-RedisConfiguration
Určuje nastavení konfigurace Redis.
Přijatelné hodnoty pro tento parametr jsou:
Povoleno zálohování rdb.
Určuje, že je povolena trvalost dat Redis.
Pouze úroveň Premium.
rdb-storage-connection-string.
Určuje připojovací řetězec k účtu úložiště pro trvalost dat Redis.
Pouze úroveň Premium.
rdb-backup-frequency.
Určuje frekvenci zálohování pro trvalost dat Redis.
Pouze úroveň Premium.
maxmemory-reserved.
Nakonfiguruje paměť vyhrazenou pro procesy mimo mezipaměť.
Úrovně Standard a Premium.
maxmemory-policy.
Nakonfiguruje zásadu vyřazení pro mezipaměť.
Všechny cenové úrovně.
notify-keyspace-events.
Konfiguruje oznámení o prostoru klíčů.
Úrovně Standard a Premium.
hash-max-ziplist-entries.
Konfiguruje optimalizaci paměti pro malé agregované datové typy.
Úrovně Standard a Premium.
hash-max-ziplist-value.
Konfiguruje optimalizaci paměti pro malé agregované datové typy.
Úrovně Standard a Premium.
set-max-intset-entries.
Konfiguruje optimalizaci paměti pro malé agregované datové typy.
Úrovně Standard a Premium.
zset-max-ziplist-entries.
Konfiguruje optimalizaci paměti pro malé agregované datové typy.
Úrovně Standard a Premium.
zset-max-ziplist-value.
Konfiguruje optimalizaci paměti pro malé agregované datové typy.
Úrovně Standard a Premium.
databáze.
Konfiguruje počet databází.
Tuto vlastnost lze nakonfigurovat pouze při vytváření mezipaměti.
Úrovně Standard a Premium.
Další informace najdete v tématu Správa služby Azure Redis Cache pomocí Azure PowerShellu .
preferred-data-archive-auth-method Preferred auth method to communicate to storage account used for data archive, specify SAS or ManagedIdentity, default value is SAS
upřednostňovaná metoda ověřování metodou preferovaného ověřování dat pro komunikaci s účtem úložiště používaným pro trvalost dat, zadání SAS nebo ManagedIdentity, výchozí hodnota je SAS.
Vlastnosti parametru
Typ: Hashtable
Default value: None Podporuje zástupné znaky: False DontShow: False
Sady parametrů
(All)
Position: Named Povinné: False Hodnota z kanálu: False Hodnota z kanálu podle názvu vlastnosti: True Hodnota ze zbývajících argumentů: False
-RedisVersion
Verze Redis. Mělo by to být ve formátu major[.minor] (vyžaduje se pouze hlavní) nebo hodnota "latest", která odkazuje na nejnovější stabilní verzi Redis, která je k dispozici. Podporované verze: 4.0, 6.0 (nejnovější). Výchozí hodnota je "latest".
Vlastnosti parametru
Typ: String
Default value: None Podporuje zástupné znaky: False DontShow: False
Sady parametrů
(All)
Position: Named Povinné: False Hodnota z kanálu: False Hodnota z kanálu podle názvu vlastnosti: True Hodnota ze zbývajících argumentů: False
-ResourceGroupName
Určuje název skupiny prostředků, která obsahuje Mezipaměť Redis.
Vlastnosti parametru
Typ: String
Default value: None Podporuje zástupné znaky: False DontShow: False
Sady parametrů
(All)
Position: Named Povinné: False Hodnota z kanálu: False Hodnota z kanálu podle názvu vlastnosti: True Hodnota ze zbývajících argumentů: False
-ShardCount
Určuje počet horizontálních oddílů, které se mají vytvořit v mezipaměti clusteru Premium.
Vlastnosti parametru
Typ: Nullable<T> [ Int32 ]
Default value: None Podporuje zástupné znaky: False DontShow: False
Sady parametrů
(All)
Position: Named Povinné: False Hodnota z kanálu: False Hodnota z kanálu podle názvu vlastnosti: True Hodnota ze zbývajících argumentů: False
-Size
Určuje velikost mezipaměti Redis Cache.
Platné hodnoty jsou:
P1
P2
P3
P4
P5
C0
C1
C2
C3
C4
C5
C6
250 MB
1GB
2,5 GB
6GB
13 GB
26 GB
53 GB
120 GB Výchozí hodnota je 1 GB nebo C1.
Vlastnosti parametru
Typ: String
Default value: None Podporuje zástupné znaky: False DontShow: False
Sady parametrů
(All)
Position: Named Povinné: False Hodnota z kanálu: False Hodnota z kanálu podle názvu vlastnosti: True Hodnota ze zbývajících argumentů: False
-Sku
Určuje skladovou položku mezipaměti Redis, která se má vytvořit.
Platné hodnoty jsou:
Basic
Standard
Premium Výchozí hodnota je Standard.
Vlastnosti parametru
Typ: String
Default value: None Přípustné hodnoty: Basic, Standard, Premium Podporuje zástupné znaky: False DontShow: False
Sady parametrů
(All)
Position: Named Povinné: False Hodnota z kanálu: False Hodnota z kanálu podle názvu vlastnosti: True Hodnota ze zbývajících argumentů: False
-Tag
Tabulka hash, která představuje značky.
Vlastnosti parametru
Typ: Hashtable
Default value: None Podporuje zástupné znaky: False DontShow: False
Sady parametrů
(All)
Position: Named Povinné: False Hodnota z kanálu: False Hodnota z kanálu podle názvu vlastnosti: True Hodnota ze zbývajících argumentů: False
-TenantSettings
Tento parametr je zastaralý.
Vlastnosti parametru
Typ: Hashtable
Default value: None Podporuje zástupné znaky: False DontShow: False
Sady parametrů
(All)
Position: Named Povinné: False Hodnota z kanálu: False Hodnota z kanálu podle názvu vlastnosti: True Hodnota ze zbývajících argumentů: False
-UpdateChannel
Volitelné: Určuje aktualizační kanál pro měsíční aktualizace Redis, které bude vaše služba Redis Cache přijímat. Mezipaměti používající aktualizační kanál Preview získávají nejnovější aktualizace Redis alespoň 4 týdny před mezipaměťmi kanálů Stable. Výchozí hodnota je Stabilní. Mezi možné hodnoty patří: Stabilní, Preview.
Vlastnosti parametru
Typ: String
Default value: None Podporuje zástupné znaky: False DontShow: False
Sady parametrů
(All)
Position: Named Povinné: False Hodnota z kanálu: False Hodnota z kanálu podle názvu vlastnosti: True Hodnota ze zbývajících argumentů: False
-UserAssignedIdentity
Určuje jednu nebo více čárkami oddělených identit uživatelů, které se mají přidružit ke službě Azure Cache for Redis. Odkazy na identitu uživatele budou ID prostředků ARM ve formuláři: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identityies/{identityName}.
Vlastnosti parametru
Typ: String [ ]
Default value: None Podporuje zástupné znaky: False DontShow: False
Sady parametrů
(All)
Position: Named Povinné: False Hodnota z kanálu: False Hodnota z kanálu podle názvu vlastnosti: True Hodnota ze zbývajících argumentů: False
-WhatIf
Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.
Vlastnosti parametru
Typ: SwitchParameter
Default value: None Podporuje zástupné znaky: False DontShow: False Aliasy: Wi
Sady parametrů
(All)
Position: Named Povinné: False Hodnota z kanálu: False Hodnota z kanálu podle názvu vlastnosti: False Hodnota ze zbývajících argumentů: False
-ZonalAllocationPolicy
Volitelné: Volitelné: Určuje, jak se zóny dostupnosti přidělují do mezipaměti Redis. Možnost Automatické umožňuje redundanci zón a Azure automaticky vybere zóny na základě regionální dostupnosti a kapacity. UserDefined vybere zóny dostupnosti předané vámi pomocí parametru zones. NoZones vytvoří zónovou mezipaměť. Pokud se nepředá 'zonalAllocationPolicy', nastaví se při předávání zón na Hodnotu UserDefined. V opačném případě se v oblastech, kde jsou zóny podporované, nastaví na Hodnotu Automatic a NoZones v oblastech, ve kterých nejsou zóny podporovány.
Vlastnosti parametru
Typ: String
Default value: None Podporuje zástupné znaky: False DontShow: False
Sady parametrů
(All)
Position: Named Povinné: False Hodnota z kanálu: False Hodnota z kanálu podle názvu vlastnosti: True Hodnota ze zbývajících argumentů: False
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters .
Výstupy
