Administración de Azure Cache for Redis con Azure PowerShell

  • Artículo

En este artículo se muestra cómo crear, actualizar y escalar las instancias de Azure Cache for Redis. En el artículo también se muestra cómo regenerar las claves de acceso y cómo ver información sobre las memorias caché. Para obtener una lista completa de cmdlets de Azure Cache for Redis PowerShell, consulte Azure Cache for Redis cmdlets.

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: