Set-AzRedisCache

Referência

Módulo:: Az.RedisCache

Modifica um cache do Azure para Redis.

Syntax

Set-AzRedisCache
   [-ResourceGroupName <String>]
   -Name <String>
   [-Size <String>]
   [-Sku <String>]
   [-RedisConfiguration <Hashtable>]
   [-EnableNonSslPort <Boolean>]
   [-TenantSettings <Hashtable>]
   [-ShardCount <Int32>]
   [-MinimumTlsVersion <String>]
   [-RedisVersion <String>]
   [-UpdateChannel <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         : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          SecondaryKey       : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          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 maxmemory-policy 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         : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          SecondaryKey       : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          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 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=pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=;EndpointSuffix=mySuffix"; "rdb-backup-frequency" = "30"}

PrimaryKey         : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          SecondaryKey       : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          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 - No momento, você está tirando instantâneo RDB a cada 30 minutos, mas deseja alterar para tirar instantâneo 15 minutos.

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

PrimaryKey         : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          SecondaryKey       : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          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 o 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=pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=;EndpointSuffix=mySuffix"; "rdb-backup-frequency" = "30"}

PrimaryKey         : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          SecondaryKey       : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          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 um Cache do Azure para Instância Redis - Atualizar para tamanho diferente.

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

PrimaryKey         : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          SecondaryKey       : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          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 um Cache do Azure para Instância Redis - Atualizar para uma camada diferente.

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

PrimaryKey         : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          SecondaryKey       : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          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 a alterar a camada do cache. Você pode mudar de Básico para Padrão ou Standard para Premium.

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

Set-AzRedisCache -Name "MyCache" -ShardCount 1

PrimaryKey         : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          SecondaryKey       : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          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 clustering primeiro.

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

Set-AzRedisCache -Name "MyCache" -ShardCount 2

PrimaryKey         : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          SecondaryKey       : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          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.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

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

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableNonSslPort

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

Type:	Nullable<T>[Boolean]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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"

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-MinimumTlsVersion

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

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

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-RedisConfiguration

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

rdb-backup-enabled. 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.
notificar-keyspace-events. Configura notificações de espaço de chave. Níveis Standard e Premium.
hash-max-ziplist-entradas. Configura a otimização de memória para pequenos tipos de dados agregados. Níveis Standard e Premium.
hash-max-ziplist-valor. 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-entries. 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.
. Configura o número de bancos de dados. Essa propriedade pode ser configurada apenas 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 usada 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 usada para persistência de dados, especificar SAS ou ManagedIdentity, o valor padrão é SAS

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-RedisVersion

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ResourceGroupName

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ShardCount

Especifica o número de estilhaços a serem criados em um cache de cluster Premium.

Type:	Nullable<T>[Int32]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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,5GB
6 GB
13 GB
26GB
53GB
120GB O valor padrão é 1GB ou C1.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Sku

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

Basic
Standard
Premium O valor padrão é Standard.

Type:	String
Accepted values:	Basic, Standard, Premium
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Tag

Uma tabela de hash que representa tags.

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-TenantSettings

Esse parâmetro foi preterido.

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-UpdateChannel

Opcional: especifica o canal de atualização para as atualizações mensais do Redis que seu Cache Redis receberá. Os caches que usam o canal de atualização 'Preview' recebem as atualizações mais recentes do Redis pelo menos 4 semanas antes dos caches de canal 'Stable'. O valor padrão é 'Estável'. Os valores possíveis incluem: 'Estável', 'Pré-visualização'

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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}'

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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

Set-AzRedisCache

Syntax

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 do Azure para Redis - 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 o backup do 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 uma camada diferente.

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

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

Parâmetros

-Confirm

-DefaultProfile

-EnableNonSslPort

-IdentityType

-MinimumTlsVersion

-Name

-RedisConfiguration

-RedisVersion

-ResourceGroupName

-ShardCount

-Size

-Sku

-Tag

-TenantSettings

-UpdateChannel

-UserAssignedIdentity

-WhatIf

Entradas

Saídas

Comentários

Recursos adicionais

Set-AzRedisCache

Syntax

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 do Azure para Redis - 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 o backup do 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 uma camada diferente.

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

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

Parâmetros

-Confirm

-DefaultProfile

-EnableNonSslPort

-IdentityType

-MinimumTlsVersion

-Name

-RedisConfiguration

-RedisVersion

-ResourceGroupName

-ShardCount

-Size

-Sku

-Tag

-TenantSettings

-UpdateChannel

-UserAssignedIdentity

-WhatIf

Entradas

Saídas

Links Relacionados

Comentários

Recursos adicionais