New-AzRedisEnterpriseCache

Referencia

Módulo:: Az.RedisEnterpriseCache

Crea una caché de Redis Enterprise.

Syntax

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

New-AzRedisEnterpriseCache
   -ClusterName <String>
   -ResourceGroupName <String>
   -Location <String>
   -Sku <SkuName>
   -NoDatabase
   [-SubscriptionId <String>]
   [-Capacity <Int32>]
   [-CustomerManagedKeyEncryptionKeyUrl <String>]
   [-IdentityType <ManagedServiceIdentityType>]
   [-IdentityUserAssignedIdentity <Hashtable>]
   [-KeyEncryptionKeyIdentityType <CmkIdentityType>]
   [-KeyEncryptionKeyIdentityUserAssignedIdentityResourceId <String>]
   [-MinimumTlsVersion <TlsVersion>]
   [-Tag <Hashtable>]
   [-Zone <String[]>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-Confirm]
   [-WhatIf]
   [<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

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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

Type:	AofFrequency
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AsJob

Ejecución del comando como trabajo

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Capacity

Tamaño del clúster de Redis Enterprise: el valor predeterminado es 2 o 3, según la SKU. Los valores permitidos son (2, 4, 6, ...) para las SKU empresariales y (3, 9, 15, ...) para las SKU flash.

Type:	Int32
Aliases:	SkuCapacity
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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

Type:	Protocol
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ClusteringPolicy

Directiva de agrupación en clústeres: el valor predeterminado es OSSCluster especificado en tiempo de creación. Valores permitidos: EnterpriseCluster, OSSCluster

Type:	ClusteringPolicy
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ClusterName

Nombre del clúster de Redis Enterprise.

Type:	String
Aliases:	Name
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CustomerManagedKeyEncryptionKeyUrl

La clave de cifrado de claves solo tiene versiones. Por ejemplo: https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78"

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.

Type:	PSObject
Aliases:	AzureRMContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EvictionPolicy

Directiva de expulsión de Redis: el valor predeterminado es VolatileLRU Valores permitidos: AllKeysLFU, AllKeysLRU, AllKeysRandom, VolatileLRU, VolatileLFU, VolatileTTL, VolatileRandom, NoEviction

Type:	EvictionPolicy
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-GroupNickname

Nombre del grupo de recursos de base de datos vinculados

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IdentityType

Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned).

Type:	ManagedServiceIdentityType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-KeyEncryptionKeyIdentityType

Solo se admite userAssignedIdentity en esta versión de API; Es posible que se admita otros tipos en el futuro.

Type:	CmkIdentityType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	ILinkedDatabase[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Location

Ubicación geográfica donde reside el recurso.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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

Type:	TlsVersion
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	IModule[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-NoWait

Ejecutar el comando de forma asincrónica

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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

Type:	RdbFrequency
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Sku

El tipo de clúster de Redis Enterprise que se va a implementar. Valores permitidos: Enterprise_E10, Enterprise_E20, Enterprise_E50, Enterprise_E100, EnterpriseFlash_F300, EnterpriseFlash_F700, EnterpriseFlash_F1500

Type:	SkuName
Aliases:	SkuName
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-SubscriptionId

Identificador de la suscripción de destino.

Type:	String
Position:	Named
Default value:	(Get-AzContext).Subscription.Id
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Tag

Etiquetas de recursos de clúster.

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Zone

Availability Zones donde se implementará este clúster.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Salidas

ICluster

Notas

ALIAS

PROPIEDADES DE PARÁMETRO COMPLEJAS

Para crear los parámetros descritos a continuación, cree una tabla hash que contenga las propiedades adecuadas. Para obtener información sobre las tablas hash, ejecute Get-Help about_Hash_Tables.

LINKEDDATABASE <ILinkedDatabase[]>: 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.

[Id <String>]: identificador de recurso de un recurso de base de datos que se va a vincular con esta base de datos.

MODULE <IModule[]>: 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.

Name <String>: el nombre del módulo, por ejemplo, "RedisBloom", "RediSearch", "RedisTimeSeries"
[Arg <String>]: opciones de configuración para el módulo, por ejemplo, "ERROR_RATE 0,01 INITIAL_SIZE 400".