Set-AzRedisCache

Référence

Module:: Az.RedisCache

Modifie une Azure Cache pour 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

L’applet de commande Set-AzRedisCache modifie une Azure Cache pour Redis.

Exemples

Exemple 1 : Modifier Azure Cache pour 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               : []

Cette commande met à jour la stratégie maxmemory-policy pour votre cache Azure fo Redis nommé MyCache.

Exemple 2 : Modifiez Azure Cache pour Redis : si vous souhaitez désactiver la persistance des données RDB ou 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               : []

Cette applet de commande désactive la persistance des données de sauvegarde RDB pour Azure Cache pour Redis. Vous pouvez également désactiver le cache persistant de sauvegarde AOF.

Exemple 3 : Modifiez Azure Cache pour Redis : si vous souhaitez ajouter la persistance des données après la création du cache Redis Azure.

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

Cette applet de commande active la persistance rdb-backup sur un cache déjà existant. Vous pouvez également activer la persistance aof-backup.

Exemple 4 : Modifier Azure Cache pour Redis - Si vous souhaitez modifier la fréquence de sauvegarde rdb.

Par exemple : actuellement, vous prenez une capture instantanée RDB toutes les 30 minutes, mais vous souhaitez changer pour prendre un instantané de 15 minutes.

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

Exemple 5 : Modifiez Azure Cache pour Redis : si vous souhaitez modifier la persistance des données de sauvegarde AOF en sauvegarde 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               : []

Cette applet de commande permet de modifier la méthode de persistance.

Exemple 6 : Mettre à l’échelle une instance Azure Cache pour Redis - Mise à jour vers une taille différente.

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

Cette commande augmente ou diminue la taille de mémoire de votre instance.

Exemple 7 : Mettre à l’échelle une instance Azure Cache pour Redis - Mettre à jour vers un niveau différent.

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

Cette commande vous aide à modifier le niveau de votre cache. Vous pouvez passer de De Base à Standard ou Standard à Premium.

Exemple 8 : Mettre à l’échelle une instance Azure Cache pour Redis - Activer le clustering 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               : []

Cette applet de commande vous aide à activer le clustering pour votre instance de Azure Cache pour Redis. Pour augmenter le nombre de partitions, vous devez d’abord activer le clustering.

Exemple 9 : Mettre à l’échelle une instance Azure Cache pour Redis - Utilisez le cluster Redis pour effectuer un scale-in/out.

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

Cette commande augmente ou diminue la taille du cluster.

Paramètres

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:	SwitchParameter
Alias:	cf
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Type:	IAzureContextContainer
Alias:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-DisableAccessKeyAuthentication

Facultatif : l’authentification auprès de Redis par le biais de clés d’accès est désactivée lorsqu’elle est définie sur true. La valeur par défaut est False.

Type:	String
Position:	Named
Valeur par défaut:	false
Obligatoire:	False
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-EnableNonSslPort

Indique si le port non SSL est activé. La valeur par défaut est $False (le port non SSL est désactivé).

Type:	Nullable<T>[Boolean]
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-IdentityType

Spécifie le type d’identité utilisé pour l’Azure Cache pour Redis. Valeurs valides : « SystemAssigned » ou « UserAssigned » ou « SystemAssignedUserAssigned » ou « None »

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-MinimumTlsVersion

Spécifiez la version TLS requise par les clients pour se connecter au cache.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-Name

Spécifie le nom de la Azure Cache pour Redis à mettre à jour.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-RedisConfiguration

Spécifie les paramètres de configuration de Redis. Les valeurs valides pour ce paramètre sont :

rdb-backup-enabled. Spécifie que la persistance des données Redis est activée. Niveau Premium uniquement.
rdb-storage-connection-string. Spécifie le chaîne de connexion au compte de stockage pour la persistance des données Redis. Niveau Premium uniquement.
rdb-backup-frequency. Spécifie la fréquence de sauvegarde pour la persistance des données Redis. Niveau Premium uniquement.
maxmemory-reserved. Configure la mémoire réservée pour les processus non-cache. Niveaux Standard et Premium.
maxmemory-policy. Configure la stratégie d’éviction pour le cache. Tous les niveaux tarifaires.
notify-keyspace-events. Configure les notifications d’espace de clés. Niveaux Standard et Premium.
hash-max-ziplist-entries. Configure l’optimisation de la mémoire pour les petits types de données d’agrégation. Niveaux Standard et Premium.
hash-max-ziplist-value. Configure l’optimisation de la mémoire pour les petits types de données d’agrégation. Niveaux Standard et Premium.
set-max-intset-entries. Configure l’optimisation de la mémoire pour les petits types de données d’agrégation. Niveaux Standard et Premium.
zset-max-ziplist-entries. Configure l’optimisation de la mémoire pour les petits types de données d’agrégation. Niveaux Standard et Premium.
zset-max-ziplist-value. Configure l’optimisation de la mémoire pour les petits types de données d’agrégation. Niveaux Standard et Premium.
. Configure le nombre de bases de données. Cette propriété ne peut être configurée qu’au moment de la création du cache. Niveaux Standard et Premium. Pour plus d’informations, consultez Gérer le cache Redis Azure avec Azure PowerShellhttp://go.microsoft.com/fwlink/?LinkId=800051 (http://go.microsoft.com/fwlink/?LinkId=800051).
méthode d’authentification préférée-data-archive-auth-method Preferred pour communiquer avec le compte de stockage utilisé pour l’archivage des données, spécifier SAS ou ManagedIdentity, la valeur par défaut est SAS
méthode d’authentification préférée-auth-method Preferred pour communiquer avec le compte de stockage utilisé pour la persistance des données, spécifier SAS ou ManagedIdentity, la valeur par défaut est SAS

Type:	Hashtable
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-RedisVersion

Version de Redis. Il doit s’agir de la forme « major[.minor] » (seul « major » est requis) ou de la valeur « latest » qui fait référence à la dernière version stable de Redis disponible. Versions prises en charge : 4.0, 6.0 (dernière version). La valeur par défaut est « latest ».

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-ResourceGroupName

Spécifie le nom du groupe de ressources qui contient le cache Redis.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-ShardCount

Spécifie le nombre de partitions à créer sur un cache de cluster Premium.

Type:	Nullable<T>[Int32]
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-Size

Spécifie la taille du cache Redis. Les valeurs valides sont :

P1
P2
P3
P4
P5
C0
C1
C2
C3
C4
C5
C6
250 Mo
1 Go
2,5 Go
6 Go
13 Go
26 Go
53 Go
120 Go La valeur par défaut est 1 Go ou C1.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-Sku

Spécifie la référence SKU du cache Redis à créer. Les valeurs valides sont :

De base
Standard
Premium La valeur par défaut est Standard.

Type:	String
Valeurs acceptées:	Basic, Standard, Premium
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-Tag

Table de hachage qui représente les balises.

Type:	Hashtable
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-TenantSettings

Ce paramètre a été déconseillé.

Type:	Hashtable
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-UpdateChannel

Facultatif : spécifie le canal de mise à jour pour les mises à jour mensuelles de Redis que votre cache Redis recevra. Les caches utilisant le canal de mise à jour « Préversion » obtiennent les dernières mises à jour Redis au moins 4 semaines à l’avance sur les caches de canal « Stable ». La valeur par défaut est « Stable ». Les valeurs possibles sont les suivantes : « Stable », « Preview »

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-UserAssignedIdentity

Spécifie une ou plusieurs identités utilisateur séparées par des virgules à associer au Azure Cache pour Redis. Les références d’identité utilisateur seront des ID de ressource ARM sous la forme : « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identityes/{identityName} »

Type:	String[]
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:	SwitchParameter
Alias:	wi
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

Entrées

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

Sorties

RedisCacheAttributesWithAccessKeys

Partager via

Set-AzRedisCache

Syntaxe

Description

Exemples

Exemple 1 : Modifier Azure Cache pour Redis

Exemple 2 : Modifiez Azure Cache pour Redis : si vous souhaitez désactiver la persistance des données RDB ou AOF.

Exemple 3 : Modifiez Azure Cache pour Redis : si vous souhaitez ajouter la persistance des données après la création du cache Redis Azure.

Exemple 4 : Modifier Azure Cache pour Redis - Si vous souhaitez modifier la fréquence de sauvegarde rdb.

Exemple 5 : Modifiez Azure Cache pour Redis : si vous souhaitez modifier la persistance des données de sauvegarde AOF en sauvegarde RDB.

Exemple 6 : Mettre à l’échelle une instance Azure Cache pour Redis - Mise à jour vers une taille différente.

Exemple 7 : Mettre à l’échelle une instance Azure Cache pour Redis - Mettre à jour vers un niveau différent.

Exemple 8 : Mettre à l’échelle une instance Azure Cache pour Redis - Activer le clustering Redis.

Exemple 9 : Mettre à l’échelle une instance Azure Cache pour Redis - Utilisez le cluster Redis pour effectuer un scale-in/out.

Paramètres

-Confirm

-DefaultProfile

-DisableAccessKeyAuthentication

-EnableNonSslPort

-IdentityType

-MinimumTlsVersion

-Name

-RedisConfiguration

-RedisVersion

-ResourceGroupName

-ShardCount

-Size

-Sku

-Tag

-TenantSettings

-UpdateChannel

-UserAssignedIdentity

-WhatIf

Entrées

Sorties

Ressources supplémentaires

Partager via

Set-AzRedisCache

Syntaxe

Description

Exemples

Exemple 1 : Modifier Azure Cache pour Redis

Exemple 2 : Modifiez Azure Cache pour Redis : si vous souhaitez désactiver la persistance des données RDB ou AOF.

Exemple 3 : Modifiez Azure Cache pour Redis : si vous souhaitez ajouter la persistance des données après la création du cache Redis Azure.

Exemple 4 : Modifier Azure Cache pour Redis - Si vous souhaitez modifier la fréquence de sauvegarde rdb.

Exemple 5 : Modifiez Azure Cache pour Redis : si vous souhaitez modifier la persistance des données de sauvegarde AOF en sauvegarde RDB.

Exemple 6 : Mettre à l’échelle une instance Azure Cache pour Redis - Mise à jour vers une taille différente.

Exemple 7 : Mettre à l’échelle une instance Azure Cache pour Redis - Mettre à jour vers un niveau différent.

Exemple 8 : Mettre à l’échelle une instance Azure Cache pour Redis - Activer le clustering Redis.

Exemple 9 : Mettre à l’échelle une instance Azure Cache pour Redis - Utilisez le cluster Redis pour effectuer un scale-in/out.

Paramètres

-Confirm

-DefaultProfile

-DisableAccessKeyAuthentication

-EnableNonSslPort

-IdentityType

-MinimumTlsVersion

-Name

-RedisConfiguration

-RedisVersion

-ResourceGroupName

-ShardCount

-Size

-Sku

-Tag

-TenantSettings

-UpdateChannel

-UserAssignedIdentity

-WhatIf

Entrées

Sorties

Liens associés

Ressources supplémentaires