Compartilhar via


Gerenciar o Redis do Azure com o Azure PowerShell

Redis Gerenciado do Azure

  1. Para criar uma instância do Redis Gerenciado do Azure (versão prévia), entre no portal do Azure e selecione Criar um recurso.

  2. Na página Novo, digite Cache do Azure para Redis na caixa de pesquisa.

  3. Na página Novo Cache Redis, defina as configurações para o novo cache.

    Configuração Escolher um valor Descrição
    Assinatura Clique na lista suspensa e selecione sua assinatura. A assinatura sob a qual essa nova instância do Redis Gerenciado do Azure será criada.
    Grupo de recursos Clique na lista suspensa e selecione um grupo de recursos ou selecione Criar e insira um novo nome de grupo de recursos. Nome do grupo de recursos no qual o cache e outros recursos serão criados. Ao colocar todos os seus recursos de aplicativos em um só grupo de recursos, você pode gerenciá-los ou excluí-los juntos com facilidade.
    Nome DNS Insira um nome que seja exclusivo na região. O nome do cache deve conter de 1 a 63 caracteres quando combinado com o nome da região do cache que contém apenas números, letras ou hifens. (Se o nome do cache tiver menos de 45 caracteres, ele deverá funcionar em todas as regiões disponíveis no momento.) O nome precisa começar e terminar com um número ou uma letra e não pode conter hifens consecutivos. O nome do host da instância de cache é \<DNS name\>.\<Azure region\>.redis.azure.net.
    Localidade Clique na lista suspensa e selecione uma localização. O Redis Gerenciado do Azure está disponível em regiões selecionadas do Azure.
    Tipo de cache Selecione o nível de desempenho e o tamanho do cache no menu suspenso. O nível determina o desempenho da instância do Redis, enquanto o tamanho do cache determina a memória disponível para armazenar os dados. Para obter orientação sobre como escolher o nível de desempenho adequado, consulte Escolher o nível correto

    Captura de tela mostrando a guia Noções básicas do Redis Gerenciado do Azure.

  4. Selecione Avançar: Rede e selecione um ponto de extremidade privado ou público.

  5. Selecione Próximo: Avançado.

    Configure os módulos do Redis que você deseja adicionar à instância.

    Por padrão, para um cache gerenciado novo:

    • O Microsoft Entra ID está habilitado.
    • Autenticação de Chaves de Acesso está desabilitada por motivos de segurança.

    Importante

    Para otimizar a segurança, recomendamos usar o Microsoft Entra ID com identidades gerenciadas a fim de autorizar solicitações no cache, se possível. A autorização usando o Microsoft Entra ID e identidades gerenciadas oferece segurança superior e facilidade de uso em relação à autorização de chave de acesso compartilhada. Para saber como usar as identidades gerenciadas com o cache, confira Usar o Microsoft Entra ID para autenticação de cache.

    Defina a política de clustering como Enterprise para um cache não clusterizado ou para o OSS para um cache clusterizado. Para obter mais informações sobre como escolher Política de cluster, veja Política de cluster.

    Captura de tela que mostra a guia Avançado do Redis gerenciado do Azure.

    Se você estiver usando Replicação geográfica ativa, ela deverá ser configurada durante a criação. Para obter mais informações, confira Configurar a replicação geográfica ativa para instâncias do Azure Managed Redis.

    Importante

    Não é possível alterar a política de cluster de uma instância do Redis gerenciado do Azure (versão prévia) depois de criá-la. Caso esteja usando o RediSearch, a política de cluster do Enterprise será necessária e NoEviction será a única política de remoção com suporte.

    Importante

    Caso esteja usando essa instância de cache em um grupo de replicação geográfica, as políticas de remoção não poderão ser alteradas após a criação da instância. Lembre-se saber sobre as políticas de remoção dos nós primários antes de criar o cache. Para saber mais sobre a replicação geográfica ativa, confira Pré-requisitos da replicação geográfica ativa.

    Importante

    Não é possível alterar módulos depois de criar uma instância de cache. Os módulos devem ser habilitados no momento em que você criar uma instância de Cache do Azure para Redis. Não há nenhuma opção para habilitar a configuração de um módulo depois de criar um cache.

  6. Selecione Avançar: Marcas e ignore.

  7. Selecione Avançar: Revisar + criar.

  8. Examine as configurações e selecione Criar.

    A criação da instância do Redis leva vários minutos. O progresso pode ser monitorado na página Visão geral do Redis gerenciado do Azure. Quando o Status for mostrado como Em execução, o cache estará pronto para uso.

Cache do Azure para Redis

  1. Para criar um cache, entre no portal do Azure. No menu do portal, selecione Criar recurso.

    Captura de tela que mostra a opção Criar recurso realçada no painel de navegação esquerdo no portal do Azure.

  2. Na página Introdução, insira Cache do Azure para Redis na barra de pesquisa. Nos resultados da pesquisa, localize Cache do Azure para Redis e selecione Criar.

    Captura de tela que mostra o Azure Marketplace com o Cache do Azure para Redis na caixa de pesquisa e o botão

  3. No painel Novo Cache Redis, na guia Básico, defina as seguintes configurações para o cache:

    Configuração Ação Descrição
    Assinatura Selecione sua assinatura do Azure. A assinatura a ser usada para criar a instância do Cache do Azure para Redis.
    Grupo de recursos Selecione um grupo de recursos ou selecione Criar novo e insira um novo nome de grupo de recursos. Um nome para o grupo de recursos em que você criará o cache e outros recursos. Ao colocar todos os seus recursos de aplicativos em um só grupo de recursos, você pode gerenciá-los ou excluí-los juntos com facilidade.
    Nome DNS Insira um nome exclusivo. O nome do cache precisa ser uma cadeia de caracteres com 1 a 63 caracteres contendo somente números, letras e hifens. O nome deve começar e terminar com um número ou uma letra e não pode conter hifens consecutivos. O nome do host da instância de cache é \<DNS name>.redis.cache.windows.net.
    Localidade Selecione uma localização. Uma região do Azure que esteja próxima a outros serviços que usam o cache.
    Cache SKU Selecione um SKU. O SKU determina os parâmetros de tamanho, desempenho e recurso disponíveis para o cache. Para obter mais informações, consulte Visão geral do Cache do Azure para Redis.
    Tamanho do cache Selecione um tamanho de cache. Para obter mais informações, consulte Visão geral do Cache do Azure para Redis.
  4. Selecione a guia Rede ou clique em Avançar: rede.

  5. Na guia Rede, selecione um método de conectividade a ser usado para o cache.

  6. Selecione a guia Avançado ou clique em Avançar: avançado.

  7. No painel Avançado, verifique ou selecione um método de autenticação com base nas seguintes informações:

    Captura de tela que mostra o painel Avançado e as opções disponíveis para seleção.

    • Por padrão, para um novo cache Básico, Standard ou Premium, a Autenticação do Microsoft Entra está habilitada e a Autenticação de Chaves de Acesso está desabilitada.
    • Para caches Básico ou Standard, é possível escolher a seleção de uma porta não TLS.
    • Para caches Standard e Premium, é possível optar por habilitar zonas de disponibilidade. Não é possível desabilitar zonas de disponibilidade após a criação do cache.
    • Para um cache Premium, defina as configurações para porta não TLS, clustering, identidade gerenciada e persistência de dados.

    Importante

    Para otimizar a segurança, recomendamos usar o Microsoft Entra ID com identidades gerenciadas a fim de autorizar solicitações no cache, se possível. A autorização usando o Microsoft Entra ID e identidades gerenciadas oferece segurança superior e facilidade de uso em relação à autorização de chave de acesso compartilhada. Para saber como usar as identidades gerenciadas com o cache, confira Usar o Microsoft Entra ID para autenticação de cache.

  8. (Opcional) Selecione a guia Categorias ou clique em Avançar: categorias.

  9. (Opcional) Na guia Categorias, insira um nome e um valor de categoria se você quiser categorizar o recurso de cache.

  10. Selecione o botão Revisar + criar.

    Na guia Examinar + criar, o Azure valida a configuração automaticamente.

  11. Depois que a mensagem em verde Validação aprovada for exibida, selecione Criar.

Uma nova implantação de cache ocorre durante diversos minutos. Você pode monitorar o progresso da implantação no painel Visão Geral do Cache do Azure para Redis. Quando o Status mostrar Em execução, o cache estará pronto para uso.

Este artigo mostra como criar, atualizar e escalar suas instâncias do Redis do Azure.

Observação

O Azure tem dois modelos de implantação diferentes que você pode usar para criar e trabalhar com recursos: Azure Resource Manager e clássico. Este artigo abordará o uso do modelo de implantação do Resource Manager. Recomendamos usar o modelo de implantação do Resource Manager para executar novas implantações em vez do modelo clássico de implantação.

Para saber mais sobre o modelo de implantação clássica, consulte Azure Resource Manager versus implantação clássica: compreenda os modelos de implantação e o estado de seus recursos.

Pré-requisitos

Se você já instalou o Azure PowerShell, você deve ter o Azure PowerShell versão 12.4.0 ou posterior. Verifique a versão do Azure PowerShell com este comando no prompt de comando do Azure PowerShell.

    Get-Module Az | format-table version

Primeiro, entre no Azure com este comando.

    Connect-AzAccount

Especifique o endereço de email de sua conta do Azure e sua senha na caixa de diálogo de logon do Microsoft Azure.

Em seguida, se tiver várias assinaturas do Azure, você precisará definir sua assinatura do Azure. Para ver uma lista de suas assinaturas atuais, execute este comando.

    Get-AzSubscription | sort SubscriptionName | Select SubscriptionName

Para especificar a assinatura, execute o comando a seguir. No exemplo a seguir, o nome da assinatura é ContosoSubscription.

    Select-AzSubscription -SubscriptionName ContosoSubscription

Para poder usar o Windows PowerShell com o Azure Resource Manager, você precisa verificar sua configuração:

  • Windows PowerShell, versão 3.0 ou 4.0. Para encontrar a versão do Windows PowerShell, digite:$PSVersionTable e verifique se o valor de PSVersion é 3.0 ou 4.0. Para instalar uma versão compatível, consulte Windows Management Framework 3.0.

Para obter ajuda detalhada sobre qualquer cmdlet que você vir neste tutorial, use o cmdlet Get-Help.

    Get-Help <cmdlet-name> -Detailed

Por exemplo, para obter ajuda para o cmdlet New-AzRedisEnterpriseCache , digite:

    Get-Help New-AzRedisEnterpriseCache -Detailed

Como se conectar a outras nuvens

Por padrão, o ambiente do Azure é AzureCloud, que representa a instância de nuvem global do Azure. Para se conectar a uma instância diferente, use o comando Connect-AzAccount com a opção de linha de comando -Environment ou -EnvironmentName com o ambiente ou o nome do ambiente que você deseja.

Para ver a lista de ambientes disponíveis, execute o cmdlet Get-AzEnvironment .

Para se conectar à Nuvem do Azure Government

Para se conectar à Nuvem do Azure Government, use um dos comandos a seguir.

    Connect-AzAccount -EnvironmentName AzureUSGovernment

Ou

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

Para criar um cache na Nuvem do Azure Government, use um dos locais a seguir.

  • USGov Virginia
  • USGov Iowa

Para saber mais sobre a Nuvem do Azure Government, confira Microsoft Azure Governamental e Guia do Desenvolvedor do Microsoft Azure Governamental.

Para se conectar ao Microsoft Azure operado pela nuvem da 21Vianet

Para se conectar à nuvem do Azure operado pela 21Vianet, use um dos comandos a seguir.

    Connect-AzAccount -EnvironmentName AzureChinaCloud

Ou

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

Para criar um cache na Nuvem do Azure operado pela 21Vianet, use um dos locais a seguir.

  • Leste da China
  • Norte da China

Para se conectar ao Microsoft Azure Alemanha

Para se conectar ao Microsoft Azure Alemanha, use um dos comandos a seguir.

    Connect-AzAccount -EnvironmentName AzureGermanCloud

Ou

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

Para criar um cache no Microsoft Azure Alemanha, use uma das localizações a seguir.

  • Alemanha Central
  • Nordeste da Alemanha

Para obter mais informações sobre o Microsoft Azure Alemanha, consulte Microsoft Azure Alemanha.

Parâmetros e propriedades do PowerShell do Redis Gerenciado do Azure

Para obter uma lista de todos os parâmetros e propriedades do PowerShell do Redis Gerenciado do Azure, consulte New-AzRedisEnterpriseCache.

Para criar um Redis Gerenciado do Azure

Novas instâncias do Redis Gerenciadas do Azure são criadas usando o cmdlet New-AzRedisEnterpriseCache.

Importante

Na primeira vez que você cria um Redis Gerenciado do Azure em uma assinatura usando o portal do Azure, o portal registra o namespace Microsoft.Cache para a assinatura. Se você tentar criar o Redis Gerenciado do Azure primeiro em uma assinatura usando o PowerShell, deve primeiro registrar esse namespace usando o comando a seguir; caso contrário, cmdlets como New-AzRedisEnterpriseCache e Get-AzRedisEnterpriseCache falharão.

Register-AzResourceProvider -ProviderNamespace "Microsoft.Cache"

Para ver uma lista dos parâmetros disponíveis e suas descrições para New-AzRedisEnterpriseCache, execute o seguinte 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 criar um cache com parâmetros padrão, execute o comando a seguir.

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

ResourceGroupName, Name e Location são parâmetros obrigatórios, mas os restantes são opcionais e têm valores padrão. Executar o comando anterior cria uma instância do Redis Gerenciado do Azure com o nome, local e grupo de recursos especificados. A instância tem 1 GB de tamanho, com a porta não SSL desativada.

Para habilitar o clustering, especifique uma contagem de fragmentos usando o parâmetro ShardCount .

Para especificar valores para o parâmetro RedisConfiguration, coloque os valores dentro de {} como pares de chave/valor como @{"maxmemory-policy" = "allkeys-random", "notify-keyspace-events" = "KEA"}. O exemplo a seguir cria um cache de 1 GB com as allkeys-random notificações maxmemory-policy e keyspace configuradas com KEA. Para obter mais informações, consulte Notificações de keyspace (configurações avançadas) e Políticas de memória.

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

Para configurar a definição dos bancos de dados durante a criação do cache

A configuração databases pode ser definida somente durante a criação do cache. O exemplo a seguir cria um cache com 48 bancos de dados usando o cmdlet New-AzRedisEnterpriseCache.

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

Para saber mais sobre a propriedade databases, consulte Configuração do servidor do Redis Gerenciado do Azure. Para saber mais sobre como criar um cache usando o cmdlet New-AzRedisEnterpriseCache, confira a seção anterior Para criar um Redis Gerenciado do Azure.

Para atualizar um Redis Gerenciado do Azure

As instâncias do Redis Gerenciado do Azure são atualizadas usando o cmdlet [Set-AzRedisEnterpriseCache].

Para ver uma lista dos parâmetros disponíveis e suas descrições para Set-AzRedisEnterpriseCache, execute o seguinte 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).

O cmdlet Set-AzRedisEnterpriseCache pode ser usado para atualizar propriedades como os valores Sku, EnableNonSslPort e RedisConfiguration.

O comando a seguir atualiza a maxmemory-policy do Redis Gerenciado do Azure chamada myCache.

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

Para saber mais sobre um Redis Gerenciado do Azure

Você pode recuperar informações sobre um cache usando o cmdlet Get-AzRedisEnterpriseCache.

Para ver uma lista dos parâmetros disponíveis e suas descrições para Get-AzRedisEnterpriseCache, execute o seguinte 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 retornar informações sobre todos os caches na assinatura atual, execute Get-AzRedisEnterpriseCache sem parâmetros.

    Get-AzRedisEnterpriseCache

Para retornar informações sobre todos os caches em um grupo de recursos específico, execute Get-AzRedisEnterpriseCache com o parâmetro ResourceGroupName.

    Get-AzRedisEnterpriseCache -ResourceGroupName myGroup

Para retornar informações sobre um cache específico, execute Get-AzRedisEnterpriseCache com o parâmetro Name que contém o nome do cache e o parâmetro ResourceGroupName com o grupo de recursos que contém esse cache.

    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 as chaves de acesso de um Redis Gerenciado do Azure

Para recuperar as chaves de acesso para seu cache, você pode usar o cmdlet Get-AzRedisEnterpriseCacheKey.

Para ver uma lista dos parâmetros disponíveis e suas descrições para Get-AzRedisEnterpriseCacheKey, execute o seguinte 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 as chaves para seu cache, chame o cmdlet Get-AzRedisEnterpriseCacheKey e passe no nome de seu cache o nome do grupo de recursos que contém o cache.

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

    PrimaryKey   : b2wdt43sfetlju4hfbryfnregrd9wgIcc6IA3zAO1lY=
    SecondaryKey : ABhfB757JgjIgt785JgKH9865eifmekfnn649303JKL=

Para regenerar as chaves de acesso de seu Redis Gerenciado do Azure

Para regenerar as chaves de acesso para seu cache, você pode usar o cmdlet New-AzRedisEnterpriseCacheKey.

Para ver uma lista dos parâmetros disponíveis e suas descrições para New-AzRedisEnterpriseCacheKey, execute o seguinte 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 a chave primária ou secundária para seu cache, chame o cmdlet New-AzRedisEnterpriseCacheKey, passe no nome o grupo de recursos e especifique Primary ou Secondary para o parâmetro KeyType. No exemplo a seguir, a chave de acesso secundária para um cache é regenerada.

    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 excluir um Redis Gerenciado do Azure

Para excluir um Redis Gerenciado do Azure, use o cmdlet Remove-AzRedisEnterpriseCache.

Para ver uma lista dos parâmetros disponíveis e suas descrições para Remove-AzRedisEnterpriseCache, execute o seguinte 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).

No exemplo a seguir, o cache denominado myCache é removido.

    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 um Redis Gerenciado do Azure

Você pode importar dados para uma instância de Redis Gerenciado do Azure usando o cmdlet Import-AzRedisEnterpriseCache.

Para ver uma lista dos parâmetros disponíveis e suas descrições para Import-AzRedisEnterpriseCache, execute o seguinte 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).

O comando a seguir importa dados do blob especificado pelo URI de SAS no Redis Gerenciado do Azure.

    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 um Redis Gerenciado do Azure

Você pode exportar dados de uma instância de Redis Gerenciado do Azure usando o cmdlet Export-AzRedisEnterpriseCache.

Para ver uma lista dos parâmetros disponíveis e suas descrições para Export-AzRedisEnterpriseCache, execute o seguinte 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).

O comando a seguir exporta dados de uma instância de Redis Gerenciado do Azure para o contêiner especificado pelo 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 o Redis Gerenciado do Azure (versão prévia)

Você pode reiniciar a instância do Redis Gerenciado do Azure usando o cmdlet Reset-AzRedisEnterpriseCache.

Para ver uma lista dos parâmetros disponíveis e suas descrições para Reset-AzRedisEnterpriseCache, execute o seguinte 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).

O comando a seguir reinicializa ambos os nós do cache especificado.

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

Observação

O Azure tem dois modelos de implantação diferentes que você pode usar para criar e trabalhar com recursos: Azure Resource Manager e clássico. Este artigo abordará o uso do modelo de implantação do Resource Manager. Recomendamos usar o modelo de implantação do Resource Manager para executar novas implantações em vez do modelo clássico de implantação.

Para saber mais sobre o modelo de implantação clássica, consulte Azure Resource Manager versus implantação clássica: compreenda os modelos de implantação e o estado de seus recursos.

Pré-requisitos

Se você já instalou o Azure PowerShell, você deve ter o Azure PowerShell versão 1.0.0 ou posterior. Verifique a versão do Azure PowerShell com este comando no prompt de comando do Azure PowerShell.

    Get-Module Az | format-table version

Primeiro, entre no Azure com este comando.

    Connect-AzAccount

Especifique o endereço de email de sua conta do Azure e sua senha na caixa de diálogo de logon do Microsoft Azure.

Em seguida, se tiver várias assinaturas do Azure, você precisará definir sua assinatura do Azure. Para ver uma lista de suas assinaturas atuais, execute este comando.

    Get-AzSubscription | sort SubscriptionName | Select SubscriptionName

Para especificar a assinatura, execute o comando a seguir. No exemplo a seguir, o nome da assinatura é ContosoSubscription.

    Select-AzSubscription -SubscriptionName ContosoSubscription

Para poder usar o Windows PowerShell com o Azure Resource Manager, você precisa verificar sua configuração:

  • Windows PowerShell, versão 3.0 ou 4.0. Para encontrar a versão do Windows PowerShell, digite:$PSVersionTable e verifique se o valor de PSVersion é 3.0 ou 4.0. Para instalar uma versão compatível, consulte Windows Management Framework 3.0.

Para obter ajuda detalhada sobre qualquer cmdlet que você vir neste tutorial, use o cmdlet Get-Help.

    Get-Help <cmdlet-name> -Detailed

Por exemplo, para obter ajuda para o cmdlet New-AzRedisCache , digite:

    Get-Help New-AzRedisCache -Detailed

Como se conectar a outras nuvens

Por padrão, o ambiente do Azure é AzureCloud, que representa a instância de nuvem global do Azure. Para se conectar a uma instância diferente, use o comando Connect-AzAccount com a opção de linha de comando -Environment ou -EnvironmentName com o ambiente ou o nome do ambiente que você deseja.

Para ver a lista de ambientes disponíveis, execute o cmdlet Get-AzEnvironment .

Para se conectar à Nuvem do Azure Government

Para se conectar à Nuvem do Azure Government, use um dos comandos a seguir.

    Connect-AzAccount -EnvironmentName AzureUSGovernment

Ou

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

Para criar um cache na Nuvem do Azure Government, use um dos locais a seguir.

  • USGov Virginia
  • USGov Iowa

Para saber mais sobre a Nuvem do Azure Government, confira Microsoft Azure Governamental e Guia do Desenvolvedor do Microsoft Azure Governamental.

Para se conectar ao Microsoft Azure operado pela nuvem da 21Vianet

Para se conectar à nuvem do Azure operado pela 21Vianet, use um dos comandos a seguir.

    Connect-AzAccount -EnvironmentName AzureChinaCloud

Ou

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

Para criar um cache na Nuvem do Azure operado pela 21Vianet, use um dos locais a seguir.

  • Leste da China
  • Norte da China

Para se conectar ao Microsoft Azure Alemanha

Para se conectar ao Microsoft Azure Alemanha, use um dos comandos a seguir.

    Connect-AzAccount -EnvironmentName AzureGermanCloud

Ou

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

Para criar um cache no Microsoft Azure Alemanha, use uma das localizações a seguir.

  • Alemanha Central
  • Nordeste da Alemanha

Para obter mais informações sobre o Microsoft Azure Alemanha, consulte Microsoft Azure Alemanha.

Propriedades usadas pelo PowerShell do Cache do Azure para Redis

A tabela a seguir contém as propriedades e as descrições do Azure PowerShell para parâmetros comuns ao criar e gerenciar suas instâncias do Cache do Azure para Redis.

Parâmetro Descrição Padrão
Nome Nome do cache
Location Local do cache
ResourceGroupName Nome do grupo de recursos no qual criar o cache
Tamanho O tamanho do cache. Os valores válidos são: 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 O número de fragmentos para criar durante a criação de um cache premium com o cluster ativado. Os valores válidos são: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10
SKU Especifica o SKU do cache. Os valores válidos são: Básico, Standard e Premium Standard
RedisConfiguration Especifica as definições de configuração do Redis. Para obter detalhes sobre cada configuração, confira a seguinte tabela de propriedades RedisConfiguration .
EnableNonSslPort Indica se a porta não SSL está habilitada. Falso
MaxMemoryPolicy Esse parâmetro foi desaprovado - use RedisConfiguration em vez disso.
StaticIP Ao hospedar o cache em uma VNET, especifica um endereço IP exclusivo na sub-rede do cache. Se ele não for fornecido, um será escolhido para você na sub-rede.
Sub-rede Ao hospedar o cache em uma VNET, especifica o nome da sub-rede na qual implantar o cache.
VirtualNetwork Ao hospedar o cache em uma VNET, especifica a ID do recurso da VNET na qual implantar o cache.
KeyType Especifica qual chave de acesso regenerar durante a renovação das chaves de acesso. Os valores válidos são: Primária, Secundária

propriedades RedisConfiguration

Propriedade Descrição Tipos de preço
rdb-backup-enabled Se persistência de dados Redis está habilitada Somente Premium
rdb-storage-connection-string A cadeia de conexão da conta de armazenamento para persistência de dados Redis Somente Premium
rdb-backup-frequency A frequência de backup da persistência de dados Redis Somente Premium
maxmemory-reserved Configura a memória reservada para processos fora do cache Standard e Premium
maxmemory-policy Configura o política de remoção para o cache Todos os tipos de preço
notify-keyspace-events Configura notificações keyspace Standard e Premium
hash-max-ziplist-entries Configura otimização de memória para tipos de dados de agregação pequenos Standard e Premium
hash-max-ziplist-value Configura otimização de memória para tipos de dados de agregação pequenos Standard e Premium
set-max-intset-entries Configura otimização de memória para tipos de dados de agregação pequenos Standard e Premium
zset-max-ziplist-entries Configura otimização de memória para tipos de dados de agregação pequenos Standard e Premium
zset-max-ziplist-value Configura otimização de memória para tipos de dados de agregação pequenos Standard e Premium
bancos de dados Configura o número de bancos de dados. Essa propriedade pode ser configurada apenas na criação do cache. Standard e Premium

Para criar um Cache do Azure para Redis

As novas instâncias do Cache do Azure para Redis são criadas usando o cmdlet New-AzRedisCache.

Importante

Na primeira vez que você cria um Cache do Azure para Redis em uma assinatura usando o portal do Azure, o portal registra o namespace Microsoft.Cache para a assinatura. Se você tentar criar o Cache do Azure para Redis primeiro em uma assinatura usando o PowerShell, deve primeiro registrar esse namespace usando o comando a seguir; caso contrário, cmdlets como New-AzRedisCache e Get-AzRedisCache falharão.

Register-AzResourceProvider -ProviderNamespace "Microsoft.Cache"

Para ver uma lista dos parâmetros disponíveis e suas descrições para New-AzRedisCache, execute o seguinte 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 criar um cache com parâmetros padrão, execute o comando a seguir.

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

ResourceGroupName, Name e Location são parâmetros obrigatórios, mas os restantes são opcionais e têm valores padrão. Executar o comando anterior cria uma instância do Cache do Azure para Redis do SKU Standard com o nome, local e grupo de recursos especificados. A instância tem 1 GB de tamanho, com a porta não SSL desativada.

Para criar um cache premium, especifique um tamanho de P1 (6 GB - 60 GB), P2 (13 GB - 130 GB), P3 (26 GB - 260 GB) ou P4 (53 GB - 530 GB). Para habilitar o clustering, especifique uma contagem de fragmentos usando o parâmetro ShardCount . O exemplo a seguir cria um cache premium P1 com três fragmentos. Um cache premium P1 tem 6 GB de tamanho e como especificamos três fragmentos, o tamanho total é 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 o parâmetro RedisConfiguration, coloque os valores dentro de {} como pares de chave/valor como @{"maxmemory-policy" = "allkeys-random", "notify-keyspace-events" = "KEA"}. O exemplo a seguir cria um cache padrão de 1 GB com as allkeys-random notificações maxmemory-policy e keyspace configuradas com KEA. Para obter mais informações, consulte Notificações de keyspace (configurações avançadas) e Políticas de memória.

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

Para configurar a definição dos bancos de dados durante a criação do cache

A configuração databases pode ser definida somente durante a criação do cache. O exemplo a seguir cria um cache premium P3 (26 GB) com 48 bancos de dados usando o cmdlet New-AzRedisCache .

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

Para saber mais sobre a propriedade databases, consulte Configuração do servidor do Cache Redis padrão do Azure. Para saber mais sobre como criar um cache usando o cmdlet New-AzRedisCache, confira a seção anterior Para criar um Cache do Azure para Redis.

Para atualizar um Cache do Azure para Redis

As instâncias do Cache do Azure para Redis são atualizadas usando o cmdlet Set-AzRedisCache.

Para ver uma lista dos parâmetros disponíveis e suas descrições para Set-AzRedisCache, execute o seguinte 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).

O cmdlet Set-AzRedisCache pode ser usado para atualizar propriedades como Size, Sku, EnableNonSslPort e os valores RedisConfiguration.

O comando a seguir atualiza a maxmemory-policy do Cache do Azure para Redis chamada myCache.

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

Para dimensionar um Cache do Azure para Redis

Set-AzRedisCache poderá ser usado para dimensionar uma instância do Cache do Azure para Redis quando as propriedades Size, Sku ou ShardCount forem modificadas.

Observação

Dimensionar um cache usando o PowerShell está sujeito aos mesmos limites e diretrizes de dimensionar um cache no portal do Azure. Você pode dimensionar para uma camada de preços diferente com as restrições a seguir.

  • Você não pode dimensionar de uma camada de preços mais alta para uma camada de preços mais baixa.
  • Você não pode dimensionar de um cache Premium para um cache Standard ou Básico.
  • Você não pode dimensionar de um cache Standard para um cache Básico.
  • É possível dimensionar de um cache Básico para um cache Standard, mas não é possível alterar o tamanho simultaneamente. Se precisar de um tamanho diferente, você pode fazer uma operação de dimensionamento subsequente para o tamanho desejado.
  • Você não pode dimensionar de um cache Básico diretamente para um cache Premium. Você deve dimensionar do Básico para o Standard em uma única operação de dimensionamento e do Standard para o Premium em uma operação de dimensionamento subsequente.
  • Não é possível dimensionar de um tamanho maior para o tamanho C0 (250 MB) .

Para saber mais, consulte Como dimensionar o Cache Redis do Azure.

O exemplo a seguir mostra como dimensionar um cache denominado myCache para um cache de 2,5 GB. Esse comando funciona para um cache Básico ou Standard.

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

Depois do comando ser emitido, o status do cache é retornado---semelhante a chamar Get-AzRedisCache. O ProvisioningState é definido 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         :

Quando a operação de dimensionamento for concluída, o ProvisioningState será alterado para Succeeded. Se você precisar fazer outra operação de dimensionamento---por exemplo, alterar de Básico para Standard, em seguida, alterar o tamanho---você deverá aguardar até que a operação anterior seja concluída ou receberá um erro semelhante ao seguinte.

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

Para saber mais sobre um Cache do Azure para Redis

Você pode recuperar informações sobre um cache usando o cmdlet Get-AzRedisCache.

Para ver uma lista dos parâmetros disponíveis e suas descrições para Get-AzRedisCache, execute o seguinte 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 retornar informações sobre todos os caches na assinatura atual, execute Get-AzRedisCache sem parâmetros.

    Get-AzRedisCache

Para retornar informações sobre todos os caches em um grupo de recursos específico, execute Get-AzRedisCache com o parâmetro ResourceGroupName.

    Get-AzRedisCache -ResourceGroupName myGroup

Para retornar informações sobre um cache específico, execute Get-AzRedisCache com o parâmetro Name que contém o nome do cache e o parâmetro ResourceGroupName com o grupo de recursos que contém esse cache.

    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         :

Para recuperar as chaves de acesso de um Cache do Azure para Redis

Para recuperar as chaves de acesso para seu cache, você pode usar o cmdlet Get-AzRedisCacheKey.

Para ver uma lista dos parâmetros disponíveis e suas descrições para Get-AzRedisCacheKey, execute o seguinte 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 as chaves para seu cache, chame o cmdlet Get-AzRedisCacheKey e passe no nome de seu cache o nome do grupo de recursos que contém o cache.

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

    PrimaryKey   : b2wdt43sfetlju4hfbryfnregrd9wgIcc6IA3zAO1lY=
    SecondaryKey : ABhfB757JgjIgt785JgKH9865eifmekfnn649303JKL=

Para regenerar as chaves de acesso de seu Cache do Azure para Redis

Para regenerar as chaves de acesso para seu cache, você pode usar o cmdlet New-AzRedisCacheKey.

Para ver uma lista dos parâmetros disponíveis e suas descrições para New-AzRedisCacheKey, execute o seguinte 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 a chave primária ou secundária para seu cache, chame o cmdlet New-AzRedisCacheKey, passe no nome o grupo de recursos e especifique Primary ou Secondary para o parâmetro KeyType. No exemplo a seguir, a chave de acesso secundária para um cache é regenerada.

    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=

Para excluir um Cache do Azure para Redis

Para excluir um Cache do Azure para Redis, use o cmdlet Remove-AzRedisCache.

Para ver uma lista dos parâmetros disponíveis e suas descrições para Remove-AzRedisCache, execute o seguinte 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).

No exemplo a seguir, o cache denominado myCache é removido.

    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

Para importar um Cache do Azure para Redis

Você pode importar dados para uma instância de Cache do Azure para Redis usando o cmdlet Import-AzRedisCache.

Importante

A opção Importar/Exportar está disponível somente para caches do nível Premium. Para saber mais sobre como Importar/Exportar, consulte Importar e exportar dados no Cache do Azure para Redis.

Para ver uma lista dos parâmetros disponíveis e suas descrições para Import-AzRedisCache, execute o seguinte 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).

O comando a seguir importa dados do blob especificado pelo URI de SAS no Cache do Azure para 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

Para exportar um Cache do Azure para Redis

Você pode exportar dados de uma instância de Cache do Azure para Redis usando o cmdlet Export-AzRedisCache.

Importante

A opção Importar/Exportar está disponível somente para caches do nível Premium. Para saber mais sobre como Importar/Exportar, consulte Importar e exportar dados no Cache do Azure para Redis.

Para ver uma lista dos parâmetros disponíveis e suas descrições para Export-AzRedisCache, execute o seguinte 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).

O comando a seguir exporta dados de uma instância de Cache do Azure para Redis para o contêiner especificado pelo 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"

Para reiniciar um Cache do Azure para Redis

Você pode reiniciar a instância de Cache do Azure para Redis usando o cmdlet Reset-AzRedisCache.

Importante

A reinicialização só está disponível para caches das camadas Básico, Standard e Premium. Para saber mais sobre a reinicialização de seu cache, confira Administração de cache - reinicializar.

Para ver uma lista dos parâmetros disponíveis e suas descrições para Reset-AzRedisCache, execute o seguinte 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).

O comando a seguir reinicializa ambos os nós do cache especificado.

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

Próximas etapas

Para saber mais sobre como usar o Windows PowerShell com o Azure, consulte os seguintes recursos: