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               : []

Este comando cria um Cache Redis.

Exemplo 2: Criar um cache Redis 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               : []

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

Exemplo 3: Criar um cache redundante 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}

Este comando cria cache do Azure para instância do Redis em zonas mutliple.

Exemplo 4: Criar uma Rede Virtual ativar Cache

Os requisitos para a criação de cache de habilitação de Rede Virtual.

Crie a rede virtual no mesmo grupo de recursos no qual você deseja criar seu cache redis. Você pode criar rede virtual a partir de comando New-AzVirtualNetwork powershell.
Você precisará de SubnetID para cache de ativação de VNET. A sintaxe de SubnetID é dada 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 Premium do Azure 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 mais alta.

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.
A partir da 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 true ou false)
rdb-storage-connection-string (Forneça a cadeia 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 Premium do Azure para Redis - backup AOF habilitado

Para backup AOF habilitado.

aof-backup-enabled (Definir true ou false),
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 for 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 confirmação antes de executar o cmdlet.

Tipo:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	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
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-DisableAccessKeyAuthentication

Opcional: A autenticação no Redis através de chaves de acesso é desativada quando definida como true. O valor padrão é false.

Tipo:	String
Position:	Named
Default value:	false
Necessário:	False
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	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]
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-IdentityType

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

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	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 centrais
Europa Ocidental
Norte da Europa
Oeste dos EUA
Leste dos EUA
Leste dos EUA 2
Leste do Japão
Oeste do Japão
Brasil Sul
Sudeste Asiático
Ásia Oriental
Leste da Austrália
Austrália Sudeste

Tipo:	String
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-MinimumTlsVersion

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

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-Name

Especifica o nome do Cache Redis a ser criado.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-RedisConfiguration

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

rdb-backup-habilitado. Especifica que a persistência de dados Redis está habilitada. Apenas nível Premium.
rdb-storage-connection-string. Especifica a cadeia de conexão com a conta de armazenamento para persistência de dados Redis. Apenas nível Premium.
rdb-backup-freqüência. Especifica a frequência de backup para persistência de dados Redis. Apenas nível Premium.
maxmemory-reservado. Configura a memória reservada para processos que não são de cache. Níveis Standard e Premium.
maxmemory-policy. Configura a política de remoção para o cache. Todos os níveis de preços.
notify-keyspace-events. Configura notificações de espaço de chave. Níveis Standard e Premium.
entradas hash-max-ziplist. 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-entries. Configura a otimização de memória para pequenos tipos de dados agregados. Níveis Standard e Premium.
zset-max-ziplist-entradas. Configura a otimização de memória para pequenos tipos de dados agregados. Níveis Standard e Premium.
zset-max-ziplist-value. Configura a otimização de memória para pequenos tipos de dados agregados. Níveis Standard e Premium.
bases de dados. Configura o número de bancos de dados. Essa propriedade só pode ser configurada 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).
preferred-data-archive-auth-method Método de autenticação preferencial para se comunicar com a conta de armazenamento usado para arquivamento de dados, especificar 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 usado para persistência de dados, especificar SAS ou ManagedIdentity, o valor padrão é SAS

Tipo:	Hashtable
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-RedisVersion

Versão Redis. Este deve ser na forma 'major[.minor]' (apenas 'major' é necessário) ou o valor 'mais recente' que se refere à última versão estável do Redis que está disponível. Versões suportadas: 4.0, 6.0 (mais recente). O valor padrão é 'mais recente'.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-ResourceGroupName

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

Tipo:	String
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	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]
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-Size

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

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

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-Sku

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

Básico
Padrão
Premium O valor padrão é Standard.

Tipo:	String
Valores aceites:	Basic, Standard, Premium
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	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
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-SubnetId

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

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-Tag

Uma tabela de hash que representa tags.

Tipo:	Hashtable
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-TenantSettings

Este parâmetro foi preterido.

Tipo:	Hashtable
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-UpdateChannel

Opcional: especifica o canal de atualização para as atualizações mensais do Cache Redis que seu Cache Redis receberá. Os caches que usam o canal de atualização 'Preview' obtêm as 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', 'Pré-visualização'

Tipo:	String
Position:	Named
Default value:	Stable
Necessário:	False
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-UserAssignedIdentity

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

Tipo:	String[]
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-WhatIf

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

Tipo:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-ZonalAllocationPolicy

Opcional: Opcional: especifica como as zonas de disponibilidade são alocadas para o cache Redis. 'Automático' permite redundância de zona e o Azure selecionará automaticamente zonas com base na disponibilidade e 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 'Automatic' em regiões onde as zonas são suportadas e 'NoZones' em regiões onde as zonas não são suportadas.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-Zone

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

Tipo:	String[]
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	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

Partilhar via

New-AzRedisCache

Sintaxe

Description

Exemplos

Exemplo 1: Criar um cache Redis

Exemplo 2: Criar um cache Redis SKU padrão

Exemplo 3: Criar um cache redundante de zona

Exemplo 4: Criar uma Rede Virtual ativar Cache

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

Exemplo 6: Configurar a persistência de dados para um Cache Premium do Azure para Redis - backup 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

Partilhar via

New-AzRedisCache

Sintaxe

Description

Exemplos

Exemplo 1: Criar um cache Redis

Exemplo 2: Criar um cache Redis SKU padrão

Exemplo 3: Criar um cache redundante de zona

Exemplo 4: Criar uma Rede Virtual ativar Cache

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

Exemplo 6: Configurar a persistência de dados para um Cache Premium do Azure para Redis - backup 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

Ligações Relacionadas

Recursos adicionais