Compartilhar via

Set-AzRedisCache

Módulo:
Az.RedisCache Module

Modifica um Cache do Azure para Redis.

Sintaxe

Default (Default) 

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

Esse comando atualiza a política maxmemory para o Cache do Azure para Redis 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               : []

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

Exemplo 3: Modificar o Cache do Azure para Redis – 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 habilita a persistência rdb-backup em um cache já existente. Você também pode habilitar a persistência de backup de aof.

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 instantâneo de RDB a cada 30 minutos, mas deseja alterar para tirar 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 do 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               : []

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

Exemplo 6: dimensionar uma instância do Cache do Azure para Redis – atualizar para um 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 instância.

Exemplo 7: dimensionar uma instância do Cache do Azure para Redis – atualizar para uma 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               : []

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

Exemplo 8: dimensionar uma instância do Cache do Azure para Redis – habilitar o 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               : []

Esse cmdlet ajuda você a habilitar o clustering para sua instância do Cache do Azure para Redis. Para aumentar a contagem de fragmentos, deve habilitar o clustering primeiro.

Exemplo 9: dimensionar uma instância do Cache do Azure para Redis – use o Cluster Redis para escalar/reduzir horizontalmente.

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

Esse comando aumenta ou diminui o tamanho do cluster.

Parâmetros

-Confirm

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DefaultProfile

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

Propriedades do parâmetro

Tipo:IAzureContextContainer
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DisableAccessKeyAuthentication

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

Propriedades do parâmetro

Tipo:String
Valor padrão:false
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-EnableNonSslPort

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

Propriedades do parâmetro

Tipo:

Nullable<T>[Boolean]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes: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"

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-MinimumTlsVersion

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Name

Especifica o nome do Cache do Azure para Redis a ser atualizado.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes: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 pode ser configurada apenas na criação do cache. Camadas Standard e Premium. Para obter mais informações, consulte Gerenciar o Cache Redis do Azure com o Azure PowerShell.
  • 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

Propriedades do parâmetro

Tipo:Hashtable
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes: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'.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-ResourceGroupName

Especifica o nome do grupo de recursos que contém o Cache Redis.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-ShardCount

Especifica o número de fragmentos a serem criados em um cache de cluster Premium.

Propriedades do parâmetro

Tipo:

Nullable<T>[Int32]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes: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
  • 6GB
  • 13 GB
  • 26 GB
  • 53 GB
  • 120 GB O valor padrão é 1 GB ou C1.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Sku

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

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Valores aceitos:Basic, Standard, Premium
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Tag

Uma tabela de hash que representa marcas.

Propriedades do parâmetro

Tipo:Hashtable
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-TenantSettings

Esse parâmetro foi preterido.

Propriedades do parâmetro

Tipo:Hashtable
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes: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'

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes: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 formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identityies/{identityName}'

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-WhatIf

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

String

Hashtable

Nullable<T>

Nullable<T>

Saídas

RedisCacheAttributesWithAccessKeys