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>]
   [-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 voor Redis met de naam MyCache bijgewerkt.

Voorbeeld 2: wijzig Azure Cache voor Redis - 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: wijzig Azure Cache voor Redis: als u gegevenspersistentie wilt toevoegen nadat de 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: wijzig Azure Cache voor Redis - Als u de 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: wijzig Azure Cache voor Redis: als u een back-up van AOF-gegevenspersistentie wilt wijzigen in 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 Azure Cache voor Redis-exemplaar 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 Azure Cache voor Redis exemplaar 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 Azure Cache voor Redis-exemplaar 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               : []

Met deze cmdlet kunt u clustering inschakelen voor uw Azure Cache voor Redis-exemplaar. Als u het aantal shards wilt verhogen, moet u eerst clustering inschakelen.

Voorbeeld 9: Een Azure Cache voor Redis-exemplaar 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

Hiermee wordt u 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 false.

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 dat wordt gebruikt voor de 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 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 aanvaardbare 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 aan het opslagaccount voor Redis-gegevenspersistentie. 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
  • B5
  • 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:

  • Basic
  • 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 aan de Azure Cache voor Redis moeten worden gekoppeld. 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

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
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