New-AzRedisEnterpriseCache

Referência

Módulo:: Az.RedisEnterpriseCache

Cria um cache do Redis Enterprise.

Sintaxe

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

New-AzRedisEnterpriseCache
   -ClusterName <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Location <String>
   -Sku <SkuName>
   [-Capacity <Int32>]
   [-MinimumTlsVersion <TlsVersion>]
   [-Zone <String[]>]
   [-Tag <Hashtable>]
   [-CustomerManagedKeyEncryptionKeyUrl <String>]
   [-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 do Redis Enterprise chamado MyCache com um banco de dados associado chamado default.

Exemplo 2: criar um cache do 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 do Redis Enterprise chamado MyCache com um banco de dados associado chamado default, 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 do Redis Enterprise com um banco de dados replicado geograficamente

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}

Este comando cria um cache chamado MyCache com um banco de dados georreplicado chamado default

Parâmetros

-AofPersistenceEnabled

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

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-AofPersistenceFrequency

[Visualização] Define a freqüência com que os dados são gravados no disco se a persistência AOF estiver habilitada. Valores permitidos: 1s, sempre

Tipo:	AofFrequency
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-AsJob

Executar o comando como um trabalho

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Capacity

O tamanho do cluster do Redis Enterprise - o padrão é 2 ou 3, dependendo do SKU. Os valores permitidos são (2, 4, 6, ...) para SKUs Enterprise e (3, 9, 15, ...) para SKUs Flash.

Tipo:	Int32
Aliases:	SkuCapacity
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	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 é Criptografado Valores permitidos: Criptografado, Texto não criptografado

Tipo:	Protocol
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ClusteringPolicy

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

Tipo:	ClusteringPolicy
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ClusterName

O nome do cluster do Redis Enterprise.

Tipo:	String
Aliases:	Name
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Confirm

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

Tipo:	SwitchParameter
Aliases:	cf
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-CustomerManagedKeyEncryptionKeyUrl

Chave de criptografia de chave Somente URL versionada. Ex: https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78"

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-DefaultProfile

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

Tipo:	PSObject
Aliases:	AzureRMContext, AzureCredential
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-EvictionPolicy

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

Tipo:	EvictionPolicy
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-GroupNickname

Nome do grupo de recursos de banco de dados vinculados

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-IdentityType

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

Tipo:	ManagedServiceIdentityType
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-IdentityUserAssignedIdentity

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

Tipo:	Hashtable
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-KeyEncryptionKeyIdentityType

Somente userAssignedIdentity é compatível com esta versão da API; Outros tipos podem ser suportados no futuro

Tipo:	CmkIdentityType
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	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/<resource group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-LinkedDatabase

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

Tipo:	ILinkedDatabase[]
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Location

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

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	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

Tipo:	TlsVersion
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	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 NOTAS para propriedades MODULE e crie uma tabela de hash.

Tipo:	IModule[]
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-NoDatabase

Avançado - Não crie automaticamente um banco de dados padrão. Aviso: O cache não poderá ser usado até que você crie um banco de dados.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-NoWait

Execute o comando de forma assíncrona

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	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.

Tipo:	Int32
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-RdbPersistenceEnabled

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

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-RdbPersistenceFrequency

[Visualização] Define a frequência com que um instantâneo do banco de dados é criado se a persistência RDB estiver habilitada. Valores permitidos: 1h, 6h, 12h

Tipo:	RdbFrequency
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ResourceGroupName

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

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Sku

O tipo de cluster do Redis Enterprise a ser implantado. Valores permitidos: Enterprise_E1, Enterprise_E5, Enterprise_E10, Enterprise_E20, Enterprise_E50, Enterprise_E100, Enterprise_E200, Enterprise_E400.EnterpriseFlash_F300, EnterpriseFlash_F700, EnterpriseFlash_F1500

Tipo:	SkuName
Aliases:	SkuName
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-SubscriptionId

A ID da assinatura de destino.

Tipo:	String
Cargo:	Named
Valor padrão:	(Get-AzContext).Subscription.Id
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Tag

Marcas de recursos de cluster.

Tipo:	Hashtable
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-WhatIf

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

Tipo:	SwitchParameter
Aliases:	wi
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Zone

As zonas de disponibilidade em que esse cluster será implantado.

Tipo:	String[]
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

Saídas

ICluster

Compartilhar via