Partager via


Set-AzRedisCache

Modifie un cache Azure pour Redis.

Syntaxe

Default (Par défaut)

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

L’applet de commande Set-AzRedisCache modifie un cache Azure pour Redis.

Exemples

Exemple 1 : Modifier le cache Azure 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 : Modifier le cache Azure 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 : Modifier le cache Azure 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 le cache Azure 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 : Modifier le cache Azure 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 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 invite à confirmer avant d’exécuter l’applet de commande.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:cf

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DefaultProfile

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

Propriétés du paramètre

Type:IAzureContextContainer
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:String
Valeur par défaut:false
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-EnableNonSslPort

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

Propriétés du paramètre

Type:

Nullable<T>[Boolean]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-IdentityType

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-MinimumTlsVersion

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-Name

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-RedisConfiguration

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

  • rdb-backup-enabled. Spécifie que la persistance des données Redis est activée. Niveau Premium uniquement.
  • rdb-storage-connection-string. Spécifie la 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.
  • Bases. 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 PowerShell.
  • 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

Propriétés du paramètre

Type:Hashtable
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants: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 ».

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-ResourceGroupName

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-ShardCount

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

Propriétés du paramètre

Type:

Nullable<T>[Int32]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-Size

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

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-Sku

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

  • Élémentaire
  • Norme
  • Premium La valeur par défaut est Standard.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Valeurs acceptées:Basic, Standard, Premium
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-Tag

Table de hachage qui représente les balises.

Propriétés du paramètre

Type:Hashtable
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-TenantSettings

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

Propriétés du paramètre

Type:Hashtable
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants: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 »

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-UserAssignedIdentity

Spécifie une ou plusieurs identités utilisateur séparées par des virgules à associer au Cache Azure 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} »

Propriétés du paramètre

Type:

String[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Wi

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ZonalAllocationPolicy

Facultatif : Facultatif : spécifie la façon dont les zones de disponibilité sont allouées au cache Redis. « Automatique » active la redondance de zone et Azure sélectionne automatiquement les zones en fonction de la disponibilité et de la capacité régionales. « UserDefined » sélectionne les zones de disponibilité transmises par vous à l’aide du paramètre « zones ». 'NoZones' produit un cache non zonal. Si « zonalAllocationPolicy » n’est pas passé, il est défini sur « UserDefined » lorsque les zones sont passées ; sinon, elle est définie sur « Automatique » dans les régions où les zones sont prises en charge et « NoZones » dans les régions où les zones ne sont pas prises en charge.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

String

Hashtable

Nullable<T>

Nullable<T>

Sorties

RedisCacheAttributesWithAccessKeys