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>]
   [-ZonalAllocationPolicy <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 zonas de mutliple.

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 seu cache redis. Você pode criar uma rede virtual comando New-AzVirtualNetwork powershell.
Você precisará de SubnetID para habilitar o cache 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 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 conta de armazenamento no mesmo grupo de recursos. Escolha uma conta de armazenamento na mesma região e assinatura do cache, e uma conta de Armazenamento Premium é recomendada porque o armazenamento Premium tem uma taxa de transferência maior.

Depois de criar uma conta de armazenamento, obtenha a cadeia de conexão da conta de armazenamento usando esse 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 configurações específicas do Redis para habilitar a persistência de dados.

Para habilitar o backup do RDB

rdb-backup habilitado (Definir true ou false)
rdb-storage-connection-string (Dar cadeia de conexão no formato acima).)
rdb-backup-frequency (Definir 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 do AOF habilitado

Para backup do AOF habilitado.

habilitado para backup aof (definir true ou false),
aof-storage-connection-string-0 (Dar 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 nesta 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 a 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 é desabilitada 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á desabilitada).

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 EUA
EUA Central
Europa Ocidental
Norte da Europa
Oeste dos EUA
Leste dos EUA
Leste dos EUA 2
Leste do Japão
Oeste do Japão
Sul do Brasil
Sudeste Asiático
Ásia Oriental
Leste da Austrália
Sudeste da Austrália

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 configurações do Redis. Os valores aceitáveis para este parâmetro são:

rdb-backup habilitado. Especifica que a persistência de dados do Redis está habilitada. Somente camada Premium.
rdb-storage-connection-string. Especifica a cadeia de conexão para a conta de armazenamento para persistência de dados redis. Somente camada Premium.
rdb-backup-frequency. Especifica a frequência de backup para persistência de dados redis. Somente camada Premium.
maxmemory-reserved. Configura a memória reservada para processos que não são de cache. Camadas Standard e Premium.
maxmemory-policy. Configura a política de remoção para o cache. Todos os tipos de preço.
notify-keyspace-events. Configura as notificações do keyspace. Camadas Standard e Premium.
hash-max-ziplist-entries. Configura a otimização de memória para pequenos tipos de dados agregados. Camadas Standard e Premium.
hash-max-ziplist-value. Configura a otimização de memória para pequenos tipos de dados agregados. Camadas Standard e Premium.
set-max-intset-entries. Configura a otimização de memória para pequenos tipos de dados agregados. Camadas Standard e Premium.
zset-max-ziplist-entries. Configura a otimização de memória para pequenos tipos de dados agregados. Camadas Standard e Premium.
zset-max-ziplist-value. Configura a otimização de memória para pequenos tipos de dados agregados. Camadas Standard e Premium.
Bancos. Configura o número de bancos de dados. Essa propriedade só pode ser configurada na criação do cache. Camadas 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 preferencial preferred-data-archive-auth-method Preferred para se comunicar com a conta de armazenamento usada para o arquivo de dados, especificar SAS ou ManagedIdentity, o valor padrão é SAS
Método preferencial preferred-data-persistence-auth-method Preferred para se comunicar com a conta de armazenamento usada para persistência de dados, especificar 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 do Redis. Isso deve estar na forma 'major[.minor]' (apenas 'major' é necessário) ou o valor 'latest' que se refere à versão mais recente estável do Redis que está disponível. Versões com suporte: 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 este 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,5 GB
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:

Básico
Padrão
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 do Cache Redis. Se você não especificar um valor para esse parâmetro, esse cmdlet escolherá um endereço IP na 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 para implantar o Cache do Azure para Redis. Formato de exemplo: /subscriptions/{subid}/resourceGroups/{resourceGroupName}/Microsoft. {Rede|ClassicNetwork}/VirtualNetworks/{vnetName}/sub-redes/{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 marcas.

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 preterido.

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 o Cache Redis receberá. Os caches que usam o canal de atualização 'Visualização' recebem atualizações mais recentes do Redis pelo menos 4 semanas antes dos caches de 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 semeadas 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 formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identityies/{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

-ZonalAllocationPolicy

Opcional: opcional: especifica como as zonas de disponibilidade são alocadas para o cache Redis. O 'Automático' habilita a redundância de zona e o Azure selecionará automaticamente zonas com base na disponibilidade e na capacidade regionais. 'UserDefined' selecionará zonas de disponibilidade passadas por você usando o parâmetro 'zones'. 'NoZones' produzirá um cache não zonal. Se 'zonalAllocationPolicy' não for passado, ele será definido como 'UserDefined' quando as zonas forem passadas, caso contrário, ele será definido como 'Automático' em regiões em que há suporte para zonas e 'NoZones' em regiões em que as zonas não têm suporte.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	True
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 do 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

-ZonalAllocationPolicy

-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 do 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

-ZonalAllocationPolicy

-Zone

Entradas

Saídas

Links Relacionados

Recursos adicionais