New-AzRedisEnterpriseCache
Cria um cache Redis Enterprise.
Sintaxe
CreateClusterWithDatabase (Predefinição)
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 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}
Este comando cria um cache Redis Enterprise chamado MyCache com um banco de dados associado chamado default.
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}
Este comando cria um cache 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 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: Este comando cria um cluster de cache Redis Enterprise chamado MyCache sem nenhum banco de dados associado para armazenar dados.
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 nome de cache MyCache com um banco de dados replicado geograficamente chamado padrão
Parâmetros
-AccessKeysAuthentication
Esta 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 dos parâmetros
Conjuntos de parâmetros
CreateClusterWithDatabase
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-AofPersistenceEnabled
[Pré-visualização] Define se a persistência do AOF está habilitada.
Depois de ativar a persistência AOF, você não poderá desativá-la.
O suporte para desativar a persistência do AOF após a ativação será adicionado posteriormente.
Propriedades dos parâmetros
Tipo: SwitchParameter
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
CreateClusterWithDatabase
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-AofPersistenceFrequency
[Pré-visualização] Define a frequência com que os dados são gravados no disco se a persistência do AOF estiver habilitada.
Valores permitidos: 1s, sempre
Propriedades dos parâmetros
Tipo: AofFrequency
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
CreateClusterWithDatabase
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-AsJob
Executar o comando como um trabalho
Propriedades dos parâmetros
Tipo: SwitchParameter
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-Capacity
O tamanho do cluster RedisEnterprise.
O padrão é 2 ou 3 ou não se aplica dependendo da SKU. Os valores válidos são (2, 4, 6, ...) para Enterprise_* SKUs e (3, 9, 15, ...) para EnterpriseFlash_* SKUs.
Para outros SKUs, o argumento de capacidade não é suportado.
Propriedades dos parâmetros
Tipo: Int32
Default value: None Suporta carateres universais: False NãoMostrar: False Aliases: Capacidade de Sku
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-ClientProtocol
Especifica se os clientes redis podem se conectar usando protocolos redis criptografados por TLS ou texto sem formatação - o padrão é Criptografado Valores permitidos: Criptografado, Texto sem formatação
Propriedades dos parâmetros
Tipo: Protocol
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
CreateClusterWithDatabase
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-ClusteringPolicy
Política de clustering - o padrão é OSSCluster Especificado no momento da criação.
Valores permitidos: EnterpriseCluster, OSSCluster
Propriedades dos parâmetros
Tipo: ClusteringPolicy
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
CreateClusterWithDatabase
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-ClusterName
O nome do cluster Redis Enterprise.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False Aliases: Nome
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-Confirm
Solicita confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
Tipo: SwitchParameter
Default value: None Suporta carateres universais: False NãoMostrar: False Aliases: Cf.
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-CustomerManagedKeyEncryptionKeyUrl
Somente URL da chave de criptografia de chave.
Por exemplo: https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78"
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.
Propriedades dos parâmetros
Tipo: PSObject
Default value: None Suporta carateres universais: False NãoMostrar: False Aliases: AzureRMContext, AzureCredential
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-EvictionPolicy
Política de despejo Redis - o padrão é VolatileLRU Valores permitidos: AllKeysLFU, AllKeysLRU, AllKeysRandom, VolatileLRU, VolatileLFU, VolatileTTL, VolatileRandom, NoEviction
Propriedades dos parâmetros
Tipo: EvictionPolicy
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
CreateClusterWithDatabase
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-GroupNickname
Nome do grupo de recursos de banco de dados vinculados
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
CreateClusterWithDatabase
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-HighAvailability
Ativado por padrão.
Só pode ser atualizado de desativado para ativado.
Se highAvailability estiver desabilitado, o conjunto de dados não será replicado.
Isso afeta o SLA de disponibilidade e aumenta o risco de perda de dados.
Propriedades dos parâmetros
Tipo: HighAvailability
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-IdentityType
Tipo de identidade de serviço gerenciado (onde os tipos SystemAssigned e UserAssigned são permitidos).
Propriedades dos parâmetros
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: 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 ARM no formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}.
Os valores de dicionário podem ser objetos vazios ({}) em solicitações.
Propriedades dos parâmetros
Tipo: Hashtable
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-KeyEncryptionKeyIdentityType
Somente userAssignedIdentity é suportado nesta versão da API; Outros tipos podem ser suportados no futuro
Propriedades dos parâmetros
Tipo: CmkIdentityType
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-KeyEncryptionKeyIdentityUserAssignedIdentityResourceId
Identidade atribuída pelo usuário a ser usada para acessar a chave de criptografia de chave Url.
Ex: /subscriptions/<sub uuid>/resourceGroups/<grupo de recursos>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: 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.
Propriedades dos parâmetros
Tipo: ILinkedDatabase [ ]
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
CreateClusterWithDatabase
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-Location
A geolocalização onde o recurso vive.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-MinimumTlsVersion
A versão TLS mínima para o cluster suportar - o padrão é 1.2 Valores permitidos: 1.0, 1.1, 1.2
Propriedades dos parâmetros
Tipo: TlsVersion
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: 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.
Propriedades dos parâmetros
Tipo: IModule [ ]
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
CreateClusterWithDatabase
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: 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 dos parâmetros
Tipo: SwitchParameter
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
CreateClusterOnly
Position: Named Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-NoWait
Execute o comando de forma assíncrona
Propriedades dos parâmetros
Tipo: SwitchParameter
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: 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 dos parâmetros
Tipo: Int32
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
CreateClusterWithDatabase
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-PublicNetworkAccess
Se o tráfego de rede pública pode ou não acessar o cluster Redis.
Apenas 'Ativado' ou 'Desativado' pode ser definido.
Propriedades dos parâmetros
Tipo: PublicNetworkAccess
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-RdbPersistenceEnabled
[Pré-visualização] Define se a persistência RDB está habilitada.
Depois de ativar a persistência RDB, você não poderá desativá-la.
O suporte para desativar a persistência RDB após a ativação será adicionado posteriormente.
Propriedades dos parâmetros
Tipo: SwitchParameter
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
CreateClusterWithDatabase
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-RdbPersistenceFrequency
[Pré-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
Propriedades dos parâmetros
Tipo: RdbFrequency
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
CreateClusterWithDatabase
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-ResourceGroupName
O nome do grupo de recursos.
O nome não diferencia maiúsculas de minúsculas.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-Sku
O tipo de cluster RedisEnterprise a ser implantado.
Valores aceites: 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 dos parâmetros
Tipo: SkuName
Default value: None Suporta carateres universais: False NãoMostrar: False Aliases: Nome do SKU
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-SubscriptionId
A ID da assinatura de destino.
Propriedades dos parâmetros
Tipo: String
Default value: (Get-AzContext).Subscription.Id Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-Tag
Tags de recursos de cluster.
Propriedades dos parâmetros
Tipo: Hashtable
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado.
O cmdlet não é executado.
Propriedades dos parâmetros
Tipo: SwitchParameter
Default value: None Suporta carateres universais: False NãoMostrar: False Aliases: Wi
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-Zone
As zonas de disponibilidade onde esse cluster será implantado.
Propriedades dos parâmetros
Tipo: String [ ]
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: 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
