Set-AzRedisCache
Modifica un 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>]
[-Tag <Hashtable>]
[-IdentityType <String>]
[-UserAssignedIdentity <String[]>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrizione
Il cmdlet Set-AzRedisCache modifica un cache di Azure per Redis.
Esempio
Esempio 1: Modificare cache di Azure per Redis
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 denominata MyCache.
Esempio 2: Modificare cache di Azure per Redis : 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 di Azure per Redis. È anche possibile disabilitare la cache permanente di backup AOF.
Esempio 3: Modificare cache di Azure per Redis: 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 di Azure per Redis : 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 di Azure per Redis: 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 di Azure per Redis - 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 di Azure per Redis - Eseguire l'aggiornamento 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 di Azure per Redis - 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 di Azure per Redis. Per aumentare il numero di partizioni, è necessario prima abilitare il clustering.
Esempio 9: ridimensionare un'istanza di cache di Azure per Redis - Usare il cluster Redis per aumentare o ridurre le prestazioni.
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à utilizzata per il cache di Azure per Redis. 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 del cache di Azure per Redis 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 validi per questo parametro sono:
- rdb-backup-enabled. Specifica che la persistenza dei dati Redis è abilitata. Solo livello Premium.
- rdb-storage-connection-string. Specifica il 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.
- database. 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
- S2
- 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:
- Di base
- 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 delimitati da virgole da associare alla cache di Azure per Redis. 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 gli effetti dell'esecuzione del cmdlet. 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 |
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