Set-AzRedisCache

Upraví Azure Cache for Redis.

Syntaxe

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

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 rutiny zobrazí výzvu k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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 false.

Typ:String
Position:Named
Default value:false
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-EnableNonSslPort

Určuje, jestli je povolený port bez SSL. Výchozí hodnota je $False (port bez SSL je zakázaný).

Typ:Nullable<T>[Boolean]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-IdentityType

Určuje typ identity, který se používá pro Azure Cache for Redis. Platné hodnoty: SystemAssigned nebo UserAssigned nebo SystemAssignedUserAssigned nebo None

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-MinimumTlsVersion

Zadejte verzi protokolu TLS vyžadovanou klienty pro připojení k mezipaměti.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Name

Určuje název azure Cache for Redis, který se má aktualizovat.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-RedisConfiguration

Určuje nastavení konfigurace Redis. Tento parametr přijímá tyto hodnoty:

  • 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 PowerShelluhttp://go.microsoft.com/fwlink/?LinkId=800051 (http://go.microsoft.com/fwlink/?LinkId=800051).
  • 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.
Typ:Hashtable
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky: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".

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ResourceGroupName

Určuje název skupiny prostředků, která obsahuje Mezipaměť Redis.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ShardCount

Určuje počet horizontálních oddílů, které se mají vytvořit v mezipaměti clusteru Premium.

Typ:Nullable<T>[Int32]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Size

Určuje velikost mezipaměti Redis Cache. Platné hodnoty jsou:

  • O1
  • P2
  • P3
  • P4
  • P5
  • C0
  • S1
  • C2
  • C3
  • C4
  • C5
  • C6
  • 250 MB
  • 1GB
  • 2,5 GB
  • 6 GB
  • 13 GB
  • 26 GB
  • 53 GB
  • 120 GB Výchozí hodnota je 1 GB nebo C1.
Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky: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.
Typ:String
Přípustné hodnoty:Basic, Standard, Premium
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Tag

Tabulka hash, která představuje značky.

Typ:Hashtable
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-TenantSettings

Tento parametr je zastaralý.

Typ:Hashtable
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky: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.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-UserAssignedIdentity

Určuje jednu nebo více identit uživatele s hodnocením čárkami, 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}.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

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

Výstupy

RedisCacheAttributesWithAccessKeys