New-AzRedisCache

Referencia

Módulo:: Az.RedisCache

Crea una instancia de Redis Cache.

Sintaxis

New-AzRedisCache
   -ResourceGroupName <String>
   -Name <String>
   -Location <String>
   [-Size <String>]
   [-Sku <String>]
   [-RedisConfiguration <Hashtable>]
   [-EnableNonSslPort <Boolean>]
   [-TenantSettings <Hashtable>]
   [-ShardCount <Int32>]
   [-MinimumTlsVersion <String>]
   [-DisableAccessKeyAuthentication <Boolean>]
   [-SubnetId <String>]
   [-StaticIP <String>]
   [-Tag <Hashtable>]
   [-Zone <String[]>]
   [-RedisVersion <String>]
   [-UpdateChannel <String>]
   [-IdentityType <String>]
   [-UserAssignedIdentity <String[]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet New-AzRedisCache crea una instancia de Azure Redis Cache.

Ejemplos

Ejemplo 1: Creación de una instancia de Redis Cache

New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "North Central US"

PrimaryKey         : ******
          SecondaryKey       : ******
          ResourceGroupName  : MyGroup
          Id                 : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/mycache
          Location           : North Central US
          Name               : MyCache
          Type               : Microsoft.Cache/Redis
          HostName           : mycache.redis.cache.windows.net
          Port               : 6379
          ProvisioningState  : creating
          SslPort            : 6380
          RedisConfiguration : {}
          EnableNonSslPort   : False
          RedisVersion       : 2.8
          Size               : 1GB
          Sku                : Standard
          Tag                : {}
          Zone               : []

Este comando crea una instancia de Redis Cache.

Ejemplo 2: Creación de una SKU estándar en Redis Cache

New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "North Central US" -Size 250MB -Sku "Standard" -RedisConfiguration @{"maxmemory-policy" = "allkeys-random"}

PrimaryKey         : ******
          SecondaryKey       : ******
          ResourceGroupName  : MyGroup
          Id                 : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/MyCache
          Location           : North Central US
          Name               : mycache
          Type               : Microsoft.Cache/Redis
          HostName           : mycache.redis.cache.windows.net
          Port               : 6379
          ProvisioningState  : creating
          SslPort            : 6380
          RedisConfiguration : {[maxmemory-policy, allkeys-random]}
          EnableNonSslPort   : False
          RedisVersion       : 2.8
          Size               : 250MB
          Sku                : Standard
          Tag                : {}
          Zone               : []

Este cmdlet crea una caché mediante Azure Cache for Redis.

Ejemplo 3: Creación de una caché con redundancia de zona

New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "Central US" -Size P1 -Sku "Premium" -Zone @("1","2")

PrimaryKey         : ******
          SecondaryKey       : ******
          ResourceGroupName  : MyGroup
          Id                 : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/MyCache
          Location           : Central US
          Name               : mycache
          Type               : Microsoft.Cache/Redis
          HostName           : mycache.redis.cache.windows.net
          Port               : 6379
          ProvisioningState  : creating
          SslPort            : 6380
          RedisConfiguration : {[maxmemory-policy, allkeys-random], [maxclients, 7500], [maxmemory-reserved, 200],
                                [maxfragmentationmemory-reserved, 300]...}
          EnableNonSslPort   : False
          RedisVersion       : 4.0.14
          Size               : 6GB
          Sku                : Premium
          Tag                : {}
          Zone               : {1, 2}

Este comando crea la instancia de Azure Cache for Redis en zonas mutliple.

Ejemplo 4: Creación de una instancia de Virtual Network enable Cache

Requisitos para crear la caché de habilitación de red virtual.

Cree la red virtual en el mismo grupo de recursos en el que desea crear la caché de Redis. Puede crear una red virtual desde el comando de PowerShell New-AzVirtualNetwork .
Necesitará SubnetID para habilitar la memoria caché. A continuación se indica la sintaxis de SubnetID.

Formato de SubnetID: /subscriptions/{subid}/resourceGroups/{resourceGroupName}/providers/Microsoft.ClassicNetwork/VirtualNetworks/{vnetName}/subnets/{subnetName}

New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "Central US" -Size P1 -Sku "Premium" -SubnetId "/subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Network/virtualNetworks/MyNet/subnets/MySubnet"

PrimaryKey         : ******
          SecondaryKey       : ******
          ResourceGroupName  : MyGroup
          Id                 : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/MyCache
          Location           : Central US
          Name               : mycache
          Type               : Microsoft.Cache/Redis
          HostName           : mycache.redis.cache.windows.net
          Port               : 6379
          ProvisioningState  : creating
          SslPort            : 6380
          RedisConfiguration : {[maxmemory-policy, allkeys-random], [maxclients, 7500], [maxmemory-reserved, 200],
                                [maxfragmentationmemory-reserved, 300]...}
          EnableNonSslPort   : False
          RedisVersion       : 4.0.14
          Size               : 6GB
          Sku                : Premium
          SubnetId           : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Network/virtualNetworks/MyNet/subnets/MySubnet
          StaticIP           : 10.0.0.4
          Tag                : {}
          Zone               : []

Ejemplo 5: Configuración de la persistencia de datos para una instancia premium de Azure Cache for Redis

La persistencia escribe los datos de Redis en una cuenta de Azure Storage que posea y administre. Por lo tanto, antes de configurar la persistencia de datos, debe tener una cuenta de almacenamiento en el mismo grupo de recursos. Elija una cuenta de almacenamiento en la misma región y suscripción que la memoria caché; es recomendable que use una cuenta de Premium Storage, ya que tiene un mayor rendimiento.

Después de crear una cuenta de almacenamiento, obtenga la cuenta de almacenamiento cadena de conexión mediante este procedimiento.

Ejecute este comando Get-AzStorageAccountKey -ResourceGroupName $resourceGroupName -Name $storageAccountName en PowerShell.
En la salida anterior, copie cualquier clave.
Coloque la clave de la cuenta de almacenamiento y el nombre de la cuenta de almacenamiento en formato siguiente para obtener la cadena de conexión de la cuenta de almacenamiento.

Formato de cadena de conexión :- "DefaultEndpointsProtocol=https; AccountName={storageAccountName}; AccountKey={storageAccountKey}; EndpointSuffix=mySuffix"

Debe tener las opciones de configuración específicas de Redis para habilitar la persistencia de datos.

Para habilitar la copia de seguridad de RDB

rdb-backup-enabled (Establecer true o false)
rdb-storage-connection-string (Proporcione cadena de conexión en formato anterior).
rdb-backup-frequency (Establezca un intervalo de copia de seguridad en minutos. Solo puede elegir entre - 15, 30, 60, 360, 720 y 1440 minutos).

New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "Central US" -Size P1 -Sku "Premium" -RedisConfiguration @{"rdb-backup-enabled" = "true"; "rdb-storage-connection-string" = "DefaultEndpointsProtocol=https;AccountName=mystorageaccount;AccountKey=******;EndpointSuffix=mySuffix"; "rdb-backup-frequency" = "30"}

PrimaryKey         : ******
          SecondaryKey       : ******
          ResourceGroupName  : MyGroup
          Id                 : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/MyCache
          Location           : Central US
          Name               : mycache
          Type               : Microsoft.Cache/Redis
          HostName           : mycache.redis.cache.windows.net
          Port               : 6379
          ProvisioningState  : creating
          SslPort            : 6380
          RedisConfiguration : {[maxmemory-policy, allkeys-random], [maxclients, 7500], [maxmemory-reserved, 200],
                                [maxfragmentationmemory-reserved, 300], [rdb-backup-enabled, true]....}
          EnableNonSslPort   : False
          RedisVersion       : 4.0.14
          Size               : 6GB
          Sku                : Premium
          Tag                : {}
          Zone               : []

Ejemplo 6: Configuración de la persistencia de datos para una instancia premium de Azure Cache for Redis: copia de seguridad de AOF habilitada

Para la copia de seguridad de AOF habilitada.

aof-backup-enabled (Establecer true o false),
aof-storage-connection-string-0 (Proporcione cadena de conexión en formato anterior).
aof-storage-connection-string-1 (opcionalmente, puede configurar otra cuenta de almacenamiento. Si se configura una segunda cuenta de almacenamiento, las escrituras en la caché de réplicas se escriben en esta segunda cuenta de almacenamiento).

New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "Central US" -Size P1 -Sku "Premium" -RedisConfiguration @{"aof-backup-enabled" = "true"; "aof-storage-connection-string-0" = "DefaultEndpointsProtocol=https;AccountName=mystorageaccount;AccountKey=******;EndpointSuffix=mySuffix"}

PrimaryKey         : ******
          SecondaryKey       : ******
          ResourceGroupName  : MyGroup
          Id                 : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/MyCache
          Location           : Central US
          Name               : mycache
          Type               : Microsoft.Cache/Redis
          HostName           : mycache.redis.cache.windows.net
          Port               : 6379
          ProvisioningState  : creating
          SslPort            : 6380
          RedisConfiguration : {[maxmemory-policy, allkeys-random], [maxclients, 7500], [maxmemory-reserved, 200],
                                [maxfragmentationmemory-reserved, 300], [aof-backup-enabled, true]...}
          EnableNonSslPort   : False
          RedisVersion       : 4.0.14
          Size               : 6GB
          Sku                : Premium
          Tag                : {}
          Zone               : []

Parámetros

-Confirm

Le solicita su 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

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

Tipo:	IAzureContextContainer
Alias:	AzContext, AzureRmContext, AzureCredential
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DisableAccessKeyAuthentication

Opcional: la autenticación en Redis mediante claves de acceso está deshabilitada cuando se establece como true. El valor predeterminado es Falso.

Tipo:	String
Posición:	Named
Valor predeterminado:	false
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-EnableNonSslPort

Indica si el puerto no SSL está habilitado. El valor predeterminado es $False (el puerto que no es SSL está deshabilitado).

Tipo:	Nullable<T>[Boolean]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-IdentityType

Especifica el tipo de identidad que se usa para Azure Cache for Redis. Valores válidos: "SystemAssigned" o "UserAssigned" o "SystemAssignedUserAssigned" o "None"

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Location

Especifica la ubicación en la que se va a crear una instancia de Redis Cache. Los valores válidos son:

Centro-Norte de EE. UU
Centro-sur de EE. UU.
Centro de EE. UU.
Oeste de Europa
Norte de Europa
Oeste de EE. UU.
Este de EE. UU.
Este de EE. UU. 2
Japón Oriental
Japón Occidental
Sur de Brasil
Sudeste de Asia
Este de Asia
Este de Australia
Sudeste de Australia

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-MinimumTlsVersion

Especifique la versión de TLS requerida por los clientes para conectarse a la memoria caché.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Name

Especifica el nombre de redis Cache que se va a crear.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-RedisConfiguration

Especifica la configuración de Redis. Los valores permitidos para este parámetro son los siguientes:

rdb-backup-enabled. Especifica que la persistencia de datos de Redis está habilitada. Solo nivel Premium.
rdb-storage-connection-string. Especifica el cadena de conexión a la cuenta de almacenamiento para la persistencia de datos de Redis. Solo nivel Premium.
rdb-backup-frequency. Especifica la frecuencia de copia de seguridad para la persistencia de datos de Redis. Solo nivel Premium.
maxmemory-reserved. Configura la memoria reservada para los procesos que no son de caché. Niveles Estándar y Premium.
maxmemory-policy. Configura la directiva de expulsión para la memoria caché. Todos los planes de tarifa.
notify-keyspace-events. Configura las notificaciones del espacio de claves. Niveles Estándar y Premium.
hash-max-ziplist-entries. Configura la optimización de memoria para tipos de datos agregados pequeños. Niveles Estándar y Premium.
hash-max-ziplist-value. Configura la optimización de memoria para tipos de datos agregados pequeños. Niveles Estándar y Premium.
set-max-intset-entries. Configura la optimización de memoria para tipos de datos agregados pequeños. Niveles Estándar y Premium.
zset-max-ziplist-entries. Configura la optimización de memoria para tipos de datos agregados pequeños. Niveles Estándar y Premium.
zset-max-ziplist-value. Configura la optimización de memoria para tipos de datos agregados pequeños. Niveles Estándar y Premium.
. Configura el número de bases de datos. Esta propiedad solo se puede configurar al crear la memoria caché. Niveles Estándar y Premium. Para más información, consulte Administración de Azure Redis Cache con Azure PowerShellhttp://go.microsoft.com/fwlink/?LinkId=800051 (http://go.microsoft.com/fwlink/?LinkId=800051).
preferred-data-archive-auth-method Método de autenticación preferido para comunicarse con la cuenta de almacenamiento usada para el archivo de datos, especificar SAS o ManagedIdentity, el valor predeterminado es SAS.
preferred-data-persistence-auth-method Método de autenticación preferido para comunicarse con la cuenta de almacenamiento usada para la persistencia de datos, especificar SAS o ManagedIdentity, el valor predeterminado es SAS.

Tipo:	Hashtable
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-RedisVersion

Versión de Redis. Debe tener el formato "major[.minor]" (solo se requiere "major") o el valor "latest", que hace referencia a la versión estable más reciente de Redis que está disponible. Versiones compatibles: 4.0, 6.0 (más reciente). El valor predeterminado es "latest".

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-ResourceGroupName

Especifica el nombre del grupo de recursos en el que se va a crear redis Cache.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-ShardCount

Especifica el número de particiones que se van a crear en una caché de clúster Premium. Los valores permitidos para este parámetro son los siguientes:

Tipo:	Nullable<T>[Int32]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Size

Especifica el tamaño de La caché de Redis. Los valores válidos son:

P1
P2
P3
P4
P5
C0
C1
C2
C3
C4
C5
C6
250 MB
1 GB
2,5 GB
6 GB
13 GB
26 GB
53 GB El valor predeterminado es 1 GB o C1.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Sku

Especifica la SKU de Redis Cache que se va a crear. Los valores válidos son:

Básico
Estándar
Premium El valor predeterminado es Estándar.

Tipo:	String
Valores aceptados:	Basic, Standard, Premium
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-StaticIP

Especifica una dirección IP única en la subred de Redis Cache. Si no especifica un valor para este parámetro, este cmdlet elige una dirección IP de la subred.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-SubnetId

El identificador de recurso completo de una subred de una red virtual en la que se va a implementar Azure Cache for Redis. Formato de ejemplo: /subscriptions/{subid}/resourceGroups/{resourceGroupName}/Microsoft. {Network|ClassicNetwork}/VirtualNetworks/{vnetName}/subnets/{subnetName}

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Tag

Tabla hash que representa etiquetas.

Tipo:	Hashtable
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-TenantSettings

Este parámetro ha quedado en desuso.

Tipo:	Hashtable
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-UpdateChannel

Opcional: especifica el canal de actualización para las actualizaciones mensuales de Redis que recibirá la instancia de Redis Cache. Las memorias caché que usan el canal de actualización "Versión preliminar" obtienen las actualizaciones más recientes de Redis al menos 4 semanas antes de las cachés de canales "estables". El valor predeterminado es "Estable". Entre los valores posibles se incluyen: "Stable", "Preview"

Tipo:	String
Posición:	Named
Valor predeterminado:	Stable
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-UserAssignedIdentity

Especifica una o varias identidades de usuario separadas por comas que se asociarán a Azure Cache for Redis. Las referencias de identidad de usuario serán identificadores de recursos de ARM con el formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identities/{identityName}'

Tipo:	String[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. 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

Lista de regiones de Azure con zonas de disponibilidad.

Tipo:	String[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

Entradas

String

Hashtable

Nullable<T>[[System.Boolean, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

Nullable<T>[[System.Int32, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

String[]

Salidas

RedisCacheAttributesWithAccessKeys

Compartir a través de

New-AzRedisCache

Sintaxis

Description

Ejemplos

Ejemplo 1: Creación de una instancia de Redis Cache

Ejemplo 2: Creación de una SKU estándar en Redis Cache

Ejemplo 3: Creación de una caché con redundancia de zona

Ejemplo 4: Creación de una instancia de Virtual Network enable Cache

Ejemplo 5: Configuración de la persistencia de datos para una instancia premium de Azure Cache for Redis

Ejemplo 6: Configuración de la persistencia de datos para una instancia premium de Azure Cache for Redis: copia de seguridad de AOF habilitada

Parámetros

-Confirm

-DefaultProfile

-DisableAccessKeyAuthentication

-EnableNonSslPort

-IdentityType

-Location

-MinimumTlsVersion

-Name

-RedisConfiguration

-RedisVersion

-ResourceGroupName

-ShardCount

-Size

-Sku

-StaticIP

-SubnetId

-Tag

-TenantSettings

-UpdateChannel

-UserAssignedIdentity

-WhatIf

-Zone

Entradas

Salidas

Recursos adicionales

Compartir a través de

New-AzRedisCache

Sintaxis

Description

Ejemplos

Ejemplo 1: Creación de una instancia de Redis Cache

Ejemplo 2: Creación de una SKU estándar en Redis Cache

Ejemplo 3: Creación de una caché con redundancia de zona

Ejemplo 4: Creación de una instancia de Virtual Network enable Cache

Ejemplo 5: Configuración de la persistencia de datos para una instancia premium de Azure Cache for Redis

Ejemplo 6: Configuración de la persistencia de datos para una instancia premium de Azure Cache for Redis: copia de seguridad de AOF habilitada

Parámetros

-Confirm

-DefaultProfile

-DisableAccessKeyAuthentication

-EnableNonSslPort

-IdentityType

-Location

-MinimumTlsVersion

-Name

-RedisConfiguration

-RedisVersion

-ResourceGroupName

-ShardCount

-Size

-Sku

-StaticIP

-SubnetId

-Tag

-TenantSettings

-UpdateChannel

-UserAssignedIdentity

-WhatIf

-Zone

Entradas

Salidas

Vínculos relacionados

Recursos adicionales