New-AzRedisCache
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 : []
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 do comando powershell New-AzVirtualNetwork .
- 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 uma 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 a sua 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 predefinido é falso.
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:
- E.U.A. Centro-Norte
- E.U.A. Centro-Sul
- E.U.A. Central
- Europa Ocidental
- Europa do Norte
- E.U.A. Oeste
- E.U.A. Leste
- E.U.A. Leste 2
- Leste do Japão
- Oeste do Japão
- Sul do Brasil
- Sudeste Asiático
- Ásia Leste
- 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:
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
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:
- P1
- P2
- P3
- P4
- P5
- C0
- C1
- C2
- C3
- C4
- C5
- C6
- 250 MB
- 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ásica
- Standard
- 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
Apresenta o que aconteceria mediante a execução do cmdlet. 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 |
-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
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
Ligações Relacionadas
Azure PowerShell