Partilhar via


New-AzureRmRedisCache

Cria um cache Redis.

Aviso

O módulo AzureRM do PowerShell foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo Az PowerShell para garantir suporte e atualizações contínuos.

Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso continuado a critério e risco do usuário. Consulte nossos recursos de migração para obter orientação sobre a transição para o módulo Az.

Sintaxe

New-AzureRmRedisCache
   -ResourceGroupName <String>
   -Name <String>
   -Location <String>
   [-Size <String>]
   [-Sku <String>]
   [-RedisConfiguration <Hashtable>]
   [-EnableNonSslPort <Boolean>]
   [-TenantSettings <Hashtable>]
   [-ShardCount <Int32>]
   [-SubnetId <String>]
   [-StaticIP <String>]
   [-Tag <Hashtable>]
   [-Zone <String[]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet New-AzureRmRedisCache cria um Cache Redis do Azure.

Exemplos

Exemplo 1: Criar um cache Redis

PS C:\>New-AzureRmRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "North Central US"

          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 : {}
          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

PS C:\>New-AzureRmRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "North Central US" -Size 250MB -Sku "Standard" -RedisConfiguration @{"maxmemory-policy" = "allkeys-random"} -Force

          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 cria um Cache Redis.

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:AzureRmContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
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

-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

-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 PowerShellhttps://go.microsoft.com/fwlink/?LinkId=800051 (https://go.microsoft.com/fwlink/?LinkId=800051).
Tipo:Hashtable
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
  • 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
Valores aceites:P1, P2, P3, P4, C0, C1, C2, C3, C4, C5, C6, 250MB, 1GB, 2.5GB, 6GB, 13GB, 26GB, 53GB
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

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

-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 zonas.

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, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

Nullable<T>[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

String[]

Saídas

RedisCacheAttributesWithAccessKeys