New-AzRedisCache

Referência

Módulo:: Az.RedisCache

Cria um cache Redis.

Sintaxe

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

Description

O cmdlet New-AzRedisCache cria um Cache Redis do Azure.

Exemplos

Exemplo 1: Criar um cache Redis

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

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

Esse comando cria um Cache Redis.

Exemplo 2: Criar um cache Redis de SKU padrão

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

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

Esse cmdlet cria um cache usando o Cache do Azure para Redis.

Exemplo 3: Criar um cache com redundância de zona

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

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

Esse comando cria o cache do Azure para a instância do Redis em várias zonas.

Exemplo 4: Criar um cache de habilitação de rede virtual

Requisitos para criar o cache de habilitação da Rede Virtual.

Crie a rede virtual no mesmo grupo de recursos no qual você deseja criar o cache redis. Você pode criar uma rede virtual a partir do comando New-AzVirtualNetwork do PowerShell.
Você precisará de SubnetID para o cache de habilitação da VNET. A sintaxe de SubnetID é fornecida abaixo.

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

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

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

Exemplo 5: Configurar a persistência de dados para um Cache do Azure Premium para Redis

A persistência grava dados do Redis em uma conta de Armazenamento do Azure que você possui e gerencia. Portanto, antes de configurar a persistência de dados, você precisa ter uma conta de armazenamento no mesmo grupo de recursos. Você deve escolher uma conta de armazenamento na mesma região e assinatura que o cache e uma conta do Armazenamento Premium é recomendada, pois o Armazenamento Premium tem uma maior taxa de transferência.

Depois de criar uma conta de armazenamento, obtenha a cadeia de conexão da conta de armazenamento usando este procedimento.

Execute este comando Get-AzStorageAccountKey -ResourceGroupName $resourceGroupName -Name $storageAccountName no PowerShell.
Na saída acima, copie qualquer chave.
Coloque a chave da conta de armazenamento e o nome da conta de armazenamento no formato abaixo para obter a cadeia de conexão da sua conta de armazenamento.

Formato da cadeia de conexão: - "DefaultEndpointsProtocol=https; AccountName={storageAccountName}; AccountKey={storageAccountKey}; EndpointSuffix=mySuffix"

Você deve ter as definições de configuração específicas do Redis para habilitar a persistência de dados.

Para backup RDB, habilite

rdb-backup-enabled (Definir verdadeiro ou falso)
rdb-storage-connection-string (Forneça a string de conexão no formato acima.)
rdb-backup-frequency (Defina um intervalo de backup em minutos. Você só pode escolher entre - 15, 30, 60, 360, 720 e 1440 minutos.)

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

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

Exemplo 6: Configurar a persistência de dados para um Cache do Azure Premium para Redis – backup de AOF habilitado

Para backup AOF habilitado.

aof-backup-enabled (Definir verdadeiro ou falso),
aof-storage-connection-string-0 (Forneça a cadeia de conexão no formato acima.)
aof-storage-connection-string-1 (opcionalmente, você pode configurar outra conta de armazenamento. Se uma segunda conta de armazenamento estiver configurada, as gravações no cache de réplica serão gravadas nessa segunda conta de armazenamento.)

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

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

Parâmetros

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Tipo:	SwitchParameter
Aliases:	cf
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.

Tipo:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-DisableAccessKeyAuthentication

Opcional: a autenticação no Redis por meio de chaves de acesso é desativada quando definida como true. O valor padrão é falso.

Tipo:	String
Cargo:	Named
Valor padrão:	false
Obrigatório:	False
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-EnableNonSslPort

Indica se a porta não SSL está habilitada. O valor padrão é $False (a porta não SSL está desativada).

Tipo:	Nullable<T>[Boolean]
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-IdentityType

Especifica o tipo de identidade usado para o Cache do Azure para Redis. Valores válidos: "SystemAssigned" ou "UserAssigned" ou "SystemAssignedUserAssigned" ou "None"

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-Location

Especifica o local no qual criar um Cache Redis. Os valores válidos são:

Centro-Norte dos EUA
Centro-Sul dos Estados Unidos
Centro dos EUA
Europa Ocidental
Norte da Europa
Oeste dos EUA
Leste dos EUA
Leste dos EUA 2
Leste do Japão
Oeste do Japão
Brazil South
Sudeste Asiático
Leste da Ásia
Leste da Austrália
Australia Southeast

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-MinimumTlsVersion

Especifique a versão do TLS exigida pelos clientes para se conectar ao cache.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-Name

Especifica o nome do Cache Redis a ser criado.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-RedisConfiguration

Especifica as definições de configuração do Redis. Os valores aceitáveis para esse parâmetro são:

rdb-backup habilitado. Especifica que a persistência de dados do Redis está habilitada. Somente nível Premium.
rdb-cadeia de conexão-de-armazenamento. Especifica a cadeia de conexão para a conta de armazenamento para persistência de dados do Redis. Somente nível Premium.
rdb-backup-frequency. Especifica a frequência de backup para persistência de dados do Redis. Somente nível Premium.
maxmemory-reserved. Configura a memória reservada para processos que não são de cache. Níveis Standard e Premium.
política de memória máxima. Configura a política de remoção para o cache. Todos os tipos de preços.
eventos notify-keyspace. Configura notificações de keyspace. Níveis Standard e Premium.
hash-max-ziplist-entries. Configura a otimização de memória para pequenos tipos de dados agregados. Níveis Standard e Premium.
hash-max-ziplist-value. Configura a otimização de memória para pequenos tipos de dados agregados. Níveis Standard e Premium.
set-max-intset-ents. Configura a otimização de memória para pequenos tipos de dados agregados. Níveis Standard e Premium.
zset-max-ziplist-entries. Configura a otimização de memória para pequenos tipos de dados agregados. Níveis Standard e Premium.
zset-max-ziplist-valor. Configura a otimização de memória para pequenos tipos de dados agregados. Níveis Standard e Premium.
. Configura o número de bancos de dados. Essa propriedade pode ser configurada apenas na criação do cache. Níveis Standard e Premium. Para obter mais informações, consulte Gerenciar o Cache Redis do Azure com o Azure PowerShellhttp://go.microsoft.com/fwlink/?LinkId=800051 (http://go.microsoft.com/fwlink/?LinkId=800051).
método de autenticação de arquivamento de dados preferencial Método de autenticação preferencial para se comunicar com a conta de armazenamento usada para arquivamento de dados, especifique SAS ou ManagedIdentity, o valor padrão é SAS
preferred-data-persistence-auth-method Método de autenticação preferencial para se comunicar com a conta de armazenamento usada para persistência de dados, especifique SAS ou ManagedIdentity, o valor padrão é SAS

Tipo:	Hashtable
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-RedisVersion

Versão Redis. Isso deve estar no formato 'major[.minor]' (somente 'major' é necessário) ou no valor 'latest', que se refere à versão estável mais recente do Redis disponível. Versões suportadas: 4.0, 6.0 (mais recente). O valor padrão é 'mais recente'.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-ResourceGroupName

Especifica o nome do grupo de recursos no qual criar o Cache Redis.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-ShardCount

Especifica o número de fragmentos a serem criados em um cache de cluster Premium. Os valores aceitáveis para esse parâmetro são:

Tipo:	Nullable<T>[Int32]
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-Size

Especifica o tamanho do Cache Redis. Os valores válidos são:

P1
P2
P3
P4
P5
C0
C1
C2
C3
C4
C5
C6
250 MB
1 GB
2,5GB
6 GB
13 GB
26 GB
53 GB O valor padrão é 1 GB ou C1.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-Sku

Especifica o SKU do Cache Redis a ser criado. Os valores válidos são:

Basic
Standard
Premium O valor padrão é Standard.

Tipo:	String
Valores aceitos:	Basic, Standard, Premium
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-StaticIP

Especifica um endereço IP exclusivo na sub-rede para o Cache Redis. Se você não especificar um valor para esse parâmetro, esse cmdlet escolherá um endereço IP da sub-rede.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-SubnetId

A ID de recurso completa de uma sub-rede em uma rede virtual na qual implantar o Cache do Azure para Redis. Formato de exemplo: /subscriptions/{subid}/resourceGroups/{resourceGroupName}/Microsoft. {Rede|ClassicNetwork}/VirtualNetworks/{vnetName}/subnets/{subnetName}

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-Tag

Uma tabela de hash que representa tags.

Tipo:	Hashtable
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-TenantSettings

Esse parâmetro foi descontinuado.

Tipo:	Hashtable
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-UpdateChannel

Opcional: especifica o canal de atualização para as atualizações mensais do Redis que seu Cache Redis receberá. Os caches que usam o canal de atualização "Visualização" recebem as atualizações mais recentes do Redis pelo menos 4 semanas antes dos caches do canal "Estável". O valor padrão é 'Estável'. Os valores possíveis incluem: 'Estável', 'Visualização'

Tipo:	String
Cargo:	Named
Valor padrão:	Stable
Obrigatório:	False
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-UserAssignedIdentity

Especifica uma ou mais identidades de usuário separadas por vírgula a serem associadas ao Cache do Azure para Redis. As referências de identidade do usuário serão IDs de recurso do ARM no formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identities/{identityName}'

Tipo:	String[]
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:	SwitchParameter
Aliases:	wi
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Zone

Lista de regiões do Azure com zonas de disponibilidade.

Tipo:	String[]
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

Entradas

String

Hashtable

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

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

String[]

Saídas

RedisCacheAttributesWithAccessKeys

Compartilhar via

New-AzRedisCache

Sintaxe

Description

Exemplos

Exemplo 1: Criar um cache Redis

Exemplo 2: Criar um cache Redis de SKU padrão

Exemplo 3: Criar um cache com redundância de zona

Exemplo 4: Criar um cache de habilitação de rede virtual

Exemplo 5: Configurar a persistência de dados para um Cache do Azure Premium para Redis

Exemplo 6: Configurar a persistência de dados para um Cache do Azure Premium para Redis – backup de AOF habilitado

Parâmetros

-Confirm

-DefaultProfile

-DisableAccessKeyAuthentication

-EnableNonSslPort

-IdentityType

-Location

-MinimumTlsVersion

-Name

-RedisConfiguration

-RedisVersion

-ResourceGroupName

-ShardCount

-Size

-Sku

-StaticIP

-SubnetId

-Tag

-TenantSettings

-UpdateChannel

-UserAssignedIdentity

-WhatIf

-Zone

Entradas

Saídas

Recursos adicionais

Compartilhar via

New-AzRedisCache

Sintaxe

Description

Exemplos

Exemplo 1: Criar um cache Redis

Exemplo 2: Criar um cache Redis de SKU padrão

Exemplo 3: Criar um cache com redundância de zona

Exemplo 4: Criar um cache de habilitação de rede virtual

Exemplo 5: Configurar a persistência de dados para um Cache do Azure Premium para Redis

Exemplo 6: Configurar a persistência de dados para um Cache do Azure Premium para Redis – backup de AOF habilitado

Parâmetros

-Confirm

-DefaultProfile

-DisableAccessKeyAuthentication

-EnableNonSslPort

-IdentityType

-Location

-MinimumTlsVersion

-Name

-RedisConfiguration

-RedisVersion

-ResourceGroupName

-ShardCount

-Size

-Sku

-StaticIP

-SubnetId

-Tag

-TenantSettings

-UpdateChannel

-UserAssignedIdentity

-WhatIf

-Zone

Entradas

Saídas

Links Relacionados

Recursos adicionais