Administrar Azure Redis con Azure PowerShell

• PowerShell
• CLI de Azure

Azure Managed Redis

1. Para crear una instancia de Azure Managed Redis (versión preliminar), inicie sesión en Azure Portal y seleccione Crear un recurso.

2. En la página Nuevo, en el cuadro de búsqueda, escriba Azure Cache for Redis.

3. En la página Nueva instancia de Redis Cache, configure las opciones de la nueva caché.

   Configuración	Elegir un valor	Descripción
   Suscripción	Desplácese hacia abajo y seleccione su suscripción.	La suscripción en la que se va a crear esta nueva instancia de Azure Managed Redis.
   Grupo de recursos	Desplácese hacia abajo y seleccione un grupo de recursos o Crear nuevo y escriba un nombre nuevo para el grupo de recursos.	Nombre del grupo de recursos en el que se van a crear la caché y otros recursos. Al colocar todos los recursos de la aplicación en un grupo de recursos, puede administrarlos o eliminarlos fácilmente.
   Nombre DNS	Escriba un nombre que sea único en la región.	El nombre de la memoria caché debe ser una cadena de entre 1 y 63 caracteres combinada con el nombre de la región de la memoria caché que contenga solo números, letras o guiones. (Si el nombre de la caché tiene menos de 45 caracteres, debe funcionar en todas las regiones disponibles actualmente). El nombre debe comenzar y terminar por un número o una letra y no puede contener guiones consecutivos. El nombre de host de la instancia de caché es \<DNS name\>.\<Azure region\>.redis.azure.net.
   Ubicación	Desplácese hacia abajo y seleccione una ubicación.	Azure Managed Redis está disponible en las regiones de Azure seleccionadas.
   Tipo de caché	Desplegable y seleccione el nivel de rendimiento y el tamaño de caché.	El nivel determina el rendimiento de la instancia de Redis, mientras que el tamaño de caché determina la memoria disponible para almacenar datos. Para obtener instrucciones sobre cómo elegir el nivel de rendimiento adecuado, consulte Elección del nivel correcto

   

4. Seleccione Siguiente: Redes y seleccione un punto de conexión público o privado.

5. Seleccione Siguiente: Opciones avanzadas.

   Configure los módulos de Redis que quiere agregar a la instancia.

   De forma predeterminada, para una nueva caché administrada:

   • Microsoft Entra ID está habilitado.
   • La autenticación de claves de acceso está deshabilitada por motivos de seguridad.

   Importante

   Para obtener una seguridad óptima, se recomienda usar Microsoft Entra ID con identidades administradas para autorizar solicitudes en la memoria caché, si es posible. La autorización mediante Microsoft Entra ID y las identidades administradas proporciona una seguridad y facilidad de uso superiores a la autorización mediante claves de acceso compartidas. Para más información sobre el uso de identidades administradas con la memoria caché, consulte Uso de Microsoft Entra ID para la autenticación de caché.

   Establezca Directiva de agrupación en clústeres en Enterprise para una memoria caché no en clúster, o bien en OSS para una caché en clúster. Para obtener más información sobre cómo elegir Directiva de agrupación en clústeres, consulte directiva de clúster.

   

   Si usa replicación geográfica activa, debe configurarse durante la creación. Para obtener más información, consulte Configuración de la replicación geográfica activa para instancias de Azure Managed Redis.

   Importante

   No puede cambiar la directiva de agrupación en clústeres de una instancia de Azure Managed Redis (versión preliminar) después de crearla. Si usa RediSearch, se requiere la directiva de clúster Enterprise y NoEviction es la única directiva de expulsión admitida.

   Importante

   Si usa esta instancia de caché en un grupo de replicación geográfica, las directivas de expulsión no se pueden cambiar después de crear la instancia. Asegúrese de conocer las directivas de expulsión de los nodos principales antes de crear la caché. Para obtener más información sobre la replicación geográfica activa, consulte Requisitos previos de replicación geográfica activa.

   Importante

   No se pueden cambiar los módulos después de crear una instancia de caché. Los módulos deben estar habilitados en el momento de crear una instancia de Azure Cache for Redis. No hay ninguna opción para habilitar la configuración de un módulo después de crear una memoria caché.

6. Seleccione Siguiente: Etiquetas y omítalo.

7. Seleccione Siguiente: Review + create (Revisar y crear).

8. Revise la configuración y seleccione Crear.

   La instancia de Redis tarda varios minutos en crearse. Puede supervisar el progreso en la página Información general de Azure Managed Redis. Cuando Estado se muestra como En ejecución, la memoria caché está lista para su uso.

Azure Cache for Redis

1. Para crear una caché, inicie sesión en Azure Portal. En el menú de Azure Portal, seleccione Crear un recurso.

   

2. En el panel Comenzar, escriba Azure Cache for Redis en la barra de búsqueda. En los resultados de la búsqueda, encuentre Azure Cache for Redis y, a continuación, seleccione Crear.

   

3. En el panel Nueva Redis Cache, en la pestaña Aspectos básicos, configure las siguientes opciones para la memoria caché:

   Configuración	Acción	Descripción
   Suscripción	Seleccione la suscripción a Azure.	La suscripción que se va a usar para crear la nueva instancia de Azure Cache for Redis.
   Grupo de recursos	Seleccione un grupo de recursos o Crear nuevo, y escriba un nombre nuevo para el grupo de recursos.	Nombre del grupo de recursos en el que se va a crear la memoria caché y otros recursos. Al colocar todos los recursos de la aplicación en un grupo de recursos, puede administrarlos o eliminarlos fácilmente.
   Nombre DNS	Escriba un nombre único.	El nombre de caché debe ser una cadena de 1 a 63 caracteres que contenga solo números, letras y guiones. El nombre debe comenzar y terminar por un número o una letra y no puede contener guiones consecutivos. El nombre de host de la instancia de caché es \<DNS name>.redis.cache.windows.net.
   Ubicación	Seleccione una ubicación.	Una región de Azure cercana a otros servicios que usan la memoria caché.
   SKU de la caché	Seleccione una SKU.	La SKU determina los parámetros de tamaño, rendimiento y característica que están disponibles para la memoria caché. Para más información, consulte la introducción a Azure Cache for Redis.
   Tamaño de la caché	Seleccione un tamaño de caché.	Para más información, consulte la introducción a Azure Cache for Redis.

4. Seleccione la pestaña Redes o Siguiente: Redes.

5. En la pestaña Redes, seleccione un método de conectividad que se usará para la memoria caché.

6. Seleccione la pestaña Opciones avanzadas o Siguiente: Opciones avanzadas.

7. En el panel Opciones avanzadas, compruebe o seleccione un método de autenticación en función de la siguiente información:

   

   • De manera predeterminada, para una nueva caché Básica, Estándar o Premium, la Autenticación de Microsoft Entra está habilitada y la Autenticación de claves de acceso está deshabilitada.
   • Para las cachés Básica o Estándar, puede elegir la selección de un puerto que no sea TLS.
   • Para las cachés Estándar y Premium, puede habilitar las zonas de disponibilidad. No puede deshabilitar las zonas de disponibilidad una vez creada la caché.
   • En el caso de una caché Premium, configure las opciones para un puerto que no sea TLS, la agrupación en clústeres, la identidad administrada y la persistencia de datos.

   Importante

   Para obtener una seguridad óptima, se recomienda usar Microsoft Entra ID con identidades administradas para autorizar solicitudes en la memoria caché, si es posible. La autorización mediante Microsoft Entra ID y las identidades administradas proporciona una seguridad y facilidad de uso superiores a la autorización mediante claves de acceso compartidas. Para más información sobre el uso de identidades administradas con la memoria caché, consulte Uso de Microsoft Entra ID para la autenticación de caché.

8. (Opcional) Seleccione la pestaña Etiquetas o Siguiente: Etiquetas.

9. (Opcional) En la pestaña Etiquetas, escriba un nombre de etiqueta y un valor si desea clasificar el recurso de caché.

10. Seleccione el botón Revisar y crear.

    En la pestaña Revisar y crear, Azure valida automáticamente la configuración.

11. Tras aparecer el mensaje verde Validación superada, seleccione Crear.

Se produce una nueva implementación de caché durante varios minutos. Puede supervisar el progreso de la implementación en el panel Información general de Azure Cache for Redis. Cuando Estado muestra En ejecución, la memoria caché está lista para usarse.

Este artículo le muestra cómo crear, actualizar y escalar sus instancias de Azure Redis.

Nota:

Azure tiene dos modelos de implementación diferentes que puede usar para crear recursos y trabajar con ellos: Azure Resource Manager y la versión clásica. Este artículo trata sobre el modelo de implementación del Administrador de recursos. Se recomienda usar el modelo de implementación de Resource Manager para las nuevas implementaciones, en lugar del modelo de implementación clásica.

Para más información acerca del modelo de implementación clásico, consulte Azure Resource Manager vs. classic deployment: Understand deployment models and the state of your resources (Implementación clásica frente a implementación con Azure Resource Manager: los modelos de implementación y el estado de los recursos).

Requisitos previos

Si ya ha instalado Azure PowerShell, debe tener Azure PowerShell versión 12.4.0 o posterior. Puede comprobar la versión de Azure PowerShell con este comando en el símbolo del sistema de Azure PowerShell.

    Get-Module Az | format-table version

En primer lugar, tiene que iniciar sesión en Azure con este comando.

    Connect-AzAccount

Especifique la dirección de correo electrónico de la cuenta de Azure y la contraseña en el cuadro de diálogo de inicio de sesión de Microsoft Azure.

A continuación, si tiene varias suscripciones de Azure, deberá establecer la suscripción de Azure. Para ver una lista de las suscripciones actuales, ejecute este comando.

    Get-AzSubscription | sort SubscriptionName | Select SubscriptionName

Para especificar la suscripción, ejecute el siguiente comando. En el ejemplo siguiente, el nombre de la suscripción es ContosoSubscription.

    Select-AzSubscription -SubscriptionName ContosoSubscription

Para poder usar Windows PowerShell con Azure Resource Manager, tiene que comprobar la configuración:

• Windows PowerShell, versión 3.0 o 4.0. Para buscar la versión de Windows PowerShell, escriba:$PSVersionTable y compruebe que el valor de PSVersion es 3.0 o 4.0. Para instalar una versión compatible, consulte Windows Management Framework 3.0.

Para obtener ayuda detallada con cualquier cmdlet que aparezca en este tutorial, use el cmdlet Get-Help.

    Get-Help <cmdlet-name> -Detailed

Por ejemplo, para obtener ayuda para el cmdlet New-AzRedisEnterpriseCache , escriba:

    Get-Help New-AzRedisEnterpriseCache -Detailed

Conexión a otras nubes

De forma predeterminada, el entorno de Azure es AzureCloud, que representa la instancia de nube de Azure global. Para conectarse a otra instancia, use el comando Connect-AzAccount con el conmutador de línea de comandos -Environment o -EnvironmentName con el nombre de entorno o el entorno que quiere.

Para ver la lista de entornos disponibles, ejecute el cmdlet Get-AzEnvironment .

Conexión a la nube de Azure Government

Para conectarse a la nube de Azure Government, utilice uno de los siguientes comandos.

    Connect-AzAccount -EnvironmentName AzureUSGovernment

Or

    Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureUSGovernment)

Para crear una memoria caché en la nube de Azure Government, utilice una de las siguientes ubicaciones.

• USGov Virginia
• USGov Iowa

Para más información acerca de la nube de Azure Government, consulte Microsoft Azure Government y la Guía para desarrolladores de Microsoft Azure Government.

Para conectarse a la nube de Microsoft Azure operado por 21Vianet

Para conectarse a la nube de Azure operado por 21Vianet, use uno de los siguientes comandos.

    Connect-AzAccount -EnvironmentName AzureChinaCloud

Or

    Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureChinaCloud)

Para crear una memoria caché en la nube de Azure operado por 21Vianet, utilice una de las siguientes ubicaciones.

• Este de China
• Norte de China

Conexión a Microsoft Azure Alemania

Para conectarse a Microsoft Azure Alemania, utilice uno de los siguientes comandos.

    Connect-AzAccount -EnvironmentName AzureGermanCloud

Or

    Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureGermanCloud)

Para crear una memoria caché en Microsoft Azure Alemania, use una de las siguientes ubicaciones.

• Centro de Alemania
• Nordeste de Alemania

Para obtener más información acerca de Microsoft Azure Alemania, consulte Microsoft Azure Germany.

Parámetros y propiedades de PowerShell de Azure Managed Redis

Para obtener una lista de todos los parámetros y propiedades de Azure Managed Redis PowerShell, consulte New-AzRedisEnterpriseCache.

Para crear un Azure Managed Redis

Las nuevas instancias de Azure Managed Redis se crean mediante el cmdlet New-AzRedisEnterpriseCache cmdlet.

Importante

La primera vez que se crea un Azure Managed Redis en una suscripción mediante Azure Portal, el portal registra el espacio de nombres Microsoft.Cache para esa suscripción. Si intenta crear el primer Azure Managed Redis en una suscripción mediante PowerShell, primero debe registrar ese espacio de nombres mediante el siguiente comando; de lo contrario, los cmdlets como New-AzRedisEnterpriseCache y Get-AzRedisEnterpriseCache fallan.

Register-AzResourceProvider -ProviderNamespace "Microsoft.Cache"

Para ver una lista de parámetros disponibles y sus descripciones para New-AzRedisEnterpriseCache, ejecute el siguiente comando.

    PS C:\> Get-Help New-AzRedisEnterpriseCache -detailed

    NAME
        New-AzRedisEnterpriseCache

    SYNOPSIS
        Creates a new Azure Managed Redis.


    SYNTAX
        New-AzRedisEnterpriseCache -Name <String> -ResourceGroupName <String> -Location <String> [-RedisVersion <String>]
        [-Sku <String>] [-MaxMemoryPolicy <String>] [-RedisConfiguration <Hashtable>] [-EnableNonSslPort
        <Boolean>] [-ShardCount <Integer>] [-VirtualNetwork <String>] [-Subnet <String>] [-StaticIP <String>]
        [<CommonParameters>]


    DESCRIPTION
        The New-AzRedisEnterpriseCache cmdlet creates a new Azure Managed Redis.


    PARAMETERS
        -Name <String>
            Name of the Azure Managed Redis to create.

        -ResourceGroupName <String>
            Name of resource group in which to create the Azure Managed Redis.

        -Location <String>
            Location in which to create the Azure Managed Redis.

        -RedisVersion <String>
            RedisVersion is deprecated and will be removed in future release.

        -Sku <String>
            Sku of Azure Managed Redis.

        -MaxMemoryPolicy <String>
            The 'MaxMemoryPolicy' setting has been deprecated. Please use 'RedisConfiguration' setting to set
            MaxMemoryPolicy. e.g. -RedisConfiguration @{"maxmemory-policy" = "allkeys-lru"}

        -RedisConfiguration <Hashtable>
            All Redis Configuration Settings. Few possible keys: rdb-backup-enabled, rdb-storage-connection-string,
            rdb-backup-frequency, maxmemory-reserved, maxmemory-policy, notify-keyspace-events, hash-max-ziplist-entries,
            hash-max-ziplist-value, set-max-intset-entries, zset-max-ziplist-entries, zset-max-ziplist-value, databases.

        -EnableNonSslPort <Boolean>
            EnableNonSslPort is used by Azure Managed Redis. If no value is provided, the default value is false and the
            non-SSL port will be disabled. Possible values are true and false.

        -ShardCount <Integer>
            The number of shards to create on a Cluster Cache.

        -VirtualNetwork <String>
            The exact ARM resource ID of the virtual network to deploy the Azure Managed Redis in. Example format: /subscriptions/{
            subid}/resourceGroups/{resourceGroupName}/providers/Microsoft.ClassicNetwork/VirtualNetworks/{vnetName}

        -Subnet <String>
            Required when deploying an Azure Managed Redis inside an existing Azure Virtual Network.

        -StaticIP <String>
            Required when deploying an Azure Managed Redis inside an existing Azure Virtual Network.

        <CommonParameters>
            This cmdlet supports the common parameters: Verbose, Debug,
            ErrorAction, ErrorVariable, WarningAction, WarningVariable,
            OutBuffer, PipelineVariable, and OutVariable. For more information, see
            about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Para crear una memoria caché con parámetros predeterminados, ejecute el siguiente comando.

    New-AzRedisEnterpriseCache -ResourceGroupName myGroup -Name mycache -Location "North Central US"

ResourceGroupName, Name y Location son parámetros obligatorios, pero el resto son opcionales y tienen valores predeterminados. Al ejecutar el comando anterior se crea una instancia de Azure Managed Redis con el nombre, la ubicación y el grupo de recursos especificados. La instancia tiene un tamaño de 1 GB con el puerto no SSL deshabilitado.

Para habilitar la agrupación en clústeres, especifique un número de particiones mediante el parámetro ShardCount .

Para especificar valores para el parámetro RedisConfiguration, incluya los valores dentro de {} como pares de valor o de clave como en @{"maxmemory-policy" = "allkeys-random", "notify-keyspace-events" = "KEA"}. El siguiente ejemplo crea una caché de 1 GB con la directiva maxmemory allkeys-random y las notificaciones de espacio de claves configuradas con KEA. Para más información, consulte Notificaciones de Keyspace (configuración avanzada) y Directivas de memoria.

    New-AzRedisEnterpriseCache -ResourceGroupName myGroup -Name mycache -Location "North Central US" -RedisConfiguration @{"maxmemory-policy" = "allkeys-random", "notify-keyspace-events" = "KEA"}

Configuración de las bases de datos al crear la memoria caché

El parámetro databases se puede configurar al crear la memoria caché. El siguiente ejemplo crea una caché con 48 bases de datos utilizando el cmdlet New-AzRedisEnterpriseCache.

    New-AzRedisEnterpriseCache -ResourceGroupName myGroup -Name mycache -Location "North Central US" -Sku B1 -RedisConfiguration @{"databases" = "48"}

Para obtener más información sobre la propiedad databases, consulte Configuración predeterminada del servidor Azure Managed Redis. Para obtener más información sobre la creación de una caché mediante el cmdlet New-AzRedisEnterpriseCache, consulte la sección anterior Para crear un Azure Managed Redis.

Para actualizar un Azure Managed Redis

Las instancias de Azure Managed Redis se actualizan mediante el cmdlet [Set-AzRedisEnterpriseCache].

Para ver una lista de parámetros disponibles y sus descripciones para Set-AzRedisEnterpriseCache, ejecute el siguiente comando.

    PS C:\> Get-Help Set-AzRedisEnterpriseCache -detailed

    NAME
        Set-AzRedisEnterpriseCache

    SYNOPSIS
        Set Azure Managed Redis updatable parameters.

    SYNTAX
        Set-AzRedisEnterpriseCache -Name <String> -ResourceGroupName <String> [-Sku <String>]
        [-MaxMemoryPolicy <String>] [-RedisConfiguration <Hashtable>] [-EnableNonSslPort <Boolean>] [-ShardCount
        <Integer>] [<CommonParameters>]

    DESCRIPTION
        The Set-AzRedisEnterpriseCache cmdlet sets Azure Managed Redis parameters.

    PARAMETERS
        -Name <String>
            Name of the Azure Managed Redis to update.

        -ResourceGroupName <String>
            Name of the resource group for the cache.

        -Sku <String>
            Sku of Azure Managed Redis.

        -MaxMemoryPolicy <String>
            The 'MaxMemoryPolicy' setting has been deprecated. Please use 'RedisConfiguration' setting to set
            MaxMemoryPolicy. e.g. -RedisConfiguration @{"maxmemory-policy" = "allkeys-lru"}

        -RedisConfiguration <Hashtable>
            All Redis Configuration Settings. Few possible keys: rdb-backup-enabled, rdb-storage-connection-string,
            rdb-backup-frequency, maxmemory-reserved, maxmemory-policy, notify-keyspace-events, hash-max-ziplist-entries,
            hash-max-ziplist-value, set-max-intset-entries, zset-max-ziplist-entries, zset-max-ziplist-value.

        -EnableNonSslPort <Boolean>
            EnableNonSslPort is used by Azure Managed Redis. The default value is null and no change will be made to the
            currently configured value. Possible values are true and false.

        -ShardCount <Integer>
            The number of shards to create on a Cluster Cache.

        <CommonParameters>
            This cmdlet supports the common parameters: Verbose, Debug,
            ErrorAction, ErrorVariable, WarningAction, WarningVariable,
            OutBuffer, PipelineVariable, and OutVariable. For more information, see
            about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

El cmdlet Set-AzRedisEnterpriseCache se puede utilizar para actualizar propiedades como los valores Sku, EnableNonSslPort, y RedisConfiguration.

El siguiente comando actualiza la directiva maxmemory-policy para Azure Managed Redis denominada myCache.

    Set-AzRedisEnterpriseCache -ResourceGroupName "myGroup" -Name "myCache" -RedisConfiguration @{"maxmemory-policy" = "allkeys-random"}

Para obtener información sobre Azure Managed Redis

Puede recuperar información sobre una caché utilizando el cmdlet Get-AzRedisEnterpriseCache.

Para ver una lista de parámetros disponibles y sus descripciones para Get-AzRedisEnterpriseCache, ejecute el siguiente comando.

    PS C:\> Get-Help Get-AzRedisEnterpriseCache -detailed

    NAME
        Get-AzRedisEnterpriseCache

    SYNOPSIS
        Gets details about a single cache or all caches in the specified resource group or all caches in the current
        subscription.

    SYNTAX
        Get-AzRedisEnterpriseCache [-Name <String>] [-ResourceGroupName <String>] [<CommonParameters>]

    DESCRIPTION
        The Get-AzRedisEnterpriseCache cmdlet gets the details about a cache or caches depending on input parameters. If both
        ResourceGroupName and Name parameters are provided then Get-AzRedisEnterpriseCache will return details about the
        specific cache name provided.

        If only ResourceGroupName is provided than it will return details about all caches in the specified resource group.

        If no parameters are given than it will return details about all caches the current subscription.

    PARAMETERS
        -Name <String>
            The name of the cache. When this parameter is provided along with ResourceGroupName, Get-AzRedisEnterpriseCache
            returns the details for the cache.

        -ResourceGroupName <String>
            The name of the resource group that contains the cache or caches. If ResourceGroupName is provided with Name
            then Get-AzRedisEnterpriseCache returns the details of the cache specified by Name. If only the ResourceGroup
            parameter is provided, then details for all caches in the resource group are returned.

        <CommonParameters>
            This cmdlet supports the common parameters: Verbose, Debug,
            ErrorAction, ErrorVariable, WarningAction, WarningVariable,
            OutBuffer, PipelineVariable, and OutVariable. For more information, see
            about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Para devolver información sobre todas las cachés de la suscripción actual, ejecute Get-AzRedisEnterpriseCache sin ningún parámetro.

    Get-AzRedisEnterpriseCache

Para devolver información sobre todas las cachés de un grupo de recursos específico, ejecute Get-AzRedisEnterpriseCache con el parámetro ResourceGroupName.

    Get-AzRedisEnterpriseCache -ResourceGroupName myGroup

Para devolver información sobre una caché específica, ejecute Get-AzRedisEnterpriseCache con el parámetro Name que contiene el nombre de la caché y el parámetro ResourceGroupName con el grupo de recursos que contiene esa caché.

    PS C:\> Get-AzRedisEnterpriseCache -Name myCache -ResourceGroupName myGroup

    Name               : mycache
    Id                 : /subscriptions/12ad12bd-abdc-2231-a2ed-a2b8b246bbad4/resourceGroups/myGroup/providers/Mi
                         crosoft.Cache/Redis/mycache
    Location           : South Central US
    Type               : Microsoft.Cache/Redis
    HostName           : mycache.redis.cache.windows.net
    Port               : 10000
    ProvisioningState  : Succeeded
    SslPort            : 6380
    RedisConfiguration : {[maxmemory-policy, volatile-lru], [maxmemory-reserved, 62], [notify-keyspace-events, KEA],
                         [maxclients, 1000]...}
    EnableNonSslPort   : False
    RedisVersion       : 3.0
    Sku                : B1
    ResourceGroupName  : myGroup
    VirtualNetwork     :
    Subnet             :
    StaticIP           :
    TenantSettings     : {}
    ShardCount         :

Para recuperar las claves de acceso de un Azure Managed Redis

Para recuperar las claves de acceso de su caché, puede utilizar el cmdlet Get-AzRedisEnterpriseCacheKey.

Para ver una lista de parámetros disponibles y sus descripciones para Get-AzRedisEnterpriseCacheKey, ejecute el siguiente comando.

    PS C:\> Get-Help Get-AzRedisEnterpriseCacheKey -detailed

    NAME
        Get-AzRedisEnterpriseCacheKey

    SYNOPSIS
        Gets the accesskeys for the specified Azure Managed Redis.


    SYNTAX
        Get-AzRedisEnterpriseCacheKey -Name <String> -ResourceGroupName <String> [<CommonParameters>]

    DESCRIPTION
        The Get-AzRedisEnterpriseCacheKey cmdlet gets the access keys for the specified cache.

    PARAMETERS
        -Name <String>
            Name of the Azure Managed Redis.

        -ResourceGroupName <String>
            Name of the resource group for the cache.

        <CommonParameters>
            This cmdlet supports the common parameters: Verbose, Debug,
            ErrorAction, ErrorVariable, WarningAction, WarningVariable,
            OutBuffer, PipelineVariable, and OutVariable. For more information, see
            about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Para recuperar las claves de la caché, llame al cmdlet Get-AzRedisEnterpriseCacheKey y pase el nombre de la memoria caché y el nombre del grupo de recursos que contiene la memoria caché.

    PS C:\> Get-AzRedisEnterpriseCacheKey -Name myCache -ResourceGroupName myGroup

    PrimaryKey   : b2wdt43sfetlju4hfbryfnregrd9wgIcc6IA3zAO1lY=
    SecondaryKey : ABhfB757JgjIgt785JgKH9865eifmekfnn649303JKL=

Para volver a generar claves de acceso para Azure Managed Redis

Para regenerar las claves de acceso de su caché, puede utilizar el cmdlet New-AzRedisEnterpriseCacheKey.

Para ver una lista de parámetros disponibles y sus descripciones para New-AzRedisEnterpriseCacheKey, ejecute el siguiente comando.

    PS C:\> Get-Help New-AzRedisEnterpriseCacheKey -detailed

    NAME
        New-AzRedisEnterpriseCacheKey

    SYNOPSIS
        Regenerates the access key of an Azure Managed Redis.

    SYNTAX
        New-AzRedisEnterpriseCacheKey -Name <String> -ResourceGroupName <String> -KeyType <String> [-Force] [<CommonParameters>]

    DESCRIPTION
        The New-AzRedisEnterpriseCacheKey cmdlet regenerate the access key of an Azure Managed Redis.

    PARAMETERS
        -Name <String>
            Name of the Azure Managed Redis.

        -ResourceGroupName <String>
            Name of the resource group for the cache.

        -KeyType <String>
            Specifies whether to regenerate the primary or secondary access key. Possible values are Primary or Secondary.

        -Force
            When the Force parameter is provided, the specified access key is regenerated without any confirmation prompts.

        <CommonParameters>
            This cmdlet supports the common parameters: Verbose, Debug,
            ErrorAction, ErrorVariable, WarningAction, WarningVariable,
            OutBuffer, PipelineVariable, and OutVariable. For more information, see
            about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Para regenerar la clave principal o secundaria de la caché, llame al cmdlet New-AzRedisEnterpriseCacheKey y pase el nombre, el grupo de recursos y especifique Primary o Secondary para el parámetro KeyType. En el ejemplo siguiente, se regenera la clave de acceso secundaria de una memoria caché.

    PS C:\> New-AzRedisEnterpriseCacheKey -Name myCache -ResourceGroupName myGroup -KeyType Secondary

    Confirm
    Are you sure you want to regenerate Secondary key for Azure Managed Redis 'myCache'?
    [Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"): Y


    PrimaryKey   : b2wdt43sfetlju4hfbryfnregrd9wgIcc6IA3zAO1lY=
    SecondaryKey : c53hj3kh4jhHjPJk8l0jji785JgKH9865eifmekfnn6=

Para eliminar un Azure Managed Redis

Para eliminar un Azure Managed Redis, utilice el cmdlet Remove-AzRedisEnterpriseCache.

Para ver una lista de parámetros disponibles y sus descripciones para Remove-AzRedisEnterpriseCache, ejecute el siguiente comando.

    PS C:\> Get-Help Remove-AzRedisEnterpriseCache -detailed

    NAME
        Remove-AzRedisEnterpriseCache

    SYNOPSIS
        Remove Azure Managed Redis if exists.

    SYNTAX
        Remove-AzRedisEnterpriseCache -Name <String> -ResourceGroupName <String> [-Force] [-PassThru] [<CommonParameters>

    DESCRIPTION
        The Remove-AzRedisEnterpriseCache cmdlet removes an Azure Managed Redis if it exists.

    PARAMETERS
        -Name <String>
            Name of the Azure Managed Redis to remove.

        -ResourceGroupName <String>
            Name of the resource group of the cache to remove.

        -Force
            When the Force parameter is provided, the cache is removed without any confirmation prompts.

        -PassThru
            By default Remove-AzRedisEnterpriseCache removes the cache and does not return any value. If the PassThru par
            is provided then Remove-AzRedisEnterpriseCache returns a boolean value indicating the success of the operatio

        <CommonParameters>
            This cmdlet supports the common parameters: Verbose, Debug,
            ErrorAction, ErrorVariable, WarningAction, WarningVariable,
            OutBuffer, PipelineVariable, and OutVariable. For more information, see
            about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

En el ejemplo siguiente, se quita la memoria caché denominada myCache .

    PS C:\> Remove-AzRedisEnterpriseCache -Name myCache -ResourceGroupName myGroup

    Confirm
    Are you sure you want to remove Azure Managed Redis 'myCache'?
    [Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"): Y

Para importar un Azure Managed Redis

Puede importar datos a una instancia de Azure Managed Redis utilizando el cmdlet Import-AzRedisEnterpriseCache.

Para ver una lista de parámetros disponibles y sus descripciones para Import-AzRedisEnterpriseCache, ejecute el siguiente comando.

    PS C:\> Get-Help Import-AzRedisEnterpriseCache -detailed

    NAME
        Import-AzRedisEnterpriseCache

    SYNOPSIS
        Import data from blobs to Azure Managed Redis.


    SYNTAX
        Import-AzRedisEnterpriseCache -Name <String> -ResourceGroupName <String> -Files <String[]> [-Format <String>] [-Force]
        [-PassThru] [<CommonParameters>]


    DESCRIPTION
        The Import-AzRedisEnterpriseCache cmdlet imports data from the specified blobs into Azure Managed Redis.


    PARAMETERS
        -Name <String>
            The name of the cache.

        -ResourceGroupName <String>
            The name of the resource group that contains the cache.

        -Files <String[]>
            SAS urls of blobs whose content should be imported into the cache.

        -Format <String>
            Format for the blob.  Currently "rdb" is the only supported, with other formats expected in the future.

        -Force
            When the Force parameter is provided, import will be performed without any confirmation prompts.

        -PassThru
            By default Import-AzRedisEnterpriseCache imports data in cache and does not return any value. If the PassThru
            parameter is provided then Import-AzRedisEnterpriseCache returns a boolean value indicating the success of the
            operation.

        <CommonParameters>
            This cmdlet supports the common parameters: Verbose, Debug,
            ErrorAction, ErrorVariable, WarningAction, WarningVariable,
            OutBuffer, PipelineVariable, and OutVariable. For more information, see
            about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

El siguiente comando importa datos desde el blob especificado por la uri SAS a Azure Managed Redis.

    PS C:\>Import-AzRedisEnterpriseCache -ResourceGroupName "resourceGroupName" -Name "cacheName" -Files @("https://mystorageaccount.blob.core.windows.net/mycontainername/blobname?sv=2015-04-05&sr=b&sig=caIwutG2uDa0NZ8mjdNJdgOY8%2F8mhwRuGNdICU%2B0pI4%3D&st=2016-05-27T00%3A00%3A00Z&se=2016-05-28T00%3A00%3A00Z&sp=rwd") -Force

Para exportar un Azure Managed Redis

Puede exportar datos de una instancia de Azure Managed Redis utilizando el cmdlet Export-AzRedisEnterpriseCache.

Para ver una lista de parámetros disponibles y sus descripciones para Export-AzRedisEnterpriseCache, ejecute el siguiente comando.

    PS C:\> Get-Help Export-AzRedisEnterpriseCache -detailed

    NAME
        Export-AzRedisEnterpriseCache

    SYNOPSIS
        Exports data from Azure Managed Redis to a specified container.


    SYNTAX
        Export-AzRedisEnterpriseCache -Name <String> -ResourceGroupName <String> -Prefix <String> -Container <String> [-Format
        <String>] [-PassThru] [<CommonParameters>]


    DESCRIPTION
        The Export-AzRedisEnterpriseCache cmdlet exports data from Azure Managed Redis to a specified container.


    PARAMETERS
        -Name <String>
            The name of the cache.

        -ResourceGroupName <String>
            The name of the resource group that contains the cache.

        -Prefix <String>
            Prefix to use for blob names.

        -Container <String>
            SAS url of container where data should be exported.

        -Format <String>
            Format for the blob.  Currently "rdb" is the only supported, with other formats expected in the future.

        -PassThru
            By default Export-AzRedisEnterpriseCache does not return any value. If the PassThru parameter is provided
            then Export-AzRedisEnterpriseCache returns a boolean value indicating the success of the operation.

        <CommonParameters>
            This cmdlet supports the common parameters: Verbose, Debug,
            ErrorAction, ErrorVariable, WarningAction, WarningVariable,
            OutBuffer, PipelineVariable, and OutVariable. For more information, see
            about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

El siguiente comando exporta datos de una instancia de Azure Managed Redis al contenedor especificado por la uri de SAS.

    PS C:\>Export-AzRedisEnterpriseCache -ResourceGroupName "resourceGroupName" -Name "cacheName" -Prefix "blobprefix"
    -Container "https://mystorageaccount.blob.core.windows.net/mycontainer?sv=2015-04-05&sr=c&sig=HezZtBZ3DURmEGDduauE7
    pvETY4kqlPI8JCNa8ATmaw%3D&st=2016-05-27T00%3A00%3A00Z&se=2016-05-28T00%3A00%3A00Z&sp=rwdl"

Para reiniciar un Azure Managed Redis (versión preliminar)

Puede reiniciar su instancia de Azure Managed Redis (versión preliminar) utilizando el cmdletReset-AzRedisEnterpriseCache.

Para ver una lista de parámetros disponibles y sus descripciones para Reset-AzRedisEnterpriseCache, ejecute el siguiente comando.

    PS C:\> Get-Help Reset-AzRedisEnterpriseCache -detailed

    NAME
        Reset-AzRedisEnterpriseCache

    SYNOPSIS
        Reboot specified node(s) of an Azure Managed Redis instance.


    SYNTAX
        Reset-AzRedisEnterpriseCache -Name <String> -ResourceGroupName <String> -RebootType <String> [-ShardId <Integer>]
        [-Force] [-PassThru] [<CommonParameters>]


    DESCRIPTION
        The Reset-AzRedisEnterpriseCache cmdlet reboots the specified node(s) of an Azure Managed Redis instance.


    PARAMETERS
        -Name <String>
            The name of the cache.

        -ResourceGroupName <String>
            The name of the resource group that contains the cache.

        -RebootType <String>
            Which node to reboot. Possible values are "PrimaryNode", "SecondaryNode", "AllNodes".

        -ShardId <Integer>
            Which shard to reboot when rebooting a cache with clustering enabled.

        -Force
            When the Force parameter is provided, reset will be performed without any confirmation prompts.

        -PassThru
            By default Reset-AzRedisEnterpriseCache does not return any value. If the PassThru parameter is provided
            then Reset-AzRedisEnterpriseCache returns a boolean value indicating the success of the operation.

        <CommonParameters>
            This cmdlet supports the common parameters: Verbose, Debug,
            ErrorAction, ErrorVariable, WarningAction, WarningVariable,
            OutBuffer, PipelineVariable, and OutVariable. For more information, see
            about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

El siguiente comando reinicia ambos nodos de la memoria caché especificada.

    PS C:\>Reset-AzRedisEnterpriseCache -ResourceGroupName "resourceGroupName" -Name "cacheName" -RebootType "AllNodes"
    -Force

Nota:

Azure tiene dos modelos de implementación diferentes que puede usar para crear recursos y trabajar con ellos: Azure Resource Manager y la versión clásica. Este artículo trata sobre el modelo de implementación del Administrador de recursos. Se recomienda usar el modelo de implementación de Resource Manager para las nuevas implementaciones, en lugar del modelo de implementación clásica.

Para más información acerca del modelo de implementación clásico, consulte Azure Resource Manager vs. classic deployment: Understand deployment models and the state of your resources (Implementación clásica frente a implementación con Azure Resource Manager: los modelos de implementación y el estado de los recursos).

Prerequisites

Si ya ha instalado Azure PowerShell, debe tener la versión 1.0.0 (o posterior) de Azure PowerShell. Puede comprobar la versión de Azure PowerShell con este comando en el símbolo del sistema de Azure PowerShell.

    Get-Module Az | format-table version

En primer lugar, tiene que iniciar sesión en Azure con este comando.

    Connect-AzAccount

Especifique la dirección de correo electrónico de la cuenta de Azure y la contraseña en el cuadro de diálogo de inicio de sesión de Microsoft Azure.

A continuación, si tiene varias suscripciones de Azure, deberá establecer la suscripción de Azure. Para ver una lista de las suscripciones actuales, ejecute este comando.

    Get-AzSubscription | sort SubscriptionName | Select SubscriptionName

Para especificar la suscripción, ejecute el siguiente comando. En el ejemplo siguiente, el nombre de la suscripción es ContosoSubscription.

    Select-AzSubscription -SubscriptionName ContosoSubscription

Para poder usar Windows PowerShell con Azure Resource Manager, tiene que comprobar la configuración:

• Windows PowerShell, versión 3.0 o 4.0. Para buscar la versión de Windows PowerShell, escriba:$PSVersionTable y compruebe que el valor de PSVersion es 3.0 o 4.0. Para instalar una versión compatible, consulte Windows Management Framework 3.0.

Para obtener ayuda detallada con cualquier cmdlet que aparezca en este tutorial, use el cmdlet Get-Help.

    Get-Help <cmdlet-name> -Detailed

Por ejemplo, para obtener ayuda para el cmdlet New-AzRedisCache , escriba:

    Get-Help New-AzRedisCache -Detailed

Conexión a otras nubes

De forma predeterminada, el entorno de Azure es AzureCloud, que representa la instancia de nube de Azure global. Para conectarse a otra instancia, use el comando Connect-AzAccount con el conmutador de línea de comandos -Environment o -EnvironmentName con el nombre de entorno o el entorno que quiere.

Para ver la lista de entornos disponibles, ejecute el cmdlet Get-AzEnvironment .

Conexión a la nube de Azure Government

Para conectarse a la nube de Azure Government, utilice uno de los siguientes comandos.

    Connect-AzAccount -EnvironmentName AzureUSGovernment

Or

    Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureUSGovernment)

Para crear una memoria caché en la nube de Azure Government, utilice una de las siguientes ubicaciones.

• USGov Virginia
• USGov Iowa

Para más información acerca de la nube de Azure Government, consulte Microsoft Azure Government y la Guía para desarrolladores de Microsoft Azure Government.

Para conectarse a la nube de Microsoft Azure operado por 21Vianet

Para conectarse a la nube de Azure operado por 21Vianet, use uno de los siguientes comandos.

    Connect-AzAccount -EnvironmentName AzureChinaCloud

Or

    Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureChinaCloud)

Para crear una memoria caché en la nube de Azure operado por 21Vianet, utilice una de las siguientes ubicaciones.

• Este de China
• Norte de China

Conexión a Microsoft Azure Alemania

Para conectarse a Microsoft Azure Alemania, utilice uno de los siguientes comandos.

    Connect-AzAccount -EnvironmentName AzureGermanCloud

Or

    Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureGermanCloud)

Para crear una memoria caché en Microsoft Azure Alemania, use una de las siguientes ubicaciones.

• Centro de Alemania
• Nordeste de Alemania

Para obtener más información acerca de Microsoft Azure Alemania, consulte Microsoft Azure Germany.

Propiedades utilizadas para Azure Cache for Redis PowerShell

La tabla siguiente contiene las propiedades y las descripciones de Azure PowerShell para los parámetros normalmente usados al crear y administrar las instancias de Azure Cache for Redis.

Parámetro	Descripción	Valor predeterminado
Nombre	Nombre de la memoria caché
Location	Ubicación de la memoria caché
ResourceGroupName	Nombre del grupo de recursos en el que se va a crear la memoria caché
Size	El tamaño de la memoria caché. 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	1 GB
ShardCount	El número de particiones para crear durante la creación de una memoria caché premium con clúster habilitado. Los valores válidos son: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10
SKU	Especifica la SKU de la memoria caché. Los valores válidos son: Básico, Estándar y Premium	Estándar
RedisConfiguration	Especifica la configuración de Redis. Para ver detalles sobre cada opción de configuración, consulte la siguiente tabla Propiedades de RedisConfiguration .
EnableNonSslPort	Indica si el puerto no SSL está habilitado.	False
MaxMemoryPolicy	Este parámetro está en desuso; utilice RedisConfiguration en su lugar.
StaticIP	Si hospeda la memoria caché en una red virtual, especifica una dirección IP única en la subred de la memoria caché. Si no se ofrece, elija una para usted en la subred.
Subnet	Si hospeda la memoria caché en una red virtual, especifica el nombre de la subred en la que se va a implementar la memoria caché.
VirtualNetwork	Si hospeda la memoria caché en una red virtual, especifica el identificador de recurso de la red virtual en la que se va a implementar la memoria caché.
KeyType	Especifica la clave de acceso que hay que volver a generar cuando se renueven las claves de acceso. Los valores válidos son: primario, secundario

Propiedades de RedisConfiguration

Propiedad	Descripción	Planes de tarifa
rdb-backup-enabled	Si Persistencia de los datos en Redis está habilitado	Solo Premium
rdb-storage-connection-string	La cadena de conexión a la cuenta de almacenamiento para Persistencia de los datos en Redis	Solo Premium
rdb-backup-frequency	La frecuencia de copia de seguridad de Persistencia de los datos en Redis	Solo Premium
maxmemory-reserved	Configura la memoria reservada para procesos que no están en caché	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 de Keyspace	Estándar y Premium
hash-max-ziplist-entries	Configura la optimización de memoria para tipos de datos agregados pequeños	Estándar y Premium
hash-max-ziplist-value	Configura la optimización de memoria para tipos de datos agregados pequeños	Estándar y Premium
set-max-intset-entries	Configura la optimización de memoria para tipos de datos agregados pequeños	Estándar y Premium
zset-max-ziplist-entries	Configura la optimización de memoria para tipos de datos agregados pequeños	Estándar y Premium
zset-max-ziplist-value	Configura la optimización de memoria para tipos de datos agregados pequeños	Estándar y Premium
databases	Configura el número de bases de datos. Esta propiedad solo se puede configurar al crear la memoria caché.	Estándar y Premium

Creación de una instancia de Azure Redis Cache

Se crean nuevas instancias de Azure Cache for Redis mediante el cmdlet New-AzRedisCache.

Importante

La primera vez que crea una instancia de Azure Cache for Redis en una suscripción con Azure Portal, el portal registra el espacio de nombres Microsoft.Cache para esa suscripción. Si trata de crear la primera instancia de Azure Cache for Redis en una suscripción mediante PowerShell, primero debe registrar ese espacio de nombres mediante el comando siguiente; en caso contrario los cmdlets como New-AzRedisCache y Get-AzRedisCache producirán un error.

Register-AzResourceProvider -ProviderNamespace "Microsoft.Cache"

Para ver una lista de parámetros disponibles y sus descripciones para New-AzRedisCache, ejecute el siguiente comando.

    PS C:\> Get-Help New-AzRedisCache -detailed

    NAME
        New-AzRedisCache

    SYNOPSIS
        Creates a new Azure Cache for Redis.


    SYNTAX
        New-AzRedisCache -Name <String> -ResourceGroupName <String> -Location <String> [-RedisVersion <String>]
        [-Size <String>] [-Sku <String>] [-MaxMemoryPolicy <String>] [-RedisConfiguration <Hashtable>] [-EnableNonSslPort
        <Boolean>] [-ShardCount <Integer>] [-VirtualNetwork <String>] [-Subnet <String>] [-StaticIP <String>]
        [<CommonParameters>]


    DESCRIPTION
        The New-AzRedisCache cmdlet creates a new Azure Cache for Redis.


    PARAMETERS
        -Name <String>
            Name of the Azure Cache for Redis to create.

        -ResourceGroupName <String>
            Name of resource group in which to create the Azure Cache for Redis.

        -Location <String>
            Location in which to create the Azure Cache for Redis.

        -RedisVersion <String>
            RedisVersion is deprecated and will be removed in future release.

        -Size <String>
            Size of the Azure Cache for Redis. The default value is 1GB or C1. Possible values are P1, P2, P3, P4, C0, C1, C2, C3,
            C4, C5, C6, 250MB, 1GB, 2.5GB, 6GB, 13GB, 26GB, 53GB.

        -Sku <String>
            Sku of Azure Cache for Redis. The default value is Standard. Possible values are Basic, Standard and Premium.

        -MaxMemoryPolicy <String>
            The 'MaxMemoryPolicy' setting has been deprecated. Please use 'RedisConfiguration' setting to set
            MaxMemoryPolicy. e.g. -RedisConfiguration @{"maxmemory-policy" = "allkeys-lru"}

        -RedisConfiguration <Hashtable>
            All Redis Configuration Settings. Few possible keys: rdb-backup-enabled, rdb-storage-connection-string,
            rdb-backup-frequency, maxmemory-reserved, maxmemory-policy, notify-keyspace-events, hash-max-ziplist-entries,
            hash-max-ziplist-value, set-max-intset-entries, zset-max-ziplist-entries, zset-max-ziplist-value, databases.

        -EnableNonSslPort <Boolean>
            EnableNonSslPort is used by Azure Cache for Redis. If no value is provided, the default value is false and the
            non-SSL port will be disabled. Possible values are true and false.

        -ShardCount <Integer>
            The number of shards to create on a Premium Cluster Cache.

        -VirtualNetwork <String>
            The exact ARM resource ID of the virtual network to deploy the Azure Cache for Redis in. Example format: /subscriptions/{
            subid}/resourceGroups/{resourceGroupName}/providers/Microsoft.ClassicNetwork/VirtualNetworks/{vnetName}

        -Subnet <String>
            Required when deploying an Azure Cache for Redis inside an existing Azure Virtual Network.

        -StaticIP <String>
            Required when deploying an Azure Cache for Redis inside an existing Azure Virtual Network.

        <CommonParameters>
            This cmdlet supports the common parameters: Verbose, Debug,
            ErrorAction, ErrorVariable, WarningAction, WarningVariable,
            OutBuffer, PipelineVariable, and OutVariable. For more information, see
            about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Para crear una memoria caché con parámetros predeterminados, ejecute el siguiente comando.

    New-AzRedisCache -ResourceGroupName myGroup -Name mycache -Location "North Central US"

ResourceGroupName, Name y Location son parámetros obligatorios, pero el resto son opcionales y tienen valores predeterminados. Ejecutar el comando anterior crea una instancia de SKU Azure Cache for Redis estándar con el nombre, ubicación y grupo de recursos especificados. La instancia tiene un tamaño de 1 GB con el puerto no SSL deshabilitado.

Para crear una memoria caché premium, especifique un tamaño de P1 (6 GB - 60 GB), P2 (13 GB - 130 GB), P3 (26 GB - 260 GB) o P4 (53 GB - 530 GB). Para habilitar la agrupación en clústeres, especifique un número de particiones mediante el parámetro ShardCount . En el ejemplo siguiente se crea una memoria caché prémium P1 con tres particiones. Una memoria caché premium P1 tiene 6 GB de tamaño y, puesto que especificamos tres particiones el tamaño total es de 18 GB (3 x 6 GB).

    New-AzRedisCache -ResourceGroupName myGroup -Name mycache -Location "North Central US" -Sku Premium -Size P1 -ShardCount 3

Para especificar valores para el parámetro RedisConfiguration, incluya los valores dentro de {} como pares de valor o de clave como en @{"maxmemory-policy" = "allkeys-random", "notify-keyspace-events" = "KEA"}. En el ejemplo siguiente se crea una memoria caché estándar de 1 GB con maxmemory-policy allkeys-random y notificaciones de keyspace configuradas con KEA. Para más información, consulte Notificaciones de Keyspace (configuración avanzada) y Directivas de memoria.

    New-AzRedisCache -ResourceGroupName myGroup -Name mycache -Location "North Central US" -RedisConfiguration @{"maxmemory-policy" = "allkeys-random", "notify-keyspace-events" = "KEA"}

Configuración de las bases de datos al crear la memoria caché

El parámetro databases se puede configurar al crear la memoria caché. En el ejemplo siguiente se crea una memoria caché premium P3 (26 GB) con 48 bases de datos mediante el cmdlet New-AzRedisCache.

    New-AzRedisCache -ResourceGroupName myGroup -Name mycache -Location "North Central US" -Sku Premium -Size P3 -RedisConfiguration @{"databases" = "48"}

Para más información sobre la propiedad databases, consulte Configuración predeterminada del servidor Azure Cache for Redis. Para obtener más información sobre la creación de una caché mediante el cmdlet New-AzRedisCache, consulte la sección anterior Crear una instancia de Azure Redis Cache.

Actualización de una instancia de Azure Redis Cache

Las instancias de Azure Cache for Redis se actualizan mediante el cmdlet Set-AzRedisCache.

Para ver una lista de parámetros disponibles y sus descripciones para Set-AzRedisCache, ejecute el siguiente comando.

    PS C:\> Get-Help Set-AzRedisCache -detailed

    NAME
        Set-AzRedisCache

    SYNOPSIS
        Set Azure Cache for Redis updatable parameters.

    SYNTAX
        Set-AzRedisCache -Name <String> -ResourceGroupName <String> [-Size <String>] [-Sku <String>]
        [-MaxMemoryPolicy <String>] [-RedisConfiguration <Hashtable>] [-EnableNonSslPort <Boolean>] [-ShardCount
        <Integer>] [<CommonParameters>]

    DESCRIPTION
        The Set-AzRedisCache cmdlet sets Azure Cache for Redis parameters.

    PARAMETERS
        -Name <String>
            Name of the Azure Cache for Redis to update.

        -ResourceGroupName <String>
            Name of the resource group for the cache.

        -Size <String>
            Size of the Azure Cache for Redis. The default value is 1GB or C1. Possible values are P1, P2, P3, P4, C0, C1, C2, C3,
            C4, C5, C6, 250MB, 1GB, 2.5GB, 6GB, 13GB, 26GB, 53GB.

        -Sku <String>
            Sku of Azure Cache for Redis. The default value is Standard. Possible values are Basic, Standard and Premium.

        -MaxMemoryPolicy <String>
            The 'MaxMemoryPolicy' setting has been deprecated. Please use 'RedisConfiguration' setting to set
            MaxMemoryPolicy. e.g. -RedisConfiguration @{"maxmemory-policy" = "allkeys-lru"}

        -RedisConfiguration <Hashtable>
            All Redis Configuration Settings. Few possible keys: rdb-backup-enabled, rdb-storage-connection-string,
            rdb-backup-frequency, maxmemory-reserved, maxmemory-policy, notify-keyspace-events, hash-max-ziplist-entries,
            hash-max-ziplist-value, set-max-intset-entries, zset-max-ziplist-entries, zset-max-ziplist-value.

        -EnableNonSslPort <Boolean>
            EnableNonSslPort is used by Azure Cache for Redis. The default value is null and no change will be made to the
            currently configured value. Possible values are true and false.

        -ShardCount <Integer>
            The number of shards to create on a Premium Cluster Cache.

        <CommonParameters>
            This cmdlet supports the common parameters: Verbose, Debug,
            ErrorAction, ErrorVariable, WarningAction, WarningVariable,
            OutBuffer, PipelineVariable, and OutVariable. For more information, see
            about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

El cmdlet Set-AzRedisCache puede utilizarse para actualizar propiedades tales como Size, Sku, EnableNonSslPort y los valores de RedisConfiguration.

El comando siguiente actualiza el parámetro maxmemory-policy para la instancia de Azure Cache for Redis denominada myCache.

    Set-AzRedisCache -ResourceGroupName "myGroup" -Name "myCache" -RedisConfiguration @{"maxmemory-policy" = "allkeys-random"}

Escalado de una instancia de Azure Cache for Redis

Se puede usar Set-AzRedisCache para escalar una instancia de Azure Cache for Redis si se modifican las propiedades Size, Sku, o ShardCount.

Nota

El escalado de una caché con PowerShell está sujeto a los mismos límites y directrices que el escalado de una caché desde el Portal de Azure. Puede escalar a un nivel de precios diferente con las siguientes restricciones.

• No se puede escalar desde un plan de tarifa superior a un plan de tarifa inferior.
• No puede cambiar de una memoria caché Premium a una memoria caché Estándar o Básica.
• No puede cambiar de una memoria caché Estándar a una memoria caché Básica.
• Puede cambiar de una memoria caché Básica a una memoria caché Estándar, pero no puede cambiar el tamaño al mismo tiempo. Si necesita un tamaño distinto, puede realizar una operación de escalado posterior hasta el tamaño deseado.
• No puede escalar de una memoria caché Básica directamente a una memoria caché Premium. Debe escalar desde Básica a Estándar en una operación de escalado y, después, desde Estándar a Premium en una operación de escalado posterior.
• No puede escalar desde un tamaño mayor hasta el tamaño C0 (250 MB) .

Para más información, vea How to Scale Azure Cache for Redis (Cómo escalar una instancia de Azure Cache for Redis).

En el ejemplo siguiente se muestra cómo escalar una caché denominada myCache a una caché de 2,5 GB. Este comando funciona con una memoria caché básica o estándar.

    Set-AzRedisCache -ResourceGroupName myGroup -Name myCache -Size 2.5GB

Después de emitir este comando, el estado de la memoria caché se devuelve (de forma similar a una llamada a Get-AzRedisCache). La propiedad ProvisioningState se establece como Scaling.

    PS C:\> Set-AzRedisCache -Name myCache -ResourceGroupName myGroup -Size 2.5GB


    Name               : mycache
    Id                 : /subscriptions/12ad12bd-abdc-2231-a2ed-a2b8b246bbad4/resourceGroups/mygroup/providers/Mi
                         crosoft.Cache/Redis/mycache
    Location           : South Central US
    Type               : Microsoft.Cache/Redis
    HostName           : mycache.redis.cache.windows.net
    Port               : 6379
    ProvisioningState  : Scaling
    SslPort            : 6380
    RedisConfiguration : {[maxmemory-policy, volatile-lru], [maxmemory-reserved, 150], [notify-keyspace-events, KEA],
                         [maxmemory-delta, 150]...}
    EnableNonSslPort   : False
    RedisVersion       : 3.0
    Size               : 1GB
    Sku                : Standard
    ResourceGroupName  : mygroup
    PrimaryKey         : ....
    SecondaryKey       : ....
    VirtualNetwork     :
    Subnet             :
    StaticIP           :
    TenantSettings     : {}
    ShardCount         :

Cuando se complete la operación de escalado, ProvisioningState cambia a Succeeded. Si necesita realizar otra operación de escalado —como cambiar de básica a estándar y, luego, cambiar el tamaño—, tiene que esperar hasta que se complete la operación anterior o recibirá un error similar al siguiente.

    Set-AzRedisCache : Conflict: The resource '...' is not in a stable state, and is currently unable to accept the update request.

Para obtener información acerca de Azure Cache for Redis

Puede recuperar información sobre una caché con el cmdlet Get-AzRedisCache.

Para ver una lista de parámetros disponibles y sus descripciones para Get-AzRedisCache, ejecute el siguiente comando.

    PS C:\> Get-Help Get-AzRedisCache -detailed

    NAME
        Get-AzRedisCache

    SYNOPSIS
        Gets details about a single cache or all caches in the specified resource group or all caches in the current
        subscription.

    SYNTAX
        Get-AzRedisCache [-Name <String>] [-ResourceGroupName <String>] [<CommonParameters>]

    DESCRIPTION
        The Get-AzRedisCache cmdlet gets the details about a cache or caches depending on input parameters. If both
        ResourceGroupName and Name parameters are provided then Get-AzRedisCache will return details about the
        specific cache name provided.

        If only ResourceGroupName is provided than it will return details about all caches in the specified resource group.

        If no parameters are given than it will return details about all caches the current subscription.

    PARAMETERS
        -Name <String>
            The name of the cache. When this parameter is provided along with ResourceGroupName, Get-AzRedisCache
            returns the details for the cache.

        -ResourceGroupName <String>
            The name of the resource group that contains the cache or caches. If ResourceGroupName is provided with Name
            then Get-AzRedisCache returns the details of the cache specified by Name. If only the ResourceGroup
            parameter is provided, then details for all caches in the resource group are returned.

        <CommonParameters>
            This cmdlet supports the common parameters: Verbose, Debug,
            ErrorAction, ErrorVariable, WarningAction, WarningVariable,
            OutBuffer, PipelineVariable, and OutVariable. For more information, see
            about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Para devolver información sobre todas las cachés de la suscripción actual, ejecute Get-AzRedisCache sin ningún parámetro.

    Get-AzRedisCache

Para devolver información sobre todas las cachés de un grupo de recursos específico, ejecute Get-AzRedisCache con el parámetro ResourceGroupName.

    Get-AzRedisCache -ResourceGroupName myGroup

Para devolver información sobre una caché específica, ejecute Get-AzRedisCache con el parámetro Name que contiene el nombre de la caché y el parámetro ResourceGroupName con el grupo de recursos que contiene esa caché.

    PS C:\> Get-AzRedisCache -Name myCache -ResourceGroupName myGroup

    Name               : mycache
    Id                 : /subscriptions/12ad12bd-abdc-2231-a2ed-a2b8b246bbad4/resourceGroups/myGroup/providers/Mi
                         crosoft.Cache/Redis/mycache
    Location           : South Central US
    Type               : Microsoft.Cache/Redis
    HostName           : mycache.redis.cache.windows.net
    Port               : 6379
    ProvisioningState  : Succeeded
    SslPort            : 6380
    RedisConfiguration : {[maxmemory-policy, volatile-lru], [maxmemory-reserved, 62], [notify-keyspace-events, KEA],
                         [maxclients, 1000]...}
    EnableNonSslPort   : False
    RedisVersion       : 3.0
    Size               : 1GB
    Sku                : Standard
    ResourceGroupName  : myGroup
    VirtualNetwork     :
    Subnet             :
    StaticIP           :
    TenantSettings     : {}
    ShardCount         :

Recuperación de las teclas de acceso de una instancia de Azure Cache for Redis.

Para recuperar las claves de acceso de la caché, puede usar el cmdlet Get-AzRedisCacheKey.

Para ver una lista de parámetros disponibles y sus descripciones para Get-AzRedisCacheKey, ejecute el siguiente comando.

    PS C:\> Get-Help Get-AzRedisCacheKey -detailed

    NAME
        Get-AzRedisCacheKey

    SYNOPSIS
        Gets the accesskeys for the specified Azure Cache for Redis.


    SYNTAX
        Get-AzRedisCacheKey -Name <String> -ResourceGroupName <String> [<CommonParameters>]

    DESCRIPTION
        The Get-AzRedisCacheKey cmdlet gets the access keys for the specified cache.

    PARAMETERS
        -Name <String>
            Name of the Azure Cache for Redis.

        -ResourceGroupName <String>
            Name of the resource group for the cache.

        <CommonParameters>
            This cmdlet supports the common parameters: Verbose, Debug,
            ErrorAction, ErrorVariable, WarningAction, WarningVariable,
            OutBuffer, PipelineVariable, and OutVariable. For more information, see
            about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Para recuperar las claves de la caché, llame al cmdlet Get-AzRedisCacheKey y pase el nombre de la memoria caché y el nombre del grupo de recursos que contiene la memoria caché.

    PS C:\> Get-AzRedisCacheKey -Name myCache -ResourceGroupName myGroup

    PrimaryKey   : b2wdt43sfetlju4hfbryfnregrd9wgIcc6IA3zAO1lY=
    SecondaryKey : ABhfB757JgjIgt785JgKH9865eifmekfnn649303JKL=

Generación de las teclas de acceso para la instancia de Azure Cache for Redis.

Para recuperar las claves de acceso de la caché, puede usar el cmdlet Get-AzRedisCacheKey.

Para ver una lista de parámetros disponibles y sus descripciones para New-AzRedisCacheKey, ejecute el siguiente comando.

    PS C:\> Get-Help New-AzRedisCacheKey -detailed

    NAME
        New-AzRedisCacheKey

    SYNOPSIS
        Regenerates the access key of an Azure Cache for Redis.

    SYNTAX
        New-AzRedisCacheKey -Name <String> -ResourceGroupName <String> -KeyType <String> [-Force] [<CommonParameters>]

    DESCRIPTION
        The New-AzRedisCacheKey cmdlet regenerate the access key of an Azure Cache for Redis.

    PARAMETERS
        -Name <String>
            Name of the Azure Cache for Redis.

        -ResourceGroupName <String>
            Name of the resource group for the cache.

        -KeyType <String>
            Specifies whether to regenerate the primary or secondary access key. Possible values are Primary or Secondary.

        -Force
            When the Force parameter is provided, the specified access key is regenerated without any confirmation prompts.

        <CommonParameters>
            This cmdlet supports the common parameters: Verbose, Debug,
            ErrorAction, ErrorVariable, WarningAction, WarningVariable,
            OutBuffer, PipelineVariable, and OutVariable. For more information, see
            about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Para regenerar la clave principal o secundaria de la caché, llame al cmdlet New-AzRedisCacheKey y pase el nombre, el grupo de recursos y especifique Primary o Secondary para el parámetro KeyType. En el ejemplo siguiente, se regenera la clave de acceso secundaria de una memoria caché.

    PS C:\> New-AzRedisCacheKey -Name myCache -ResourceGroupName myGroup -KeyType Secondary

    Confirm
    Are you sure you want to regenerate Secondary key for Azure Cache for Redis 'myCache'?
    [Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"): Y


    PrimaryKey   : b2wdt43sfetlju4hfbryfnregrd9wgIcc6IA3zAO1lY=
    SecondaryKey : c53hj3kh4jhHjPJk8l0jji785JgKH9865eifmekfnn6=

Eliminación de una instancia de Azure Redis Cache

Para eliminar una instancia de Azure Cache for Redis, use el cmdlet Remove-AzRedisCache.

Para ver una lista de parámetros disponibles y sus descripciones para Remove-AzRedisCache, ejecute el siguiente comando.

    PS C:\> Get-Help Remove-AzRedisCache -detailed

    NAME
        Remove-AzRedisCache

    SYNOPSIS
        Remove Azure Cache for Redis if exists.

    SYNTAX
        Remove-AzRedisCache -Name <String> -ResourceGroupName <String> [-Force] [-PassThru] [<CommonParameters>

    DESCRIPTION
        The Remove-AzRedisCache cmdlet removes an Azure Cache for Redis if it exists.

    PARAMETERS
        -Name <String>
            Name of the Azure Cache for Redis to remove.

        -ResourceGroupName <String>
            Name of the resource group of the cache to remove.

        -Force
            When the Force parameter is provided, the cache is removed without any confirmation prompts.

        -PassThru
            By default Remove-AzRedisCache removes the cache and does not return any value. If the PassThru par
            is provided then Remove-AzRedisCache returns a boolean value indicating the success of the operatio

        <CommonParameters>
            This cmdlet supports the common parameters: Verbose, Debug,
            ErrorAction, ErrorVariable, WarningAction, WarningVariable,
            OutBuffer, PipelineVariable, and OutVariable. For more information, see
            about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

En el ejemplo siguiente, se quita la memoria caché denominada myCache .

    PS C:\> Remove-AzRedisCache -Name myCache -ResourceGroupName myGroup

    Confirm
    Are you sure you want to remove Azure Cache for Redis 'myCache'?
    [Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"): Y

Importación de una instancia de Azure Cache for Redis

Puede importar datos a una instancia de Azure Cache for Redis mediante el cmdlet Import-AzRedisCache.

Importante

La importación y exportación solo está disponible para las memorias caché del nivel Prémium. Para más información e instrucciones sobre Import/Export, consulte Importación y exportación de datos en Azure Cache for Redis.

Para ver una lista de parámetros disponibles y sus descripciones para Import-AzRedisCache, ejecute el siguiente comando.

    PS C:\> Get-Help Import-AzRedisCache -detailed

    NAME
        Import-AzRedisCache

    SYNOPSIS
        Import data from blobs to Azure Cache for Redis.


    SYNTAX
        Import-AzRedisCache -Name <String> -ResourceGroupName <String> -Files <String[]> [-Format <String>] [-Force]
        [-PassThru] [<CommonParameters>]


    DESCRIPTION
        The Import-AzRedisCache cmdlet imports data from the specified blobs into Azure Cache for Redis.


    PARAMETERS
        -Name <String>
            The name of the cache.

        -ResourceGroupName <String>
            The name of the resource group that contains the cache.

        -Files <String[]>
            SAS urls of blobs whose content should be imported into the cache.

        -Format <String>
            Format for the blob.  Currently "rdb" is the only supported, with other formats expected in the future.

        -Force
            When the Force parameter is provided, import will be performed without any confirmation prompts.

        -PassThru
            By default Import-AzRedisCache imports data in cache and does not return any value. If the PassThru
            parameter is provided then Import-AzRedisCache returns a boolean value indicating the success of the
            operation.

        <CommonParameters>
            This cmdlet supports the common parameters: Verbose, Debug,
            ErrorAction, ErrorVariable, WarningAction, WarningVariable,
            OutBuffer, PipelineVariable, and OutVariable. For more information, see
            about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

El siguiente comando importa datos desde el blob especificado por el identificador URI de SAS de Azure Cache for Redis.

    PS C:\>Import-AzRedisCache -ResourceGroupName "resourceGroupName" -Name "cacheName" -Files @("https://mystorageaccount.blob.core.windows.net/mycontainername/blobname?sv=2015-04-05&sr=b&sig=caIwutG2uDa0NZ8mjdNJdgOY8%2F8mhwRuGNdICU%2B0pI4%3D&st=2016-05-27T00%3A00%3A00Z&se=2016-05-28T00%3A00%3A00Z&sp=rwd") -Force

Exportación de una instancia de Azure Cache for Redis

Puede exportar datos a una instancia de Azure Cache for Redis mediante el cmdlet Export-AzRedisCache.

Importante

La importación y exportación solo está disponible para las memorias caché del nivel Prémium. Para más información e instrucciones sobre Import/Export, consulte Importación y exportación de datos en Azure Cache for Redis.

Para ver una lista de parámetros disponibles y sus descripciones para Export-AzRedisCache, ejecute el siguiente comando.

    PS C:\> Get-Help Export-AzRedisCache -detailed

    NAME
        Export-AzRedisCache

    SYNOPSIS
        Exports data from Azure Cache for Redis to a specified container.


    SYNTAX
        Export-AzRedisCache -Name <String> -ResourceGroupName <String> -Prefix <String> -Container <String> [-Format
        <String>] [-PassThru] [<CommonParameters>]


    DESCRIPTION
        The Export-AzRedisCache cmdlet exports data from Azure Cache for Redis to a specified container.


    PARAMETERS
        -Name <String>
            The name of the cache.

        -ResourceGroupName <String>
            The name of the resource group that contains the cache.

        -Prefix <String>
            Prefix to use for blob names.

        -Container <String>
            SAS url of container where data should be exported.

        -Format <String>
            Format for the blob.  Currently "rdb" is the only supported, with other formats expected in the future.

        -PassThru
            By default Export-AzRedisCache does not return any value. If the PassThru parameter is provided
            then Export-AzRedisCache returns a boolean value indicating the success of the operation.

        <CommonParameters>
            This cmdlet supports the common parameters: Verbose, Debug,
            ErrorAction, ErrorVariable, WarningAction, WarningVariable,
            OutBuffer, PipelineVariable, and OutVariable. For more information, see
            about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

El siguiente comando exporta los datos desde una instancia de Azure Cache for Redis en el contenedor especificado por el identificador URI de SAS.

    PS C:\>Export-AzRedisCache -ResourceGroupName "resourceGroupName" -Name "cacheName" -Prefix "blobprefix"
    -Container "https://mystorageaccount.blob.core.windows.net/mycontainer?sv=2015-04-05&sr=c&sig=HezZtBZ3DURmEGDduauE7
    pvETY4kqlPI8JCNa8ATmaw%3D&st=2016-05-27T00%3A00%3A00Z&se=2016-05-28T00%3A00%3A00Z&sp=rwdl"

Reinicio de una instancia de Azure Cache for Redis

Puede reiniciar la instancia de Azure Cache for Redis mediante el cmdlet Reset-AzRedisCache.

Importante

El reinicio solo está disponible para las memorias caché de nivel Básico, Estándar y Premium. Para más información acerca de cómo reiniciar la caché, consulte Administración de caché: reinicio.

Para ver una lista de parámetros disponibles y sus descripciones para Reset-AzRedisCache, ejecute el siguiente comando.

    PS C:\> Get-Help Reset-AzRedisCache -detailed

    NAME
        Reset-AzRedisCache

    SYNOPSIS
        Reboot specified node(s) of an Azure Cache for Redis instance.


    SYNTAX
        Reset-AzRedisCache -Name <String> -ResourceGroupName <String> -RebootType <String> [-ShardId <Integer>]
        [-Force] [-PassThru] [<CommonParameters>]


    DESCRIPTION
        The Reset-AzRedisCache cmdlet reboots the specified node(s) of an Azure Cache for Redis instance.


    PARAMETERS
        -Name <String>
            The name of the cache.

        -ResourceGroupName <String>
            The name of the resource group that contains the cache.

        -RebootType <String>
            Which node to reboot. Possible values are "PrimaryNode", "SecondaryNode", "AllNodes".

        -ShardId <Integer>
            Which shard to reboot when rebooting a premium cache with clustering enabled.

        -Force
            When the Force parameter is provided, reset will be performed without any confirmation prompts.

        -PassThru
            By default Reset-AzRedisCache does not return any value. If the PassThru parameter is provided
            then Reset-AzRedisCache returns a boolean value indicating the success of the operation.

        <CommonParameters>
            This cmdlet supports the common parameters: Verbose, Debug,
            ErrorAction, ErrorVariable, WarningAction, WarningVariable,
            OutBuffer, PipelineVariable, and OutVariable. For more information, see
            about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

El siguiente comando reinicia ambos nodos de la memoria caché especificada.

    PS C:\>Reset-AzRedisCache -ResourceGroupName "resourceGroupName" -Name "cacheName" -RebootType "AllNodes"
    -Force

Pasos siguientes

Para obtener más información acerca de Windows PowerShell con Azure, consulte los siguientes recursos:

• Documentación de cmdlet de Azure Cache for Redis en MSDN
• Cmdlets de Azure Resource Manager: obtenga información acerca del uso de los cmdlets en el módulo de Azure Resource Manager.
• Uso de grupos de recursos para administrar los recursos de Azure: obtenga información sobre la creación y administración de grupos de recursos en el Portal de Azure.
• Blog de Azure: obtenga información acerca de las nuevas características de Azure.
• Blog de Windows PowerShell: obtenga información acerca de las nuevas características de Windows PowerShell.
• Blog ¡Hola, chicos del scripting!: Obtenga sugerencias y trucos del mundo real de la comunidad de Windows PowerShell.