New-AzRedisCache
Crée un cache Redis.
Syntax
New-AzRedisCache
-ResourceGroupName <String>
-Name <String>
-Location <String>
[-Size <String>]
[-Sku <String>]
[-RedisConfiguration <Hashtable>]
[-EnableNonSslPort <Boolean>]
[-TenantSettings <Hashtable>]
[-ShardCount <Int32>]
[-MinimumTlsVersion <String>]
[-SubnetId <String>]
[-StaticIP <String>]
[-Tag <Hashtable>]
[-Zone <String[]>]
[-RedisVersion <String>]
[-UpdateChannel <String>]
[-IdentityType <String>]
[-UserAssignedIdentity <String[]>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
L’applet de commande 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 : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
SecondaryKey : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
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 : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
SecondaryKey : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
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 de Azure Cache 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 : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
SecondaryKey : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
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 créer 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 la 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 : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
SecondaryKey : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
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 Azure Cache pour Redis Premium
La persistance écrit des données Redis dans un compte Stockage Azure que vous possédez et gérez. Avant de configurer la persistance des données, vous devez disposer d’un compte de stockage dans le même groupe de ressources. Choisissez un compte de stockage situé dans la même région et le même abonnement que le cache. Un compte Stockage Premium est recommandé, car ce type de stockage offre un débit plus élevé.
Après avoir créé un compte de stockage, obtenez le compte de stockage chaîne de connexion à l’aide de cette procédure.
- Exécutez cette commande Get-Az Stockage AccountKey -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.
Connecter ion String Format :- « 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 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=pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=;EndpointSuffix=mySuffix"; "rdb-backup-frequency" = "30"}
PrimaryKey : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
SecondaryKey : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
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 Azure Cache pour Redis Premium - Sauvegarde AOF activée
Pour la sauvegarde AOF activée.
- aof-backup-enabled (Définir true ou false),
- aof-storage-connection-string-0 (Donnez 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=pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=;EndpointSuffix=mySuffix"}
PrimaryKey : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
SecondaryKey : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
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 demande une confirmation avant d’exécuter l’applet de commande.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DefaultProfile
Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.
| Type: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Location
Spécifie l’emplacement dans lequel créer un cache Redis. Les valeurs valides sont :
- Centre-Nord des États-Unis
- États-Unis - partie centrale méridionale
- USA Centre
- Europe Ouest
- Europe Nord
- USA Ouest
- USA Est
- USA Est 2
- Japon Est
- OuJapon Est
- Brésil Sud
- Asie Sud-Est
- Asie Est
- Australie Est
- Australie Sud-Est
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-MinimumTlsVersion
Spécifiez la version TLS requise par les clients pour se connecter au cache.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Spécifie le nom du cache Redis à créer.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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 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 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ResourceGroupName
Spécifie le nom du groupe de ressources dans lequel créer le cache Redis.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ShardCount
Spécifie le nombre de partitions à créer sur un cache de cluster Premium. Les valeurs valides pour ce paramètre sont :
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
| Type: | Nullable<T>[Int32] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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 La valeur par défaut est 1 Go ou C1.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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 |
| Accepted values: | Basic, Standard, Premium |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SubnetId
ID de ressource complet d’un sous-réseau dans un réseau virtuel dans lequel déployer le Azure Cache pour Redis. Exemple de format : /subscriptions/{subid}/resourceGroups/{resourceGroupName}/Microsoft. {Network|ClassicNetwork}/VirtualNetworks/{vnetName}/subnets/{subnetName}
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Tag
Table de hachage qui représente les balises.
| Type: | Hashtable |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-TenantSettings
Ce paramètre a été déconseillé.
| Type: | Hashtable |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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 |
| Default value: | Stable |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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 |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Zone
Liste des régions Azure avec zones de disponibilité.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Entrées
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
Liens associés
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour