Partager via


New-AzRedisEnterpriseCache

Crée un cache Redis Enterprise.

Syntax

New-AzRedisEnterpriseCache
   -ClusterName <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Location <String>
   -Sku <SkuName>
   [-Capacity <Int32>]
   [-MinimumTlsVersion <TlsVersion>]
   [-Zone <String[]>]
   [-Tag <Hashtable>]
   [-Module <IModule[]>]
   [-ClientProtocol <Protocol>]
   [-Port <Int32>]
   [-EvictionPolicy <EvictionPolicy>]
   [-GroupNickname <String>]
   [-LinkedDatabase <ILinkedDatabase[]>]
   [-ClusteringPolicy <ClusteringPolicy>]
   [-CustomerManagedKeyEncryptionKeyUrl <String>]
   [-IdentityType <ManagedServiceIdentityType>]
   [-IdentityUserAssignedIdentity <Hashtable>]
   [-KeyEncryptionKeyIdentityType <CmkIdentityType>]
   [-KeyEncryptionKeyIdentityUserAssignedIdentityResourceId <String>]
   [-AofPersistenceEnabled]
   [-AofPersistenceFrequency <AofFrequency>]
   [-RdbPersistenceEnabled]
   [-RdbPersistenceFrequency <RdbFrequency>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzRedisEnterpriseCache
   -ClusterName <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Location <String>
   -Sku <SkuName>
   [-Capacity <Int32>]
   [-MinimumTlsVersion <TlsVersion>]
   [-Zone <String[]>]
   [-Tag <Hashtable>]
   [-CustomerManagedKeyEncryptionKeyUrl <String>]
   [-IdentityType <ManagedServiceIdentityType>]
   [-IdentityUserAssignedIdentity <Hashtable>]
   [-KeyEncryptionKeyIdentityType <CmkIdentityType>]
   [-KeyEncryptionKeyIdentityUserAssignedIdentityResourceId <String>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-NoDatabase]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Crée ou met à jour un cluster de cache existant (remplacer/recréer, avec un temps d’arrêt potentiel) avec une base de données associée.

Exemples

Exemple 1 : Créer un cache Redis Enterprise

New-AzRedisEnterpriseCache -Name "MyCache" -ResourceGroupName "MyGroup" -Location "West US" -Sku "Enterprise_E10"

Location Name    Type                            Zone Database
-------- ----    ----                            ---- --------
West US  MyCache Microsoft.Cache/redisEnterprise      {default}

Cette commande crée un cache Redis Enterprise nommé MyCache avec une base de données associée nommée par défaut.

Exemple 2 : Créer un cache Redis Enterprise à l’aide de paramètres facultatifs

New-AzRedisEnterpriseCache -Name "MyCache" -ResourceGroupName "MyGroup" -Location "East US" -Sku "Enterprise_E20" -Capacity 4 -MinimumTlsVersion "1.2" -Zone "1","2","3" -Tag @{"tag1" = "value1"} -Module "{name:RedisBloom, args:`"ERROR_RATE 0.00 INITIAL_SIZE 400`"}","{name:RedisTimeSeries, args:`"RETENTION_POLICY 20`"}","{name:RediSearch}" -ClientProtocol "Plaintext" -EvictionPolicy "NoEviction" -ClusteringPolicy "EnterpriseCluster" -AofPersistenceEnabled -AofPersistenceFrequency "1s"

Location Name    Type                            Zone      Database
-------- ----    ----                            ----      --------
East US  MyCache Microsoft.Cache/redisEnterprise {1, 2, 3} {default}

Cette commande crée un cache Redis Enterprise nommé MyCache avec une base de données associée nommée par défaut, à l’aide de certains paramètres facultatifs.

Exemple 3 : Avancé - Créer un cluster de cache Redis Enterprise sans base de données associée

New-AzRedisEnterpriseCache -Name "MyCache" -ResourceGroupName "MyGroup" -Location "East US" -Sku "EnterpriseFlash_F300" -NoDatabase

Location Name    Type                            Zone Database
-------- ----    ----                            ---- --------
East US  MyCache Microsoft.Cache/redisEnterprise      {}

Avertissement : cette commande crée un cluster de cache Redis Enterprise nommé MyCache sans aucune base de données associée pour contenir des données.

Exemple 4 : Créer un cache Redis Enterprise avec une base de données géoreplicée

New-AzRedisEnterpriseCache -Name "MyCache" -ResourceGroupName "MyGroup" -Location "West US" -Sku "Enterprise_E10" -ClientProtocol "Encrypted" -EvictionPolicy "NoEviction" -ClusteringPolicy "EnterpriseCluster" -GroupNickname "GroupNickname" -LinkedDatabase '{id:"/subscriptions/6b9ac7d2-7f6d-4de4-962c-43fda44bc3f2/resourceGroups/MyGroup/providers/Microsoft.Cache/redisEnterprise/MyCache/databases/default"}'

Location Name      Type                            Zone Database
-------- ----      ----                            ---- --------
West US  MyCache   Microsoft.Cache/redisEnterprise      {default}

Cette commande crée un nom de cache MyCache avec une base de données géoreplicée nommée par défaut

Paramètres

-AofPersistenceEnabled

[Préversion] Définit si la persistance AOF est activée. Après avoir activé la persistance AOF, vous ne pourrez pas la désactiver. Prise en charge de la désactivation de la persistance AOF après l’activation sera ajoutée à une date ultérieure.

Type:SwitchParameter
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:False
Accept wildcard characters:False

-AofPersistenceFrequency

[Préversion] Définit la fréquence à laquelle les données sont écrites sur le disque si la persistance AOF est activée. Valeurs autorisées : 1s, toujours

Type:AofFrequency
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:False
Accept wildcard characters:False

-AsJob

Exécuter la commande en tant que travail

Type:SwitchParameter
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:False
Accept wildcard characters:False

-Capacity

Taille du cluster Redis Enterprise : la valeur par défaut est 2 ou 3 en fonction de la référence SKU. Les valeurs autorisées sont (2, 4, 6, ...) pour les références SKU Entreprise et (3, 9, 15, ...) pour les références SKU Flash.

Type:Int32
Aliases:SkuCapacity
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:False
Accept wildcard characters:False

-ClientProtocol

Spécifie si les clients redis peuvent se connecter à l’aide de protocoles redis chiffrés ou en texte clair TLS . la valeur par défaut est Les valeurs autorisées chiffrées sont chiffrées, en texte clair

Type:Protocol
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:False
Accept wildcard characters:False

-ClusteringPolicy

Stratégie de clustering : la valeur par défaut est OSSCluster spécifiée au moment de la création. Valeurs autorisées : EnterpriseCluster, OSSCluster

Type:ClusteringPolicy
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:False
Accept wildcard characters:False

-ClusterName

Nom du cluster Redis Enterprise.

Type:String
Aliases:Name
Position:Named
valeur par défaut:None
Obligatoire:True
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:False
Accept wildcard characters:False

-CustomerManagedKeyEncryptionKeyUrl

URL de clé de chiffrement de clé versionnée uniquement. Ex : ; https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78"

Type:String
Position:Named
valeur par défaut:None
Obligatoire: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:PSObject
Aliases:AzureRMContext, AzureCredential
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:False
Accept wildcard characters:False

-EvictionPolicy

Stratégie d’éviction Redis : valeurs volatileLRU autorisées par défaut : AllKeysLFU, AllKeysLRU, AllKeysRandom, VolatileLRU, VolatileLFU, VolatileTTL, VolatileRandom, NoEviction

Type:EvictionPolicy
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:False
Accept wildcard characters:False

-GroupNickname

Nom du groupe de ressources de base de données liées

Type:String
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:False
Accept wildcard characters:False

-IdentityType

Type d’identité de service managé (où les types SystemAssigned et UserAssigned sont autorisés).

Type:ManagedServiceIdentityType
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:False
Accept wildcard characters:False

-IdentityUserAssignedIdentity

Ensemble d’identités affectées par l’utilisateur associées à la ressource. Les clés de dictionnaire userAssignedIdentities seront des ID de ressource ARM sous la forme : « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Les valeurs de dictionnaire peuvent être des objets vides ({}) dans les requêtes.

Type:Hashtable
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:False
Accept wildcard characters:False

-KeyEncryptionKeyIdentityType

Seul userAssignedIdentity est pris en charge dans cette version de l’API ; d’autres types peuvent être pris en charge à l’avenir

Type:CmkIdentityType
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:False
Accept wildcard characters:False

-KeyEncryptionKeyIdentityUserAssignedIdentityResourceId

Identité affectée par l’utilisateur à utiliser pour accéder à l’URL de clé de chiffrement de clé. Ex : /subscriptions/<sub uuid>/resourceGroups/<resource group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId.

Type:String
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:False
Accept wildcard characters:False

-LinkedDatabase

Liste des ressources de base de données à lier à cette base de données À construire, consultez la section NOTES pour les propriétés GEOREPLICATIONLINKEDDATABASE et créer une table de hachage. Pour construire, consultez la section NOTES pour les propriétés LINKEDDATABASE et créer une table de hachage.

Type:ILinkedDatabase[]
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:False
Accept wildcard characters:False

-Location

Emplacement géographique où réside la ressource.

Type:String
Position:Named
valeur par défaut:None
Obligatoire:True
Accept pipeline input:False
Accept wildcard characters:False

-MinimumTlsVersion

La version TLS minimale du cluster à prendre en charge : la valeur par défaut est 1.2 Valeurs autorisées : 1.0, 1.1, 1.2

Type:TlsVersion
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:False
Accept wildcard characters:False

-Module

Ensemble facultatif de modules redis à activer dans cette base de données : les modules ne peuvent être ajoutés qu’au moment de la création. Pour construire, consultez la section NOTES pour les propriétés module et créer une table de hachage.

Type:IModule[]
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:False
Accept wildcard characters:False

-NoDatabase

Avancé : ne créez pas automatiquement une base de données par défaut. Avertissement : le cache n’est pas utilisable tant que vous n’avez pas créé de base de données.

Type:SwitchParameter
Position:Named
valeur par défaut:None
Obligatoire:True
Accept pipeline input:False
Accept wildcard characters:False

-NoWait

Exécuter la commande de manière asynchrone

Type:SwitchParameter
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:False
Accept wildcard characters:False

-Port

Port TCP du point de terminaison de base de données : est défini par défaut sur un port disponible spécifié au moment de la création.

Type:Int32
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:False
Accept wildcard characters:False

-RdbPersistenceEnabled

[Préversion] Définit si la persistance RDB est activée. Après avoir activé la persistance RDB, vous ne pourrez pas le désactiver. Prise en charge de la désactivation de la persistance RDB après l’activation sera ajoutée à une date ultérieure.

Type:SwitchParameter
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:False
Accept wildcard characters:False

-RdbPersistenceFrequency

[Préversion] Définit la fréquence à laquelle une instantané de la base de données est créée si la persistance RDB est activée. Valeurs autorisées : 1h, 6h, 12h

Type:RdbFrequency
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

Nom du groupe de ressources. Le nom ne respecte pas la casse.

Type:String
Position:Named
valeur par défaut:None
Obligatoire:True
Accept pipeline input:False
Accept wildcard characters:False

-Sku

Type de cluster Redis Enterprise à déployer. Valeurs autorisées : Enterprise_E10, Enterprise_E20, Enterprise_E50, Enterprise_E100, EnterpriseFlash_F300, EnterpriseFlash_F700, EnterpriseFlash_F1500

Type:SkuName
Aliases:SkuName
Position:Named
valeur par défaut:None
Obligatoire:True
Accept pipeline input:False
Accept wildcard characters:False

-SubscriptionId

ID de l’abonnement cible.

Type:String
Position:Named
valeur par défaut:(Get-AzContext).Subscription.Id
Obligatoire:False
Accept pipeline input:False
Accept wildcard characters:False

-Tag

Balises de ressource de cluster.

Type:Hashtable
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:False
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
valeur par défaut:None
Obligatoire:False
Accept pipeline input:False
Accept wildcard characters:False

-Zone

Le Zones de disponibilité où ce cluster sera déployé.

Type:String[]
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:False
Accept wildcard characters:False

Sorties

ICluster