Delen via


Set-AzRedisCache

Hiermee wijzigt u een Azure Cache voor Redis.

Syntaxis

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

De cmdlet Set-AzRedisCache wijzigt een Azure Cache voor Redis.

Voorbeelden

Voorbeeld 1: Azure Cache voor Redis wijzigen

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

Met deze opdracht wordt het maxmemory-beleid voor uw Azure Cache fo Redis bijgewerkt met de naam MyCache.

Voorbeeld 2: Azure Cache voor Redis wijzigen: als u RDB of AOF-gegevenspersistentie wilt uitschakelen.

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

Met deze cmdlet wordt de persistentie van RDB-back-upgegevens voor Azure Cache voor Redis uitgeschakeld. U kunt ook permanente AOF-back-upcache uitschakelen.

Voorbeeld 3: Azure Cache voor Redis wijzigen: als u gegevenspersistentie wilt toevoegen nadat azure Redis Cache is gemaakt.

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

Met deze cmdlet kunt u rdb-backup persistentie uitvoeren op een al bestaande cache. U kunt ook persistentie van aof-back-ups inschakelen.

Voorbeeld 4: Azure Cache voor Redis wijzigen: als u een back-upfrequentie van rdb wilt wijzigen.

Bijvoorbeeld: momenteel maakt u een RDB-momentopname in elke 30 minuten, maar u wilt een momentopname van 15 minuten maken.

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

Voorbeeld 5: Azure Cache voor Redis wijzigen: als u een back-up van AOF-gegevenspersistentie wilt wijzigen in EEN RDB-back-up.

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

Deze cmdlet helpt bij het wijzigen van de persistentiemethode.

Voorbeeld 6: Een Exemplaar van Azure Cache voor Redis schalen: bijwerken naar een andere grootte.

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

Met deze opdracht wordt de geheugengrootte van uw exemplaar vergroot of verkleind.

Voorbeeld 7: Een Exemplaar van Azure Cache voor Redis schalen: bijwerken naar een andere laag.

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

Met deze opdracht kunt u de laag van uw cache wijzigen. U kunt overstappen van Basic naar Standard of Standard naar Premium.

Voorbeeld 8: Een Exemplaar van Azure Cache voor Redis schalen : Redis-clustering inschakelen.

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

Deze cmdlet helpt u bij het inschakelen van clustering voor uw Exemplaar van Azure Cache voor Redis. Als u het aantal shards wilt verhogen, moet u eerst clustering inschakelen.

Voorbeeld 9: Een Exemplaar van Azure Cache voor Redis schalen- Gebruik Redis-cluster om in/uit te schalen.

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

Met deze opdracht wordt de clustergrootte vergroot of verkleind.

Parameters

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DisableAccessKeyAuthentication

Optioneel: verificatie bij Redis via toegangssleutels is uitgeschakeld wanneer deze is ingesteld als waar. De standaardwaarde is onwaar.

Type:String
Position:Named
Default value:false
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-EnableNonSslPort

Geeft aan of de niet-SSL-poort is ingeschakeld. De standaardwaarde is $False (de niet-SSL-poort is uitgeschakeld).

Type:Nullable<T>[Boolean]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-IdentityType

Hiermee geeft u het type identiteit op dat wordt gebruikt voor Azure Cache voor Redis. Geldige waarden: 'SystemAssigned' of 'UserAssigned' of 'SystemAssignedUserAssigned' of 'None'

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-MinimumTlsVersion

Geef de TLS-versie op die clients nodig hebben om verbinding te maken met de cache.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Name

Hiermee geeft u de naam op van de Azure Cache voor Redis die moet worden bijgewerkt.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-RedisConfiguration

Hiermee geeft u Redis-configuratie-instellingen. De acceptabele waarden voor deze parameter zijn:

  • rdb-backup ingeschakeld. Hiermee geeft u op dat Redis-gegevenspersistentie is ingeschakeld. Alleen de Premium-laag.
  • rdb-storage-connection-string. Hiermee geeft u de verbindingsreeks voor het opslagaccount voor Redis-gegevenspersistentie op. Alleen de Premium-laag.
  • rdb-backup-frequency. Hiermee geeft u de back-upfrequentie voor Redis-gegevenspersistentie. Alleen de Premium-laag.
  • maxmemory-reserved. Hiermee configureert u het geheugen dat is gereserveerd voor niet-cacheprocessen. Standard- en Premium-lagen.
  • maxmemory-beleid. Hiermee configureert u het verwijderingsbeleid voor de cache. Alle prijscategorieën.
  • notify-keyspace-events. Hiermee configureert u keyspacemeldingen. Standard- en Premium-lagen.
  • hash-max-ziplist-vermeldingen. Hiermee configureert u geheugenoptimalisatie voor kleine geaggregeerde gegevenstypen. Standard- en Premium-lagen.
  • hash-max-ziplist-value. Hiermee configureert u geheugenoptimalisatie voor kleine geaggregeerde gegevenstypen. Standard- en Premium-lagen.
  • set-max-intset-entries. Hiermee configureert u geheugenoptimalisatie voor kleine geaggregeerde gegevenstypen. Standard- en Premium-lagen.
  • zset-max-ziplist-vermeldingen. Hiermee configureert u geheugenoptimalisatie voor kleine geaggregeerde gegevenstypen. Standard- en Premium-lagen.
  • zset-max-ziplist-value. Hiermee configureert u geheugenoptimalisatie voor kleine geaggregeerde gegevenstypen. Standard- en Premium-lagen.
  • Databases. Hiermee configureert u het aantal databases. Deze eigenschap kan alleen worden geconfigureerd bij het maken van de cache. Standard- en Premium-lagen. Zie Azure Redis Cache beheren met Azure PowerShellhttp://go.microsoft.com/fwlink/?LinkId=800051 (http://go.microsoft.com/fwlink/?LinkId=800051) voor meer informatie.
  • preferred-data-archive-auth-method Preferred authentication method to communicate to storage account used for data archive, specify SAS or ManagedIdentity, default value is SAS
  • preferred-data-persistence-auth-method Preferred auth-method to communicate to storage account used for data persistence, specify SAS or ManagedIdentity, default value is SAS
Type:Hashtable
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-RedisVersion

Redis-versie. Dit moet de vorm 'major[.minor]' hebben (alleen 'major' is vereist) of de waarde 'latest' die verwijst naar de meest recente stabiele Redis-versie die beschikbaar is. Ondersteunde versies: 4.0, 6.0 (nieuwste versie). De standaardwaarde is 'latest'.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ResourceGroupName

Hiermee geeft u de naam van de resourcegroep die de Redis Cache bevat.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ShardCount

Hiermee geeft u het aantal shards op dat moet worden gemaakt in een Premium-clustercache.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Size

Hiermee geeft u de grootte van de Redis Cache. Geldige waarden zijn:

  • 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 De standaardwaarde is 1 GB of C1.
Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Sku

Hiermee geeft u de SKU van de Redis Cache te maken. Geldige waarden zijn:

  • Basisch
  • Standaard
  • Premium De standaardwaarde is Standard.
Type:String
Geaccepteerde waarden:Basic, Standard, Premium
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Tag

Een hash-tabel die tags vertegenwoordigt.

Type:Hashtable
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-TenantSettings

Deze parameter is afgeschaft.

Type:Hashtable
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-UpdateChannel

Optioneel: Hiermee geeft u het updatekanaal voor de maandelijkse Redis-updates op die uw Redis-cache ontvangt. Caches die gebruikmaken van het updatekanaal 'Preview' krijgen de meest recente Redis-updates ten minste 4 weken voor de 'Stabiele' kanaalcaches. De standaardwaarde is 'Stabiel'. Mogelijke waarden zijn: 'Stabiel', 'Preview'

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-UserAssignedIdentity

Hiermee geeft u een of meer door komma's gescheiden gebruikersidentiteiten op die moeten worden gekoppeld aan De Azure Cache voor Redis. De verwijzingen naar gebruikersidentiteiten zijn ARM-resource-id's in de vorm: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identities/{identityName}'

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ZonalAllocationPolicy

Optioneel: Geeft aan hoe beschikbaarheidszones worden toegewezen aan de Redis-cache. 'Automatisch' maakt zoneredundantie mogelijk en Azure selecteert automatisch zones op basis van regionale beschikbaarheid en capaciteit. UserDefined selecteert beschikbaarheidszones die door u worden doorgegeven met behulp van de parameter Zones. 'NoZones' produceert een niet-zonegebonden cache. Als 'zonealAllocationPolicy' niet wordt doorgegeven, wordt deze ingesteld op UserDefined wanneer zones worden doorgegeven, anders wordt deze ingesteld op 'Automatisch' in regio's waar zones worden ondersteund en 'NoZones' in regio's waar zones niet worden ondersteund.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Invoerwaarden

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

Uitvoerwaarden

RedisCacheAttributesWithAccessKeys