Condividi tramite


New-AzRedisEnterpriseCache

Crea una cache Redis Enterprise.

Sintassi

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>]
   [-AccessKeysAuthentication <AccessKeysAuthentication>]
   [-CustomerManagedKeyEncryptionKeyUrl <String>]
   [-HighAvailability <HighAvailability>]
   [-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>]
   [-HighAvailability <HighAvailability>]
   [-IdentityType <ManagedServiceIdentityType>]
   [-IdentityUserAssignedIdentity <Hashtable>]
   [-KeyEncryptionKeyIdentityType <CmkIdentityType>]
   [-KeyEncryptionKeyIdentityUserAssignedIdentityResourceId <String>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-NoDatabase]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Crea o aggiorna un cluster di cache esistente (sovrascritto/ricreato, con potenziali tempi di inattività) con un database associato.

Esempio

Esempio 1: Creare una 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}

Questo comando crea una cache Redis Enterprise denominata MyCache con un database associato denominato default.

Esempio 2: Creare una cache Redis Enterprise usando alcuni parametri facoltativi

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}

Questo comando crea una cache Redis Enterprise denominata MyCache con un database associato denominato default, usando alcuni parametri facoltativi.

Esempio 3: Avanzate - Creare un cluster cache Redis Enterprise senza un database associato

New-AzRedisEnterpriseCache -Name "MyCache" -ResourceGroupName "MyGroup" -Location "East US" -Sku "EnterpriseFlash_F300" -NoDatabase

Location Name    Type                            Zone Database
-------- ----    ----                            ---- --------
East US  MyCache Microsoft.Cache/redisEnterprise      {}

Avviso: questo comando crea un cluster cache Redis Enterprise denominato MyCache senza database associato per contenere i dati.

Esempio 4: Creare una cache Redis Enterprise con un database con replica geografica

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}

Questo comando crea un nome di cache MyCache con un database con replica geografica denominata default

Parametri

-AccessKeysAuthentication

Questa proprietà può essere abilitata/disabilitata per consentire o negare l'accesso con le chiavi di accesso correnti. Può essere aggiornato anche dopo la creazione del database.

Tipo:AccessKeysAuthentication
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AofPersistenceEnabled

[Anteprima] Imposta un valore che indica se la persistenza AOF è abilitata. Dopo aver abilitato la persistenza AOF, non sarà possibile disabilitarla. Il supporto per la disabilitazione della persistenza AOF dopo l'abilitazione verrà aggiunto in un secondo momento.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AofPersistenceFrequency

[Anteprima] Imposta la frequenza con cui i dati vengono scritti su disco se la persistenza AOF è abilitata. Valori consentiti: 1s, sempre

Tipo:AofFrequency
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AsJob

Eseguire il comando come processo

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Capacity

Dimensioni del cluster RedisEnterprise. Il valore predefinito è 2 o 3 o non applicabile a seconda dello SKU. I valori validi sono (2, 4, 6, ...) per gli SKU Enterprise_* e (3, 9, 15, ...) per EnterpriseFlash_* SKU. Per altri argomenti di capacità SKU non è supportato.

Tipo:Int32
Alias:SkuCapacity
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ClientProtocol

Specifica se i client Redis possono connettersi usando protocolli TLS-encrypted o redis in testo non crittografato. Il valore predefinito è Encrypted Allowed values: Encrypted, Plaintext

Tipo:Protocol
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ClusteringPolicy

Criteri di clustering: il valore predefinito è OSSCluster specificato in fase di creazione. Valori consentiti: EnterpriseCluster, OSSCluster

Tipo:ClusteringPolicy
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ClusterName

Nome del cluster Redis Enterprise.

Tipo:String
Alias:Name
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CustomerManagedKeyEncryptionKeyUrl

Solo con versione dell'URL della chiave di crittografia della chiave. Ad esempio: https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78"

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Tipo:PSObject
Alias:AzureRMContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-EvictionPolicy

Criterio di rimozione redis: il valore predefinito è VolatileLRU Allowed values: AllKeysLFU, AllKeysLRU, AllKeysRandom, VolatileLRU, VolatileLFU, VolatileTTL, VolatileRandom, NoEviction

Tipo:EvictionPolicy
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-GroupNickname

Nome del gruppo di risorse del database collegato

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-HighAvailability

Abilitato per impostazione predefinita. Può essere aggiornato solo da disabilitato a abilitato. Se highAvailability è disabilitato, il set di dati non viene replicato. Ciò influisce sul contratto di servizio di disponibilità e aumenta il rischio di perdita di dati.

Tipo:HighAvailability
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-IdentityType

Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned).

Tipo:ManagedServiceIdentityType
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-IdentityUserAssignedIdentity

Set di identità assegnate dall'utente associate alla risorsa. Le chiavi del dizionario userAssignedIdentities saranno ID risorsa ARM nel formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. I valori del dizionario possono essere oggetti vuoti ({}) nelle richieste.

Tipo:Hashtable
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-KeyEncryptionKeyIdentityType

In questa versione dell'API è supportato solo userAssignedIdentity; altri tipi possono essere supportati in futuro

Tipo:CmkIdentityType
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-KeyEncryptionKeyIdentityUserAssignedIdentityResourceId

Identità assegnata dall'utente da usare per l'accesso all'URL della chiave di crittografia della chiave. Ad esempio: /subscriptions/<sub uuid>/resourceGroups/<gruppo di risorse>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-LinkedDatabase

Elenco delle risorse di database da collegare a questo database Per costruire, vedere la sezione NOTES per le proprietà GEOREPLICATIONLINKEDDATABASE e creare una tabella hash. Per costruire, vedere la sezione NOTES per le proprietà LINKEDDATABASE e creare una tabella hash.

Tipo:ILinkedDatabase[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Location

Posizione geografica in cui risiede la risorsa.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-MinimumTlsVersion

La versione minima di TLS per il supporto del cluster: il valore predefinito è 1.2 Valori consentiti: 1.0, 1.1, 1.2

Tipo:TlsVersion
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Module

Set facoltativo di moduli Redis da abilitare in questo database: i moduli possono essere aggiunti solo in fase di creazione. Per costruire, vedere la sezione NOTES per le proprietà MODULE e creare una tabella hash.

Tipo:IModule[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-NoDatabase

Avanzate: non creare automaticamente un database predefinito. Avviso: la cache non sarà utilizzabile fino a quando non si crea un database.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-NoWait

Eseguire il comando in modo asincrono

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Port

Porta TCP dell'endpoint del database: l'impostazione predefinita è una porta disponibile specificata in fase di creazione.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RdbPersistenceEnabled

[Anteprima] Imposta un valore che indica se la persistenza RDB è abilitata. Dopo aver abilitato la persistenza RDB, non sarà possibile disabilitarla. Il supporto per la disabilitazione della persistenza RDB dopo l'abilitazione verrà aggiunto in un secondo momento.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RdbPersistenceFrequency

[Anteprima] Imposta la frequenza con cui viene creato uno snapshot del database se la persistenza RDB è abilitata. Valori consentiti: 1h, 6h, 12h

Tipo:RdbFrequency
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ResourceGroupName

Nome del gruppo di risorse. Il nome non fa distinzione tra maiuscole e minuscole.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Sku

Tipo di cluster RedisEnterprise da distribuire. Valori accettati: 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

Tipo:SkuName
Alias:SkuName
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SubscriptionId

ID della sottoscrizione di destinazione.

Tipo:String
Posizione:Named
Valore predefinito:(Get-AzContext).Subscription.Id
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Tag

Tag delle risorse del cluster.

Tipo:Hashtable
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Zone

Zone di disponibilità in cui verrà distribuito il cluster.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Output

ICluster