Compartilhar via


New-AzRedisEnterpriseCache

Cria um cache do Redis Enterprise.

Sintaxe

CreateClusterWithDatabase (Default)

New-AzRedisEnterpriseCache
    -ClusterName <String>
    -ResourceGroupName <String>
    -Location <String>
    -Sku <SkuName>
    [-SubscriptionId <String>]
    [-Capacity <Int32>]
    [-MinimumTlsVersion <TlsVersion>]
    [-Zone <String[]>]
    [-Tag <Hashtable>]
    [-Module <IModule[]>]
    [-ClientProtocol <Protocol>]
    [-Port <Int32>]
    [-EvictionPolicy <EvictionPolicy>]
    [-GroupNickname <String>]
    [-LinkedDatabase <ILinkedDatabase[]>]
    [-ClusteringPolicy <ClusteringPolicy>]
    [-AccessKeysAuthentication <AccessKeysAuthentication>]
    [-CustomerManagedKeyEncryptionKeyUrl <String>]
    [-HighAvailability <HighAvailability>]
    [-PublicNetworkAccess <PublicNetworkAccess>]
    [-IdentityType <ManagedServiceIdentityType>]
    [-IdentityUserAssignedIdentity <Hashtable>]
    [-KeyEncryptionKeyIdentityType <CmkIdentityType>]
    [-KeyEncryptionKeyIdentityUserAssignedIdentityResourceId <String>]
    [-AofPersistenceEnabled]
    [-AofPersistenceFrequency <AofFrequency>]
    [-RdbPersistenceEnabled]
    [-RdbPersistenceFrequency <RdbFrequency>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateClusterOnly

New-AzRedisEnterpriseCache
    -ClusterName <String>
    -ResourceGroupName <String>
    -Location <String>
    -Sku <SkuName>
    [-SubscriptionId <String>]
    [-Capacity <Int32>]
    [-MinimumTlsVersion <TlsVersion>]
    [-Zone <String[]>]
    [-Tag <Hashtable>]
    [-CustomerManagedKeyEncryptionKeyUrl <String>]
    [-HighAvailability <HighAvailability>]
    [-PublicNetworkAccess <PublicNetworkAccess>]
    [-IdentityType <ManagedServiceIdentityType>]
    [-IdentityUserAssignedIdentity <Hashtable>]
    [-KeyEncryptionKeyIdentityType <CmkIdentityType>]
    [-KeyEncryptionKeyIdentityUserAssignedIdentityResourceId <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-NoDatabase]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Cria ou atualiza um cluster de cache existente (substituir/recriar, com tempo de inatividade potencial) com um banco de dados associado.

Exemplos

Exemplo 1: Criar um cache Do Redis Enterprise

New-AzRedisEnterpriseCache -Name "MyCache" -ResourceGroupName "MyGroup" -Location "West US" -Sku "Enterprise_E10"
Location Name    Type                            Zone Database
-------- ----    ----                            ---- --------
West US  MyCache Microsoft.Cache/redisEnterprise      {default}

Esse comando cria um cache Redis Enterprise chamado MyCache com um banco de dados associado chamado padrão.

Exemplo 2: Criar um cache Redis Enterprise usando alguns parâmetros opcionais

New-AzRedisEnterpriseCache -Name "MyCache" -ResourceGroupName "MyGroup" -Location "East US" -Sku "Enterprise_E20" -Capacity 4 -MinimumTlsVersion "1.2" -Zone "1","2","3" -Tag @{"tag1" = "value1"} -Module "{name:RedisBloom, args:`"ERROR_RATE 0.00 INITIAL_SIZE 400`"}","{name:RedisTimeSeries, args:`"RETENTION_POLICY 20`"}","{name:RediSearch}" -ClientProtocol "Plaintext" -EvictionPolicy "NoEviction" -ClusteringPolicy "EnterpriseCluster" -AofPersistenceEnabled -AofPersistenceFrequency "1s"
Location Name    Type                            Zone      Database
-------- ----    ----                            ----      --------
East US  MyCache Microsoft.Cache/redisEnterprise {1, 2, 3} {default}

Esse comando cria um cache Redis Enterprise chamado MyCache com um banco de dados associado chamado padrão, usando alguns parâmetros opcionais.

Exemplo 3: Avançado – Criar um cluster de cache do Redis Enterprise sem um banco de dados associado

New-AzRedisEnterpriseCache -Name "MyCache" -ResourceGroupName "MyGroup" -Location "East US" -Sku "EnterpriseFlash_F300" -NoDatabase
Location Name    Type                            Zone Database
-------- ----    ----                            ---- --------
East US  MyCache Microsoft.Cache/redisEnterprise      {}

Aviso: esse comando cria um cluster de cache do Redis Enterprise chamado MyCache sem nenhum banco de dados associado para armazenar dados.

Exemplo 4: Criar um cache Redis Enterprise com um banco de dados georeplicado

New-AzRedisEnterpriseCache -Name "MyCache" -ResourceGroupName "MyGroup" -Location "West US" -Sku "Enterprise_E10" -ClientProtocol "Encrypted" -EvictionPolicy "NoEviction" -ClusteringPolicy "EnterpriseCluster" -GroupNickname "GroupNickname" -LinkedDatabase '{id:"/subscriptions/6b9ac7d2-7f6d-4de4-962c-43fda44bc3f2/resourceGroups/MyGroup/providers/Microsoft.Cache/redisEnterprise/MyCache/databases/default"}'
Location Name      Type                            Zone Database
-------- ----      ----                            ---- --------
West US  MyCache   Microsoft.Cache/redisEnterprise      {default}

Esse comando cria um nome de cache MyCache com um banco de dados georeplicado chamado padrão

Parâmetros

-AccessKeysAuthentication

Essa propriedade pode ser Habilitada/Desabilitada para permitir ou negar acesso com as chaves de acesso atuais. Pode ser atualizado mesmo após a criação do banco de dados.

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-AofPersistenceEnabled

[Versão prévia] Define se a persistência do AOF está habilitada. Depois de habilitar a persistência do AOF, você não poderá desabilitá-la. O suporte para desabilitar a persistência do AOF após a habilitação será adicionado posteriormente.

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-AofPersistenceFrequency

[Versão prévia] Define a frequência em que os dados são gravados em disco se a persistência do AOF estiver habilitada. Valores permitidos: 1s, sempre

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-AsJob

Executar o comando como um trabalho

Propriedades do parâmetro

Tipo:SwitchParameter
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:False
Valor dos argumentos restantes:False

-Capacity

O tamanho do cluster RedisEnterprise. O padrão é 2 ou 3 ou não aplicável dependendo da SKU. Os valores válidos são (2, 4, 6, ...) para SKUs Enterprise_* e (3, 9, 15, ...) para SKUs EnterpriseFlash_*. Não há suporte para outro argumento de capacidade de SKUs.

Propriedades do parâmetro

Tipo:Int32
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:Capacidade de SKU

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

-ClientProtocol

Especifica se os clientes redis podem se conectar usando protocolos redis criptografados por TLS ou de texto não criptografado – o padrão é Valores criptografados permitidos: Criptografado, Texto sem formatação

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-ClusteringPolicy

Política de clustering – o padrão é OSSCluster Especificado no momento da criação. Valores permitidos: EnterpriseCluster, OSSCluster

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-ClusterName

O nome do cluster Redis Enterprise.

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-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

-CustomerManagedKeyEncryptionKeyUrl

Chave de criptografia de chave url somente com versão. Por exemplo: https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78"

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:False
Valor dos argumentos restantes:False

-DefaultProfile

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

Propriedades do parâmetro

Tipo:PSObject
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases: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

-EvictionPolicy

Política de remoção redis - o padrão é VolatileLRU Valores permitidos: AllKeysLFU, AllKeysLRU, AllKeysRandom, VolatileLRU, VolatileLFU, VolatileTTL, VolatileRandom, NoEviction

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-GroupNickname

Nome do grupo de recursos de banco de dados vinculados

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-HighAvailability

Habilitado por padrão. Só pode ser atualizado de desabilitado para habilitado. Se a highAvailability estiver desabilitada, o conjunto de dados não será replicado. Isso afeta o SLA de disponibilidade e aumenta o risco de perda de dados.

Propriedades do parâmetro

Tipo:HighAvailability
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:False
Valor dos argumentos restantes:False

-IdentityType

Tipo de identidade de serviço gerenciado (em que os tipos SystemAssigned e UserAssigned são permitidos).

Propriedades do parâmetro

Tipo:ManagedServiceIdentityType
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:False
Valor dos argumentos restantes:False

-IdentityUserAssignedIdentity

O conjunto de identidades atribuídas pelo usuário associadas ao recurso. As chaves do dicionário userAssignedIdentities serão IDs de recurso do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores do dicionário podem ser objetos vazios ({}) em solicitações.

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:False
Valor dos argumentos restantes:False

-KeyEncryptionKeyIdentityType

Somente userAssignedIdentity tem suporte nesta versão da API; outros tipos podem ter suporte no futuro

Propriedades do parâmetro

Tipo:CmkIdentityType
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:False
Valor dos argumentos restantes:False

-KeyEncryptionKeyIdentityUserAssignedIdentityResourceId

Identidade atribuída pelo usuário a ser usada para acessar a URL da chave de criptografia de chave. Ex: /subscriptions/<sub uuid>/resourceGroups/<grupo de recursos>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId.

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:False
Valor dos argumentos restantes:False

-LinkedDatabase

Lista de recursos de banco de dados a serem vinculados a esse banco de dados Para construir, consulte a seção NOTES para propriedades GEOREPLICATIONLINKEDDATABASE e crie uma tabela de hash. Para construir, consulte a seção NOTES para propriedades LINKEDDATABASE e crie uma tabela de hash.

Propriedades do parâmetro

Tipo:

ILinkedDatabase[]

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

Conjuntos de parâmetros

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

-Location

A localização geográfica onde o recurso reside.

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:False
Valor dos argumentos restantes:False

-MinimumTlsVersion

A versão mínima do TLS para o cluster dar suporte – o padrão é 1.2 Valores permitidos: 1.0, 1.1, 1.2

Propriedades do parâmetro

Tipo:TlsVersion
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:False
Valor dos argumentos restantes:False

-Module

Conjunto opcional de módulos redis para habilitar neste banco de dados – os módulos só podem ser adicionados no momento da criação. Para construir, consulte a seção NOTES para propriedades MODULE e crie uma tabela de hash.

Propriedades do parâmetro

Tipo:

IModule[]

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

Conjuntos de parâmetros

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

-NoDatabase

Avançado – não crie automaticamente um banco de dados padrão. Aviso: o cache não será utilizável até que você crie um banco de dados.

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-NoWait

Execute o comando de forma assíncrona

Propriedades do parâmetro

Tipo:SwitchParameter
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:False
Valor dos argumentos restantes:False

-Port

Porta TCP do ponto de extremidade do banco de dados – o padrão é uma porta disponível especificada no momento da criação.

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-PublicNetworkAccess

Se o tráfego de rede pública pode ou não acessar o cluster do Redis. Somente 'Ativado' ou 'Desativado' podem ser definidos.

Propriedades do parâmetro

Tipo:PublicNetworkAccess
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:False
Valor dos argumentos restantes:False

-RdbPersistenceEnabled

[Versão prévia] Define se a persistência de RDB está habilitada. Depois de habilitar a persistência do RDB, você não poderá desabilitá-la. O suporte para desabilitar a persistência do RDB após a habilitação será adicionado posteriormente.

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-RdbPersistenceFrequency

[Versão prévia] Define a frequência na qual um instantâneo do banco de dados é criado se a persistência de RDB estiver habilitada. Valores permitidos: 1h, 6h, 12h

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-ResourceGroupName

O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.

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:False
Valor dos argumentos restantes:False

-Sku

O tipo de cluster RedisEnterprise a ser implantado. Valores aceitos: Balanced_B0, Balanced_B1, Balanced_B10, Balanced_B100, Balanced_B1000, Balanced_B150, Balanced_B20, Balanced_B250, Balanced_B3, Balanced_B350, Balanced_B5, Balanced_B50, Balanced_B500, Balanced_B700, ComputeOptimized_X10, ComputeOptimized_X100, ComputeOptimized_X150, ComputeOptimized_X20, ComputeOptimized_X250, ComputeOptimized_X3, ComputeOptimized_X350, ComputeOptimized_X5, ComputeOptimized_X50, ComputeOptimized_X500, ComputeOptimized_X700, EnterpriseFlash_F1500, EnterpriseFlash_F300, EnterpriseFlash_F700, Enterprise_E1, Enterprise_E10, Enterprise_E100, Enterprise_E20, Enterprise_E200, Enterprise_E400, Enterprise_E5, Enterprise_E50, FlashOptimized_A1000, FlashOptimized_A1500, FlashOptimized_A2000, FlashOptimized_A250, FlashOptimized_A4500, FlashOptimized_A500, FlashOptimized_A700, MemoryOptimized_M10, MemoryOptimized_M100, MemoryOptimized_M1000, MemoryOptimized_M150, MemoryOptimized_M1500, MemoryOptimized_ M20, MemoryOptimized_M2000, MemoryOptimized_M250, MemoryOptimized_M350, MemoryOptimized_M50, MemoryOptimized_M500, MemoryOptimized_M700

Propriedades do parâmetro

Tipo:SkuName
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:Nome do SKU

Conjuntos de parâmetros

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

-SubscriptionId

A ID da assinatura de destino.

Propriedades do parâmetro

Tipo:String
Valor padrão:(Get-AzContext).Subscription.Id
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:False
Valor dos argumentos restantes:False

-Tag

Marcas de recurso de cluster.

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

-Zone

As Zonas de Disponibilidade em que esse cluster será implantado.

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:False
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.

Saídas

ICluster