New-AzRedisCache

Référence

Module:: Az.RedisCache

Crée un cache Redis.

Syntaxe

New-AzRedisCache
   -ResourceGroupName <String>
   -Name <String>
   -Location <String>
   [-Size <String>]
   [-Sku <String>]
   [-RedisConfiguration <Hashtable>]
   [-EnableNonSslPort <Boolean>]
   [-TenantSettings <Hashtable>]
   [-ShardCount <Int32>]
   [-MinimumTlsVersion <String>]
   [-DisableAccessKeyAuthentication <Boolean>]
   [-SubnetId <String>]
   [-StaticIP <String>]
   [-Tag <Hashtable>]
   [-Zone <String[]>]
   [-RedisVersion <String>]
   [-UpdateChannel <String>]
   [-ZonalAllocationPolicy <String>]
   [-IdentityType <String>]
   [-UserAssignedIdentity <String[]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

La cmdlet New-AzRedisCache crée un cache Redis Azure.

Exemples

Exemple 1 : Créer un cache Redis

New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "North Central US"

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 : {}
          EnableNonSslPort   : False
          RedisVersion       : 2.8
          Size               : 1GB
          Sku                : Standard
          Tag                : {}
          Zone               : []

Cette commande crée un cache Redis.

Exemple 2 : Créer un cache Redis de référence SKU Standard

New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "North Central US" -Size 250MB -Sku "Standard" -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 applet de commande crée un cache à l’aide du cache Azure pour Redis.

Exemple 3 : Créer un cache redondant interzone

New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "Central US" -Size P1 -Sku "Premium" -Zone @("1","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  : creating
          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               : {1, 2}

Cette commande crée une instance de cache Azure pour Redis dans des zones mutliple.

Exemple 4 : Créer un réseau virtuel activer le cache

Configuration requise pour la création d’un réseau virtuel activer le cache.

Créez le réseau virtuel dans le même groupe de ressources dans lequel vous souhaitez créer votre cache Redis. Vous pouvez créer un réseau virtuel à partir de commande PowerShell New-AzVirtualNetwork.
Vous aurez besoin de SubnetID pour le cache d’activation du réseau virtuel. La syntaxe de SubnetID est indiquée ci-dessous.

Format de SubnetID : /subscriptions/{subid}/resourceGroups/{resourceGroupName}/providers/Microsoft.ClassicNetwork/VirtualNetworks/{vnetName}/subnets/{subnetName}

New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "Central US" -Size P1 -Sku "Premium" -SubnetId "/subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Network/virtualNetworks/MyNet/subnets/MySubnet"

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  : creating
          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
          SubnetId           : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Network/virtualNetworks/MyNet/subnets/MySubnet
          StaticIP           : 10.0.0.4
          Tag                : {}
          Zone               : []

Exemple 5 : Configurer la persistance des données pour un Cache Azure Premium pour Redis

La persistance écrit les données Redis dans un compte de stockage Azure que vous possédez et gérez. Avant de configurer la persistance des données, vous devez avoir compte de stockage dans le même groupe de ressources. Choisissez un compte de stockage dans la même région et l’abonnement que le cache, et un compte de stockage Premium est recommandé, car le stockage Premium a un débit plus élevé.

Après avoir créé un compte de stockage, obtenez la chaîne de connexion du compte de stockage à l’aide de cette procédure.

Exécutez cette commande Get-AzStorageAccountKey -ResourceGroupName $resourceGroupName -Name $storageAccountName dans PowerShell.
À partir de la sortie ci-dessus, copiez n’importe quelle clé.
Placez la clé du compte de stockage et le nom du compte de stockage au format ci-dessous pour obtenir la chaîne de connexion de votre compte de stockage.

Format de chaîne de connexion :- "DefaultEndpointsProtocol=https ; AccountName={storageAccountName} ; AccountKey={storageAccountKey} ; EndpointSuffix=mySuffix"

Vous devez avoir les paramètres de configuration Redis spécifiques pour activer la persistance des données.

Pour la sauvegarde RDB, activez

rdb-backup-enabled (Définir true ou false)
rdb-storage-connection-string (Donnez une chaîne de connexion au format ci-dessus.)
rdb-backup-frequency (Définissez un intervalle de sauvegarde en minutes. Vous ne pouvez choisir parmi - 15, 30, 60, 360, 720 et 1440 minutes.)

New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "Central US" -Size P1 -Sku "Premium" -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  : creating
          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 6 : Configurer la persistance des données pour un Cache Azure Premium pour Redis - Sauvegarde AOF activée

Pour la sauvegarde AOF activée.

aof-backup-enabled (Définir true ou false),
aof-storage-connection-string-0 (Donnez une chaîne de connexion au format ci-dessus.)
aof-storage-connection-string-1 (vous pouvez éventuellement configurer un autre compte de stockage. Si un deuxième compte de stockage est configuré, les écritures dans le cache du réplica sont écrites dans ce deuxième compte de stockage.)

New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "Central US" -Size P1 -Sku "Premium" -RedisConfiguration @{"aof-backup-enabled" = "true"; "aof-storage-connection-string-0" = "DefaultEndpointsProtocol=https;AccountName=mystorageaccount;AccountKey=******;EndpointSuffix=mySuffix"}

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  : creating
          SslPort            : 6380
          RedisConfiguration : {[maxmemory-policy, allkeys-random], [maxclients, 7500], [maxmemory-reserved, 200],
                                [maxfragmentationmemory-reserved, 300], [aof-backup-enabled, true]...}
          EnableNonSslPort   : False
          RedisVersion       : 4.0.14
          Size               : 6GB
          Sku                : Premium
          Tag                : {}
          Zone               : []

Paramètres

-Confirm

Vous invite à confirmer 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 le Cache Azure 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

-Location

Spécifie l’emplacement dans lequel créer un cache Redis. Les valeurs valides sont les suivantes :

USA Centre Nord
USA Centre Sud
USA Centre
Europe Ouest
Europe Nord
USA Ouest
USA Est
USA Est 2
Japon Est
Japon Ouest
Brésil Sud
Asie du Sud-Est
Asie de l’Est
Australie Est
Australie Sud-Est

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

-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 du cache Redis à créer.

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 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 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 dans lequel créer le cache Redis.

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

-ShardCount

Spécifie le nombre de partitions à créer sur un cache de cluster Premium. Les valeurs acceptables pour ce paramètre sont les suivantes :

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 les suivantes :

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 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 les suivantes :

Basique
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

-StaticIP

Spécifie une adresse IP unique dans le sous-réseau du cache Redis. Si vous ne spécifiez pas de valeur pour ce paramètre, cette applet de commande choisit une adresse IP à partir du sous-réseau.

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

-SubnetId

ID de ressource complet d’un sous-réseau dans un réseau virtuel dans lequel déployer le Cache Azure pour Redis. Exemple de format : /subscriptions/{subid}/resourceGroups/{resourceGroupName}/Microsoft. {Network|ClassicNetwork}/VirtualNetworks/{vnetName}/subnets/{subnetName}

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

-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:	Stable
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 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} »

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

Affiche ce qui se passerait si l’applet de commande s’exécute. 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

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

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

-Zone

Liste des régions Azure avec zones de disponibilité.

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

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

String[]

Sorties

RedisCacheAttributesWithAccessKeys

Partager via

New-AzRedisCache

Syntaxe

Description

Exemples

Exemple 1 : Créer un cache Redis

Exemple 2 : Créer un cache Redis de référence SKU Standard

Exemple 3 : Créer un cache redondant interzone

Exemple 4 : Créer un réseau virtuel activer le cache

Exemple 5 : Configurer la persistance des données pour un Cache Azure Premium pour Redis

Exemple 6 : Configurer la persistance des données pour un Cache Azure Premium pour Redis - Sauvegarde AOF activée

Paramètres

-Confirm

-DefaultProfile

-DisableAccessKeyAuthentication

-EnableNonSslPort

-IdentityType

-Location

-MinimumTlsVersion

-Name

-RedisConfiguration

-RedisVersion

-ResourceGroupName

-ShardCount

-Size

-Sku

-StaticIP

-SubnetId

-Tag

-TenantSettings

-UpdateChannel

-UserAssignedIdentity

-WhatIf

-ZonalAllocationPolicy

-Zone

Entrées

Sorties

Ressources supplémentaires

Partager via

New-AzRedisCache

Syntaxe

Description

Exemples

Exemple 1 : Créer un cache Redis

Exemple 2 : Créer un cache Redis de référence SKU Standard

Exemple 3 : Créer un cache redondant interzone

Exemple 4 : Créer un réseau virtuel activer le cache

Exemple 5 : Configurer la persistance des données pour un Cache Azure Premium pour Redis

Exemple 6 : Configurer la persistance des données pour un Cache Azure Premium pour Redis - Sauvegarde AOF activée

Paramètres

-Confirm

-DefaultProfile

-DisableAccessKeyAuthentication

-EnableNonSslPort

-IdentityType

-Location

-MinimumTlsVersion

-Name

-RedisConfiguration

-RedisVersion

-ResourceGroupName

-ShardCount

-Size

-Sku

-StaticIP

-SubnetId

-Tag

-TenantSettings

-UpdateChannel

-UserAssignedIdentity

-WhatIf

-ZonalAllocationPolicy

-Zone

Entrées

Sorties

Liens associés

Ressources supplémentaires