Set-AzRedisCache
Modifica una cache di Azure per Redis.
Sintassi
Set-AzRedisCache
[-ResourceGroupName <String>]
-Name <String>
[-Size <String>]
[-Sku <String>]
[-RedisConfiguration <Hashtable>]
[-EnableNonSslPort <Boolean>]
[-TenantSettings <Hashtable>]
[-ShardCount <Int32>]
[-MinimumTlsVersion <String>]
[-DisableAccessKeyAuthentication <Boolean>]
[-RedisVersion <String>]
[-UpdateChannel <String>]
[-ZonalAllocationPolicy <String>]
[-Tag <Hashtable>]
[-IdentityType <String>]
[-UserAssignedIdentity <String[]>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrizione
Il cmdlet Set-AzRedisCache modifica una cache di Azure per Redis.
Esempio
Esempio 1: Modificare Cache Redis di Azure
Set-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -RedisConfiguration @{"maxmemory-policy" = "allkeys-random"}
PrimaryKey : ******
SecondaryKey : ******
ResourceGroupName : mygroup
Id : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/myCache
Location : North Central US
Name : MyCache
Type : Microsoft.Cache/Redis
HostName : mycache.redis.cache.windows.net
Port : 6379
ProvisioningState : creating
SslPort : 6380
RedisConfiguration : {[maxmemory-policy, allkeys-random]}
EnableNonSslPort : False
RedisVersion : 2.8
Size : 250MB
Sku : Standard
Tag : {}
Zone : []
Questo comando aggiorna i criteri maxmemory per Cache Redis di Azure denominati MyCache.
Esempio 2: Modificare Cache Redis di Azure : se si vuole disabilitare la persistenza dei dati RDB o AOF.
Set-AzRedisCache -Name "MyCache" -RedisConfiguration @{"rdb-backup-enabled" = "false"}
PrimaryKey : ******
SecondaryKey : ******
ResourceGroupName : MyGroup
Id : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/MyCache
Location : Central US
Name : mycache
Type : Microsoft.Cache/Redis
HostName : mycache.redis.cache.windows.net
Port : 6379
ProvisioningState : Succeeded
SslPort : 6380
RedisConfiguration : {[maxmemory-policy, allkeys-random], [maxclients, 7500], [maxmemory-reserved, 200],
[maxfragmentationmemory-reserved, 300], [rdb-backup-enabled, false]...}
EnableNonSslPort : False
RedisVersion : 4.0.14
Size : 6GB
Sku : Premium
Tag : {}
Zone : []
Questo cmdlet disabilita la persistenza dei dati di backup RDB per Cache Redis di Azure. È anche possibile disabilitare la cache permanente di backup AOF.
Esempio 3: Modificare Cache Redis di Azure : se si vuole aggiungere la persistenza dei dati dopo la creazione della cache Redis di Azure.
Set-AzRedisCache -Name "MyCache" -RedisConfiguration @{"rdb-backup-enabled" = "true"; "rdb-storage-connection-string" = "DefaultEndpointsProtocol=https;AccountName=mystorageaccount;AccountKey=******;EndpointSuffix=mySuffix"; "rdb-backup-frequency" = "30"}
PrimaryKey : ******
SecondaryKey : ******
ResourceGroupName : MyGroup
Id : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/MyCache
Location : Central US
Name : mycache
Type : Microsoft.Cache/Redis
HostName : mycache.redis.cache.windows.net
Port : 6379
ProvisioningState : Succeeded
SslPort : 6380
RedisConfiguration : {[maxmemory-policy, allkeys-random], [maxclients, 7500], [maxmemory-reserved, 200],
[maxfragmentationmemory-reserved, 300], [rdb-backup-enabled, true]....}
EnableNonSslPort : False
RedisVersion : 4.0.14
Size : 6GB
Sku : Premium
Tag : {}
Zone : []
Questo cmdlet abilita la persistenza di rdb-backup in una cache già esistente. È anche possibile abilitare la persistenza di un backup di tipoof.you can also enable aof-backup persistence.
Esempio 4: Modificare Cache Redis di Azure : se si vuole modificare la frequenza di backup di rdb.
Ad esempio: attualmente si esegue uno snapshot RDB ogni 30 minuti, ma si vuole modificare per acquisire uno snapshot di 15 minuti.
Set-AzRedisCache -Name "MyCache" -RedisConfiguration @{"rdb-backup-frequency" = "15"}
PrimaryKey : ******
SecondaryKey : ******
ResourceGroupName : MyGroup
Id : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/MyCache
Location : Central US
Name : mycache
Type : Microsoft.Cache/Redis
HostName : mycache.redis.cache.windows.net
Port : 6379
ProvisioningState : Succeeded
SslPort : 6380
RedisConfiguration : {[maxmemory-policy, allkeys-random], [maxclients, 7500], [maxmemory-reserved, 200],
[maxfragmentationmemory-reserved, 300], [rdb-backup-enabled, true]....}
EnableNonSslPort : False
RedisVersion : 4.0.14
Size : 6GB
Sku : Premium
Tag : {}
Zone : []
Esempio 5: Modificare Cache Redis di Azure : se si vuole modificare la persistenza dei dati di backup AOF nel backup di RDB.
Set-AzRedisCache -Name "MyCache" -RedisConfiguration @{"aof-backup-enabled"= "false"; "rdb-backup-enabled" = "true"; "rdb-storage-connection-string" = "DefaultEndpointsProtocol=https;AccountName=mystorageaccount;AccountKey=******;EndpointSuffix=mySuffix"; "rdb-backup-frequency" = "30"}
PrimaryKey : ******
SecondaryKey : ******
ResourceGroupName : MyGroup
Id : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/MyCache
Location : Central US
Name : mycache
Type : Microsoft.Cache/Redis
HostName : mycache.redis.cache.windows.net
Port : 6379
ProvisioningState : Succeeded
SslPort : 6380
RedisConfiguration : {[maxmemory-policy, allkeys-random], [maxclients, 7500], [maxmemory-reserved, 200],
[maxfragmentationmemory-reserved, 300], [rdb-backup-enabled, true]....}
EnableNonSslPort : False
RedisVersion : 4.0.14
Size : 6GB
Sku : Premium
Tag : {}
Zone : []
Questo cmdlet consente di modificare il metodo di persistenza.
Esempio 6: Ridimensionare un'istanza di Cache Redis di Azure - Aggiornare a dimensioni diverse.
Set-AzRedisCache -Name "MyCache" -Size "P2" -Sku "Premium"
PrimaryKey : ******
SecondaryKey : ******
ResourceGroupName : MyGroup
Id : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/MyCache
Location : Central US
Name : mycache
Type : Microsoft.Cache/Redis
HostName : mycache.redis.cache.windows.net
Port : 6379
ProvisioningState : Scaling
SslPort : 6380
RedisConfiguration : {[maxmemory-policy, allkeys-random], [maxclients, 7500], [maxmemory-reserved, 200],
[maxfragmentationmemory-reserved, 300]....}
EnableNonSslPort : False
RedisVersion : 4.0.14
Size : 6GB
Sku : Premium
Tag : {}
Zone : []
Questo comando aumenta o riduce le dimensioni della memoria dell'istanza.
Esempio 7: Ridimensionare un'istanza di Cache Redis di Azure - Aggiornare a un livello diverso.
Set-AzRedisCache -Name "MyCache" -Size "P1" -Sku "Premium"
PrimaryKey : ******
SecondaryKey : ******
ResourceGroupName : MyGroup
Id : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/MyCache
Location : Central US
Name : mycache
Type : Microsoft.Cache/Redis
HostName : mycache.redis.cache.windows.net
Port : 6379
ProvisioningState : Scaling
SslPort : 6380
RedisConfiguration : {[maxmemory-policy, allkeys-random], [maxclients, 7500], [maxmemory-reserved, 200],
[maxfragmentationmemory-reserved, 300]....}
EnableNonSslPort : False
RedisVersion : 4.0.14
Size : 1GB
Sku : Standard
Tag : {}
Zone : []
Questo comando consente di modificare il livello della cache. È possibile passare da Basic a Standard o Standard a Premium.
Esempio 8: Ridimensionare un'istanza di Cache Redis di Azure - Abilitare il clustering Redis.
Set-AzRedisCache -Name "MyCache" -ShardCount 1
PrimaryKey : ******
SecondaryKey : ******
ResourceGroupName : MyGroup
Id : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/MyCache
Location : Central US
Name : mycache
Type : Microsoft.Cache/Redis
HostName : mycache.redis.cache.windows.net
Port : 6379
ProvisioningState : Scaling
SslPort : 6380
RedisConfiguration : {[maxmemory-policy, allkeys-random], [maxclients, 7500], [maxmemory-reserved, 200],
[maxfragmentationmemory-reserved, 300]....}
EnableNonSslPort : False
RedisVersion : 4.0.14
Size : 6GB
Sku : Premium
ShardCount :
Tag : {}
Zone : []
Questo cmdlet consente di abilitare il clustering per l'istanza di Cache Redis di Azure. Per aumentare il numero di partizioni, è necessario prima abilitare il clustering.
Esempio 9: Ridimensionare un'istanza di Cache Redis di Azure - Usare il cluster Redis per aumentare o ridurre il numero di istanze.
Set-AzRedisCache -Name "MyCache" -ShardCount 2
PrimaryKey : ******
SecondaryKey : ******
ResourceGroupName : MyGroup
Id : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/MyCache
Location : Central US
Name : mycache
Type : Microsoft.Cache/Redis
HostName : mycache.redis.cache.windows.net
Port : 6379
ProvisioningState : Scaling
SslPort : 6380
RedisConfiguration : {[maxmemory-policy, allkeys-random], [maxclients, 7500], [maxmemory-reserved, 200],
[maxfragmentationmemory-reserved, 300]....}
EnableNonSslPort : False
RedisVersion : 4.0.14
Size : 6GB
Sku : Premium
ShardCount : 1
Tag : {}
Zone : []
Questo comando aumenta o riduce le dimensioni del cluster.
Parametri
-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 |
-DefaultProfile
Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.
Tipo: | IAzureContextContainer |
Alias: | AzContext, AzureRmContext, AzureCredential |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-DisableAccessKeyAuthentication
Facoltativo: l'autenticazione a Redis tramite chiavi di accesso è disabilitata se impostata su true. Il valore predefinito è false.
Tipo: | String |
Posizione: | Named |
Valore predefinito: | false |
Necessario: | False |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-EnableNonSslPort
Indica se la porta non SSL è abilitata. Il valore predefinito è $False (la porta non SSL è disabilitata).
Tipo: | Nullable<T>[Boolean] |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-IdentityType
Specifica il tipo di identità usata per Cache Redis di Azure. Valori validi: "SystemAssigned" o "UserAssigned" o "SystemAssignedUserAssigned" o "Nessuno"
Tipo: | String |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-MinimumTlsVersion
Specificare la versione TLS richiesta dai client per connettersi alla cache.
Tipo: | String |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-Name
Specifica il nome della Cache Redis di Azure da aggiornare.
Tipo: | String |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | True |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-RedisConfiguration
Specifica le impostazioni di configurazione di Redis. I valori accettabili per questo parametro sono:
- rdb-backup-enabled. Specifica che la persistenza dei dati Redis è abilitata. Solo livello Premium.
- rdb-storage-connection-string. Specifica la stringa di connessione all'account di archiviazione per la persistenza dei dati Redis. Solo livello Premium.
- rdb-backup-frequency. Specifica la frequenza di backup per la persistenza dei dati Redis. Solo livello Premium.
- maxmemory-reserved. Configura la memoria riservata per i processi non della cache. Livelli Standard e Premium.
- maxmemory-policy. Configura i criteri di rimozione per la cache. Tutti i piani tariffari.
- notify-keyspace-events. Configura le notifiche keyspace. Livelli Standard e Premium.
- hash-max-ziplist-entries. Configura l'ottimizzazione della memoria per i tipi di dati aggregati di piccole dimensioni. Livelli Standard e Premium.
- hash-max-ziplist-value. Configura l'ottimizzazione della memoria per i tipi di dati aggregati di piccole dimensioni. Livelli Standard e Premium.
- set-max-intset-entries. Configura l'ottimizzazione della memoria per i tipi di dati aggregati di piccole dimensioni. Livelli Standard e Premium.
- zset-max-ziplist-entries. Configura l'ottimizzazione della memoria per i tipi di dati aggregati di piccole dimensioni. Livelli Standard e Premium.
- zset-max-ziplist-value. Configura l'ottimizzazione della memoria per i tipi di dati aggregati di piccole dimensioni. Livelli Standard e Premium.
- banche dati. Configura il numero di database. Questa proprietà può essere configurata solo durante la creazione della cache. Livelli Standard e Premium. Per altre informazioni, vedere Gestire Cache Redis di Azure con Azure PowerShellhttp://go.microsoft.com/fwlink/?LinkId=800051 (http://go.microsoft.com/fwlink/?LinkId=800051).
- preferred-data-archive-auth-method Metodo di autenticazione preferito per comunicare con l'account di archiviazione usato per l'archivio dati, specificare firma di accesso condiviso o ManagedIdentity. Il valore predefinito è SAS
- preferred-data-persistence-auth-method Metodo di autenticazione preferito per comunicare con l'account di archiviazione usato per la persistenza dei dati, specificare firma di accesso condiviso o ManagedIdentity, il valore predefinito è SAS
Tipo: | Hashtable |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-RedisVersion
Versione di Redis. Deve essere nel formato 'major[.minor]' (è necessario solo 'major' ) o il valore 'latest' che fa riferimento alla versione stabile più recente di Redis disponibile. Versioni supportate: 4.0, 6.0 (versione più recente). Il valore predefinito è 'latest'.
Tipo: | String |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-ResourceGroupName
Specifica il nome del gruppo di risorse che contiene la Cache Redis.
Tipo: | String |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-ShardCount
Specifica il numero di partizioni da creare in una cache del cluster Premium.
Tipo: | Nullable<T>[Int32] |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-Size
Specifica le dimensioni della cache Redis. I valori validi sono:
- P1
- P2
- P3
- P4
- P5
- C0
- C1
- C2
- C3
- C4
- C5
- C6
- 250 MB
- 1 GB
- 2,5 GB
- 6 GB
- 13 GB
- 26 GB
- 53 GB
- 120 GB Il valore predefinito è 1GB o C1.
Tipo: | String |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-Sku
Specifica lo SKU della cache Redis da creare. I valori validi sono:
- Basico
- Standard
- Premium Il valore predefinito è Standard.
Tipo: | String |
Valori accettati: | Basic, Standard, Premium |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-Tag
Tabella hash che rappresenta i tag.
Tipo: | Hashtable |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-TenantSettings
Questo parametro è stato deprecato.
Tipo: | Hashtable |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-UpdateChannel
Facoltativo: specifica il canale di aggiornamento per gli aggiornamenti mensili di Redis che la cache Redis riceverà. Le cache che usano il canale di aggiornamento 'Anteprima' ottengono gli aggiornamenti di Redis più recenti almeno 4 settimane prima delle cache dei canali 'Stable'. Il valore predefinito è 'Stable'. I valori possibili includono: 'Stable', 'Preview'
Tipo: | String |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-UserAssignedIdentity
Specifica una o più identità utente seterate da associare a Cache Redis di Azure. I riferimenti all'identità utente saranno id risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identities/{identityName}'
Tipo: | String[] |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | True |
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 |
-ZonalAllocationPolicy
Facoltativo: facoltativo: specifica la modalità di allocazione delle zone di disponibilità alla cache Redis. "Automatico" abilita la ridondanza della zona e Azure selezionerà automaticamente le zone in base alla disponibilità e alla capacità a livello di area. 'UserDefined' selezionerà le zone di disponibilità passate usando il parametro 'zones'. 'NoZones' produrrà una cache non di zona. Se 'zonalAllocationPolicy' non viene passato, verrà impostato su 'UserDefined' quando le zone vengono passate; in caso contrario, verrà impostata su 'Automatico' nelle aree in cui le zone sono supportate e 'NoZones' nelle aree in cui le zone non sono supportate.
Tipo: | String |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
Input
Nullable<T>[[System.Boolean, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]
Nullable<T>[[System.Int32, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]
Output
RedisCacheAttributesWithAccessKeys