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