Partager via


New-AzRedisEnterpriseCache

Crée un cache Redis Enterprise.

Syntaxe

CreateClusterWithDatabase (Par défaut)

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

CreateClusterOnly

New-AzRedisEnterpriseCache
    -ClusterName <String>
    -ResourceGroupName <String>
    -Location <String>
    -Sku <SkuName>
    [-SubscriptionId <String>]
    [-Capacity <Int32>]
    [-MinimumTlsVersion <TlsVersion>]
    [-Zone <String[]>]
    [-Tag <Hashtable>]
    [-CustomerManagedKeyEncryptionKeyUrl <String>]
    [-HighAvailability <HighAvailability>]
    [-PublicNetworkAccess <PublicNetworkAccess>]
    [-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

-AccessKeysAuthentication

Cette propriété peut être activée/désactivée pour autoriser ou refuser l’accès avec les clés d’accès actuelles. Peut être mis à jour même après la création de la base de données.

Propriétés du paramètre

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

Jeux de paramètres

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

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

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

Jeux de paramètres

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

Propriétés du paramètre

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

Jeux de paramètres

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

-AsJob

Exécuter la commande en tant que travail

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

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

-Capacity

Taille du cluster RedisEnterprise. La valeur par défaut est 2 ou 3 ou non applicable en fonction de la référence SKU. Les valeurs valides sont (2, 4, 6, ...) pour les références SKU Enterprise_* et (3, 9, 15, ...) pour les références SKU EnterpriseFlash_*. Pour les autres références SKU, l’argument de capacité n’est pas pris en charge.

Propriétés du paramètre

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

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

-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

Propriétés du paramètre

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

Jeux de paramètres

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

Propriétés du paramètre

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

Jeux de paramètres

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

-ClusterName

Nom du cluster Redis Enterprise.

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
Alias:Nom

Jeux de paramètres

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

-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

-CustomerManagedKeyEncryptionKeyUrl

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

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é: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:PSObject
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias: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

-EvictionPolicy

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

Propriétés du paramètre

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

Jeux de paramètres

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

-GroupNickname

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

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

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

-HighAvailability

Option activée par défaut. Ne peut être mis à jour qu’à partir de désactivé pour activé. Si highAvailability est désactivé, le jeu de données n’est pas répliqué. Cela affecte le contrat SLA de disponibilité et augmente le risque de perte de données.

Propriétés du paramètre

Type:HighAvailability
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é:False
Valeur des arguments restants:False

-IdentityType

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

Propriétés du paramètre

Type:ManagedServiceIdentityType
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é:False
Valeur des arguments restants: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.

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é:False
Valeur des arguments restants:False

-KeyEncryptionKeyIdentityType

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

Propriétés du paramètre

Type:CmkIdentityType
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é:False
Valeur des arguments restants: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.

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é:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:

ILinkedDatabase[]

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

Jeux de paramètres

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

-Location

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

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é:False
Valeur des arguments restants: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

Propriétés du paramètre

Type:TlsVersion
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é:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:

IModule[]

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

Jeux de paramètres

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

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

Jeux de paramètres

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

-NoWait

Exécuter la commande de manière asynchrone

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

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

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

Propriétés du paramètre

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

Jeux de paramètres

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

-PublicNetworkAccess

Si le trafic du réseau public peut ou non accéder au cluster Redis. Seuls les paramètres « Activé » ou « Désactivé » peuvent être définis.

Propriétés du paramètre

Type:PublicNetworkAccess
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é:False
Valeur des arguments restants: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.

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

Jeux de paramètres

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

-RdbPersistenceFrequency

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

Propriétés du paramètre

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

Jeux de paramètres

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

-ResourceGroupName

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

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é:False
Valeur des arguments restants:False

-Sku

Type de cluster RedisEnterprise à déployer. Valeurs acceptées : Balanced_B0, Balanced_B1, Balanced_B10, Balanced_B100, Balanced_B1000, Balanced_B150, Balanced_B20, Balanced_B250, Balanced_B3, Balanced_B350, Balanced_B5, Balanced_B50, Balanced_B500, Balanced_B700, ComputeOptimized_X10, ComputeOptimized_X100, ComputeOptimized_X150, ComputeOptimized_X20, ComputeOptimized_X250, ComputeOptimized_X3, ComputeOptimized_X350, ComputeOptimized_X5, ComputeOptimized_X50, ComputeOptimized_X500, ComputeOptimized_X700, EnterpriseFlash_F1500, EnterpriseFlash_F300, EnterpriseFlash_F700, Enterprise_E1, Enterprise_E10, Enterprise_E100, Enterprise_E20, Enterprise_E200, Enterprise_E400, Enterprise_E5, Enterprise_E50, FlashOptimized_A1000, FlashOptimized_A1500, FlashOptimized_A2000, FlashOptimized_A250, FlashOptimized_A4500, FlashOptimized_A500, FlashOptimized_A700, MemoryOptimized_M10, MemoryOptimized_M100, MemoryOptimized_M1000, MemoryOptimized_M150, MemoryOptimized_M1500, MemoryOptimized_ M20, MemoryOptimized_M2000, MemoryOptimized_M250, MemoryOptimized_M350, MemoryOptimized_M50, MemoryOptimized_M500, MemoryOptimized_M700

Propriétés du paramètre

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

Jeux de paramètres

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

-SubscriptionId

ID de l’abonnement cible.

Propriétés du paramètre

Type:String
Valeur par défaut:(Get-AzContext).Subscription.Id
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é:False
Valeur des arguments restants:False

-Tag

Balises de ressource de cluster.

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é:False
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

-Zone

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

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é:False
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.

Sorties

ICluster