Set-AzRedisCache

Referência

Módulo:: Az.RedisCache

Modifica um cache do Azure para Redis.

Sintaxe

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

Description

O cmdlet Set-AzRedisCache modifica um Cache do Azure para Redis.

Exemplos

Exemplo 1: Modificar o Cache do Azure para Redis

Set-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -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 comando atualiza a política maxmemory para seu Cache Redis do Azure chamado MyCache.

Exemplo 2: Modificar o Cache do Azure para Redis - Se você quiser desabilitar a persistência de dados RDB ou AOF.

Set-AzRedisCache -Name "MyCache"  -RedisConfiguration @{"rdb-backup-enabled" = "false"}

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  : Succeeded
          SslPort            : 6380
          RedisConfiguration : {[maxmemory-policy, allkeys-random], [maxclients, 7500], [maxmemory-reserved, 200],
                                [maxfragmentationmemory-reserved, 300], [rdb-backup-enabled, false]...} 
          EnableNonSslPort   : False
          RedisVersion       : 4.0.14
          Size               : 6GB
          Sku                : Premium
          Tag                : {}
          Zone               : []

Este cmdlet desabilita a persistência de dados de backup RDB para o Cache do Azure para Redis. Você também pode desabilitar o cache persistente de backup AOF.

Exemplo 3: Modificar o Cache Redis do Azure - Se você quiser adicionar persistência de dados após a criação do cache Redis do Azure.

Set-AzRedisCache -Name "MyCache" -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  : Succeeded
          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               : []

Esse cmdlet permite a persistência rdb-backup em um cache já existente. Você também pode habilitar a persistência aof-backup.

Exemplo 4: Modificar o Cache do Azure para Redis - Se você quiser alterar a frequência de backup do rdb.

Por exemplo - Atualmente, você está tirando um instantâneo RDB a cada 30 minutos, mas deseja alterar para tirar um instantâneo de 15 minutos.

Set-AzRedisCache -Name "MyCache" -RedisConfiguration @{"rdb-backup-frequency" = "15"}

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  : Succeeded
          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 5: Modificar o Cache do Azure para Redis - Se você quiser alterar a persistência de dados de backup do AOF para backup RDB.

Set-AzRedisCache -Name "MyCache"  -RedisConfiguration @{"aof-backup-enabled"= "false"; "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  : Succeeded
          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               : []

Este cmdlet ajuda a alterar o método de persistência.

Exemplo 6: Dimensionar um Cache do Azure para Instância Redis - Atualizar para tamanho diferente.

Set-AzRedisCache -Name "MyCache" -Size "P2" -Sku "Premium"

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

Esse comando aumenta ou diminui o tamanho da memória da sua instância.

Exemplo 7: Dimensionar um Cache do Azure para Instância Redis - Atualizar para camada diferente.

Set-AzRedisCache -Name "MyCache" -Size "P1" -Sku "Premium"

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  : Scaling
          SslPort            : 6380
          RedisConfiguration : {[maxmemory-policy, allkeys-random], [maxclients, 7500], [maxmemory-reserved, 200],
                                [maxfragmentationmemory-reserved, 300]....} 
          EnableNonSslPort   : False
          RedisVersion       : 4.0.14
          Size               : 1GB
          Sku                : Standard
          Tag                : {}
          Zone               : []

Este comando ajuda a alterar a camada do cache. Você pode mudar de Basic para Standard ou Standard para Premium.

Exemplo 8: Dimensionar um Cache do Azure para Instância Redis - Habilitar Clustering Redis.

Set-AzRedisCache -Name "MyCache" -ShardCount 1

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  : Scaling
          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
          ShardCount         :
          Tag                : {}
          Zone               : []

Este cmdlet ajuda você a habilitar o clustering para sua instância do Cache do Azure para Redis. Para aumentar a contagem de estilhaços, deve habilitar o agrupamento primeiro.

Exemplo 9: Dimensionar um Cache do Azure para Instância Redis - Use o Cluster Redis para dimensionar para dentro/para fora.

Set-AzRedisCache -Name "MyCache" -ShardCount 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  : Scaling
          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
          ShardCount         : 1
          Tag                : {}
          Zone               : []

Este comando aumenta ou diminui o tamanho do cluster.

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

-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 do Azure para Redis a ser atualizado.

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 que contém o Cache Redis.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
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.

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
53 GB
120GB 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

-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:	None
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

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

Saídas

RedisCacheAttributesWithAccessKeys

Partilhar via

Set-AzRedisCache

Sintaxe

Description

Exemplos

Exemplo 1: Modificar o Cache do Azure para Redis

Exemplo 2: Modificar o Cache do Azure para Redis - Se você quiser desabilitar a persistência de dados RDB ou AOF.

Exemplo 3: Modificar o Cache Redis do Azure - Se você quiser adicionar persistência de dados após a criação do cache Redis do Azure.

Exemplo 4: Modificar o Cache do Azure para Redis - Se você quiser alterar a frequência de backup do rdb.

Exemplo 5: Modificar o Cache do Azure para Redis - Se você quiser alterar a persistência de dados de backup do AOF para backup RDB.

Exemplo 6: Dimensionar um Cache do Azure para Instância Redis - Atualizar para tamanho diferente.

Exemplo 7: Dimensionar um Cache do Azure para Instância Redis - Atualizar para camada diferente.

Exemplo 8: Dimensionar um Cache do Azure para Instância Redis - Habilitar Clustering Redis.

Exemplo 9: Dimensionar um Cache do Azure para Instância Redis - Use o Cluster Redis para dimensionar para dentro/para fora.

Parâmetros

-Confirm

-DefaultProfile

-DisableAccessKeyAuthentication

-EnableNonSslPort

-IdentityType

-MinimumTlsVersion

-Name

-RedisConfiguration

-RedisVersion

-ResourceGroupName

-ShardCount

-Size

-Sku

-Tag

-TenantSettings

-UpdateChannel

-UserAssignedIdentity

-WhatIf

-ZonalAllocationPolicy

Entradas

Saídas

Recursos adicionais

Partilhar via

Set-AzRedisCache

Sintaxe

Description

Exemplos

Exemplo 1: Modificar o Cache do Azure para Redis

Exemplo 2: Modificar o Cache do Azure para Redis - Se você quiser desabilitar a persistência de dados RDB ou AOF.

Exemplo 3: Modificar o Cache Redis do Azure - Se você quiser adicionar persistência de dados após a criação do cache Redis do Azure.

Exemplo 4: Modificar o Cache do Azure para Redis - Se você quiser alterar a frequência de backup do rdb.

Exemplo 5: Modificar o Cache do Azure para Redis - Se você quiser alterar a persistência de dados de backup do AOF para backup RDB.

Exemplo 6: Dimensionar um Cache do Azure para Instância Redis - Atualizar para tamanho diferente.

Exemplo 7: Dimensionar um Cache do Azure para Instância Redis - Atualizar para camada diferente.

Exemplo 8: Dimensionar um Cache do Azure para Instância Redis - Habilitar Clustering Redis.

Exemplo 9: Dimensionar um Cache do Azure para Instância Redis - Use o Cluster Redis para dimensionar para dentro/para fora.

Parâmetros

-Confirm

-DefaultProfile

-DisableAccessKeyAuthentication

-EnableNonSslPort

-IdentityType

-MinimumTlsVersion

-Name

-RedisConfiguration

-RedisVersion

-ResourceGroupName

-ShardCount

-Size

-Sku

-Tag

-TenantSettings

-UpdateChannel

-UserAssignedIdentity

-WhatIf

-ZonalAllocationPolicy

Entradas

Saídas

Ligações Relacionadas

Recursos adicionais