New-AzRedisEnterpriseCache
Crea una caché de Redis Enterprise.
Sintaxis
CreateClusterWithDatabase (valor predeterminado)
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
Crea o actualiza un clúster de caché existente (sobrescribir o volver a crear, con posible tiempo de inactividad) con una base de datos asociada.
Ejemplos
Ejemplo 1: Creación de una caché de 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}
Este comando crea una caché de Redis Enterprise denominada MyCache con una base de datos asociada denominada default.
Ejemplo 2: Creación de una caché de Redis Enterprise con algunos parámetros opcionales
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}
Este comando crea una caché de Redis Enterprise denominada MyCache con una base de datos asociada denominada default, con algunos parámetros opcionales.
Ejemplo 3: Avanzado: Creación de un clúster de caché de Redis Enterprise sin una base de datos asociada
New-AzRedisEnterpriseCache -Name "MyCache" -ResourceGroupName "MyGroup" -Location "East US" -Sku "EnterpriseFlash_F300" -NoDatabase
Location Name Type Zone Database
-------- ---- ---- ---- --------
East US MyCache Microsoft.Cache/redisEnterprise {}
Advertencia: este comando crea un clúster de caché de Redis Enterprise denominado MyCache sin ninguna base de datos asociada para almacenar datos.
Ejemplo 4: Creación de una caché de Redis Enterprise con una base de datos georeplicada
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}
Este comando crea un nombre de caché MyCache con una base de datos georeplicada denominada default
Parámetros
-AccessKeysAuthentication
Esta propiedad puede estar habilitada o deshabilitada para permitir o denegar el acceso con las claves de acceso actuales.
Se puede actualizar incluso después de crear la base de datos.
Propiedades de parámetro
Conjuntos de parámetros
CreateClusterWithDatabase
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-AofPersistenceEnabled
[Versión preliminar] Establece si la persistencia de AOF está habilitada.
Después de habilitar la persistencia de AOF, no podrá deshabilitarla.
La compatibilidad con la deshabilitación de la persistencia de AOF después de habilitar se agregará en una fecha posterior.
Propiedades de parámetro
Tipo: SwitchParameter
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
CreateClusterWithDatabase
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-AofPersistenceFrequency
[Versión preliminar] Establece la frecuencia con la que se escriben los datos en el disco si está habilitada la persistencia de AOF.
Valores permitidos: 1s, siempre
Propiedades de parámetro
Tipo: AofFrequency
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
CreateClusterWithDatabase
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-AsJob
Ejecución del comando como trabajo
Propiedades de parámetro
Tipo: SwitchParameter
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-Capacity
Tamaño del clúster de RedisEnterprise.
El valor predeterminado es 2 o 3 o no es aplicable en función de la SKU. Los valores válidos son (2, 4, 6, ...) para las SKU de Enterprise_* y (3, 9, 15, ...) para EnterpriseFlash_* SKU.
Para otros argumentos de capacidad de SKU no se admite.
Propiedades de parámetro
Tipo: Int32
Valor predeterminado: None Admite caracteres comodín: False DontShow: False Alias: Capacidad de SKU
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-ClientProtocol
Especifica si los clientes de redis pueden conectarse mediante protocolos de redis cifrados por TLS o texto no cifrado; el valor predeterminado es Cifrado Valores permitidos: Encrypted, Plaintext
Propiedades de parámetro
Tipo: Protocol
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
CreateClusterWithDatabase
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-ClusteringPolicy
Directiva de agrupación en clústeres: el valor predeterminado es OSSCluster especificado en tiempo de creación.
Valores permitidos: EnterpriseCluster, OSSCluster
Propiedades de parámetro
Tipo: ClusteringPolicy
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
CreateClusterWithDatabase
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-ClusterName
Nombre del clúster de Redis Enterprise.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Admite caracteres comodín: False DontShow: False Alias: Nombre
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: True Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-Confirm
Le pide confirmación antes de ejecutar el cmdlet.
Propiedades de parámetro
Tipo: SwitchParameter
Valor predeterminado: None Admite caracteres comodín: False DontShow: False Alias: cf
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-CustomerManagedKeyEncryptionKeyUrl
La clave de cifrado de claves solo tiene versiones.
Ejemplo: https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78"
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-DefaultProfile
Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.
Propiedades de parámetro
Tipo: PSObject
Valor predeterminado: None Admite caracteres comodín: False DontShow: False Alias: AzureRMContext, AzureCredential
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-EvictionPolicy
Directiva de expulsión de Redis: el valor predeterminado es VolatileLRU Valores permitidos: AllKeysLFU, AllKeysLRU, AllKeysRandom, VolatileLRU, VolatileLFU, VolatileTTL, VolatileRandom, NoEviction
Propiedades de parámetro
Tipo: EvictionPolicy
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
CreateClusterWithDatabase
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-GroupNickname
Nombre del grupo de recursos de base de datos vinculados
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
CreateClusterWithDatabase
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-HighAvailability
Habilitado de forma predeterminada.
Solo se puede actualizar de deshabilitado a habilitado.
Si highAvailability está deshabilitado, el conjunto de datos no se replica.
Esto afecta al Acuerdo de Nivel de Servicio de disponibilidad y aumenta el riesgo de pérdida de datos.
Propiedades de parámetro
Tipo: HighAvailability
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-IdentityType
Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned).
Propiedades de parámetro
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-IdentityUserAssignedIdentity
Conjunto de identidades asignadas por el usuario asociadas al recurso.
Las claves de diccionario userAssignedIdentities serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}.
Los valores del diccionario pueden ser objetos vacíos ({}) en las solicitudes.
Propiedades de parámetro
Tipo: Hashtable
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-KeyEncryptionKeyIdentityType
Solo se admite userAssignedIdentity en esta versión de API; Es posible que se admita otros tipos en el futuro.
Propiedades de parámetro
Tipo: CmkIdentityType
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-KeyEncryptionKeyIdentityUserAssignedIdentityResourceId
Identidad asignada por el usuario que se usará para acceder a la dirección URL de la clave de cifrado de claves.
Por ejemplo: /subscriptions/<sub uuid>/resourceGroups/<resource group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-LinkedDatabase
Lista de recursos de base de datos para vincular con esta base de datos Para construir, vea la sección NOTES para las propiedades GEOREPLICATIONLINKEDDATABASE y crear una tabla hash.
Para construir, consulte la sección NOTES de las propiedades LINKEDDATABASE y cree una tabla hash.
Propiedades de parámetro
Tipo: ILinkedDatabase [ ]
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
CreateClusterWithDatabase
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-Location
Ubicación geográfica donde reside el recurso.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: True Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-MinimumTlsVersion
La versión mínima de TLS para que el clúster admita: el valor predeterminado es 1.2 Valores permitidos: 1.0, 1.1, 1.2
Propiedades de parámetro
Tipo: TlsVersion
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-Module
Conjunto opcional de módulos de redis que se habilitarán en esta base de datos: los módulos solo se pueden agregar en tiempo de creación.
Para construir, consulte la sección NOTES para propiedades de MODULE y crear una tabla hash.
Propiedades de parámetro
Tipo: IModule [ ]
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
CreateClusterWithDatabase
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-NoDatabase
Avanzado: no cree automáticamente una base de datos predeterminada.
Advertencia: La memoria caché no se podrá usar hasta que cree una base de datos.
Propiedades de parámetro
Tipo: SwitchParameter
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
CreateClusterOnly
Posición: Named Obligatorio: True Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-NoWait
Ejecutar el comando de forma asincrónica
Propiedades de parámetro
Tipo: SwitchParameter
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-Port
Puerto TCP del punto de conexión de base de datos: el valor predeterminado es un puerto disponible especificado en tiempo de creación.
Propiedades de parámetro
Tipo: Int32
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
CreateClusterWithDatabase
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-PublicNetworkAccess
Si el tráfico de red pública puede acceder o no al clúster de Redis.
Solo se puede configurar 'Habilitado' o 'Deshabilitado'.
Propiedades de parámetro
Tipo: PublicNetworkAccess
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-RdbPersistenceEnabled
[Versión preliminar] Establece si la persistencia de RDB está habilitada.
Después de habilitar la persistencia de RDB, no podrá deshabilitarla.
La compatibilidad con la deshabilitación de la persistencia de RDB después de habilitar se agregará en una fecha posterior.
Propiedades de parámetro
Tipo: SwitchParameter
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
CreateClusterWithDatabase
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-RdbPersistenceFrequency
[Versión preliminar] Establece la frecuencia con la que se crea una instantánea de la base de datos si está habilitada la persistencia de RDB.
Valores permitidos: 1h, 6h, 12h
Propiedades de parámetro
Tipo: RdbFrequency
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
CreateClusterWithDatabase
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-ResourceGroupName
Nombre del grupo de recursos.
El nombre distingue mayúsculas de minúsculas.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: True Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-Sku
Tipo de clúster de RedisEnterprise que se va a implementar.
Valores aceptados: 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
Propiedades de parámetro
Tipo: SkuName
Valor predeterminado: None Admite caracteres comodín: False DontShow: False Alias: SkuName
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: True Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-SubscriptionId
Identificador de la suscripción de destino.
Propiedades de parámetro
Tipo: String
Valor predeterminado: (Get-AzContext).Subscription.Id Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-Tag
Etiquetas de recursos de clúster.
Propiedades de parámetro
Tipo: Hashtable
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-WhatIf
Muestra lo que sucedería si el cmdlet se ejecuta.
El cmdlet no se ejecuta.
Propiedades de parámetro
Tipo: SwitchParameter
Valor predeterminado: None Admite caracteres comodín: False DontShow: False Alias: Wi
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-Zone
Availability Zones donde se implementará este clúster.
Propiedades de parámetro
Tipo: String [ ]
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters .
Salidas
