New-AzRedisEnterpriseCache
Crea una caché de Redis Enterprise.
Sintaxis
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>]
[-AccessKeysAuthentication <AccessKeysAuthentication>]
[-CustomerManagedKeyEncryptionKeyUrl <String>]
[-HighAvailability <HighAvailability>]
[-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>]
[-HighAvailability <HighAvailability>]
[-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.
Tipo: | AccessKeysAuthentication |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | 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.
Tipo: | SwitchParameter |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | 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
Tipo: | AofFrequency |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-AsJob
Ejecución del comando como trabajo
Tipo: | SwitchParameter |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | 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.
Tipo: | Int32 |
Alias: | SkuCapacity |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | 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
Tipo: | Protocol |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-ClusteringPolicy
Directiva de agrupación en clústeres: el valor predeterminado es OSSCluster especificado en tiempo de creación. Valores permitidos: EnterpriseCluster, OSSCluster
Tipo: | ClusteringPolicy |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-ClusterName
Nombre del clúster de Redis Enterprise.
Tipo: | String |
Alias: | Name |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Confirm
Le pide confirmación antes de ejecutar el cmdlet.
Tipo: | SwitchParameter |
Alias: | cf |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-CustomerManagedKeyEncryptionKeyUrl
La clave de cifrado de claves solo tiene versiones. Por ejemplo: https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78"
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-DefaultProfile
Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.
Tipo: | PSObject |
Alias: | AzureRMContext, AzureCredential |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-EvictionPolicy
Directiva de expulsión de Redis: el valor predeterminado es VolatileLRU Valores permitidos: AllKeysLFU, AllKeysLRU, AllKeysRandom, VolatileLRU, VolatileLFU, VolatileTTL, VolatileRandom, NoEviction
Tipo: | EvictionPolicy |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-GroupNickname
Nombre del grupo de recursos de base de datos vinculados
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | 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.
Tipo: | HighAvailability |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-IdentityType
Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned).
Tipo: | ManagedServiceIdentityType |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | 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.
Tipo: | Hashtable |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-KeyEncryptionKeyIdentityType
Solo se admite userAssignedIdentity en esta versión de API; Es posible que se admita otros tipos en el futuro.
Tipo: | CmkIdentityType |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | 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/<grupo de recursos>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | 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.
Tipo: | ILinkedDatabase[] |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Location
Ubicación geográfica donde reside el recurso.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | 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
Tipo: | TlsVersion |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | 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.
Tipo: | IModule[] |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | 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.
Tipo: | SwitchParameter |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-NoWait
Ejecutar el comando de forma asincrónica
Tipo: | SwitchParameter |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | 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.
Tipo: | Int32 |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | 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.
Tipo: | SwitchParameter |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | 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
Tipo: | RdbFrequency |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-ResourceGroupName
Nombre del grupo de recursos. El nombre no distingue mayúsculas de minúsculas.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | 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
Tipo: | SkuName |
Alias: | SkuName |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-SubscriptionId
Identificador de la suscripción de destino.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | (Get-AzContext).Subscription.Id |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Tag
Etiquetas de recursos de clúster.
Tipo: | Hashtable |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-WhatIf
Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.
Tipo: | SwitchParameter |
Alias: | wi |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Zone
Availability Zones donde se implementará este clúster.
Tipo: | String[] |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |