New-AzRedisCache

  • Referencia
Módulo:
Az.RedisCache

Crea una instancia de Redis Cache.

Syntax

New-AzRedisCache
   -ResourceGroupName <String>
   -Name <String>
   -Location <String>
   [-Size <String>]
   [-Sku <String>]
   [-RedisConfiguration <Hashtable>]
   [-EnableNonSslPort <Boolean>]
   [-TenantSettings <Hashtable>]
   [-ShardCount <Int32>]
   [-MinimumTlsVersion <String>]
   [-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         : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          SecondaryKey       : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          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         : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          SecondaryKey       : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          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         : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          SecondaryKey       : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          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.

  1. 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 .
  2. 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         : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          SecondaryKey       : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          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.

  1. Ejecute este comando Get-AzStorageAccountKey -ResourceGroupName $resourceGroupName -Name $storageAccountName en PowerShell.
  2. En la salida anterior, copie cualquier clave.
  3. 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.

Conectar ion String Format :- "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=pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=;EndpointSuffix=mySuffix"; "rdb-backup-frequency" = "30"}

PrimaryKey         : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          SecondaryKey       : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          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=pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=;EndpointSuffix=mySuffix"}

PrimaryKey         : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          SecondaryKey       : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          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.

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

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableNonSslPort

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

Type:Nullable<T>[Boolean]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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"

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

-MinimumTlsVersion

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

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

-Name

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

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

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

-ResourceGroupName

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

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

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Sku

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

  • Basic
  • Estándar
  • Premium El valor predeterminado es Estándar.
Type:String
Accepted values:Basic, Standard, Premium
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

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

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

-Tag

Tabla hash que representa etiquetas.

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

-TenantSettings

Este parámetro ha quedado en desuso.

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

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

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

Lista de regiones de Azure con zonas de disponibilidad.

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