Set-AzRedisCache
Ändert einen Azure-Cache für Redis.
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>]
Das cmdlet Set-AzRedisCache ändert einen Azure-Cache für 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 : []
Mit diesem Befehl wird die Maxmemory-Richtlinie für Ihren Azure Cache fo Redis mit dem Namen MyCache-aktualisiert.
Beispiel 2: Ändern des Azure-Caches für Redis – Wenn Sie RDB- oder AOF-Datenpersistenz deaktivieren möchten.
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 : []
Mit diesem Cmdlet werden RDB-Sicherungsdatenpersistenz für Azure Cache für Redis deaktiviert. Sie können auch den beständigen AOF-Sicherungscache deaktivieren.
Beispiel 3: Ändern des Azure-Caches für Redis – Wenn Sie die Datenpersistenz nach dem Erstellen des Azure Redis-Caches hinzufügen möchten.
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 : []
Dieses Cmdlet ermöglicht rdb-backup-Persistenz für einen bereits vorhandenen Cache. Sie können auch die Persistenz von Aofsicherungen aktivieren.
Beispiel: Derzeit nehmen Sie eine RDB-Momentaufnahme in jeder 30 Minute auf, möchten aber ändern, um momentaufnahmen 15 Minuten zu erstellen.
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 : []
Beispiel 5: Ändern des Azure-Caches für Redis – Wenn Sie die AOF-Sicherung der Datenpersistenz in RDB-Sicherung ändern möchten.
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 : []
Dieses Cmdlet hilft beim Ändern der Persistenzmethode.
Beispiel 6: Skalieren eines Azure-Caches für Redis-Instanz – Aktualisieren auf unterschiedliche Größe.
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 : []
Dieser Befehl erhöht oder verringert die Speichergröße Ihrer Instanz.
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 : []
Mit diesem Befehl können Sie die Ebene des Caches ändern. Sie können von "Basic" zu "Standard" oder "Standard" zu "Premium" wechseln.
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 : []
Dieses Cmdlet hilft Ihnen beim Aktivieren des Clusterings für Ihre Azure Cache für Redis-Instanz. Um die Shardanzahl zu erhöhen, muss zuerst das Clustering aktiviert werden.
Beispiel 9: Skalieren eines Azure-Caches für Redis-Instanz – Verwenden Sie Redis Cluster zum Skalieren in/out.
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 : []
Dieser Befehl erhöht oder verkleinert die Clustergröße.
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
Typ: | SwitchParameter |
Aliase: | cf |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.
Typ: | IAzureContextContainer |
Aliase: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Optional: Die Authentifizierung bei Redis über Zugriffstasten ist deaktiviert, wenn sie auf "true" festgelegt ist. Der Standardwert ist "false".
Typ: | String |
Position: | Named |
Standardwert: | false |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
Gibt an, ob der nicht-SSL-Port aktiviert ist. Der Standardwert ist $False (der nicht-SSL-Port ist deaktiviert).
Typ: | Nullable<T>[Boolean] |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
Gibt den Identitätstyp an, der für den Azure-Cache für Redis verwendet wird. Gültige Werte: "SystemAssigned" oder "UserAssigned" oder "SystemAssignedUserAssigned" oder "None"
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
Geben Sie die tls-Version an, die von Clients zum Herstellen einer Verbindung mit dem Cache erforderlich ist.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
Gibt den Namen des zu aktualisierenden Azure-Caches für Redis an.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
Gibt Redis-Konfigurationseinstellungen an. Die zulässigen Werte für diesen Parameter sind:
- rdb-backup-enabled. Gibt an, dass Redis-Datenpersistenz aktiviert ist. Nur Premium-Stufe.
- rdb-storage-connection-string. Gibt die Verbindungszeichenfolge mit dem Speicherkonto für Redis-Datenpersistenz an. Nur Premium-Stufe.
- rdb-backup-frequency. Gibt die Sicherungshäufigkeit für Redis-Datenpersistenz an. Nur Premium-Stufe.
- maxmemory-reserved. Konfiguriert den Speicher, der für Nicht-Cache-Prozesse reserviert ist. Standard- und Premium-Stufen.
- maxmemory-policy. Konfiguriert die Eviction-Richtlinie für den Cache. Alle Preisstufen.
- notify-keyspace-events. Konfiguriert Zugriffstastenbenachrichtigungen. Standard- und Premium-Stufen.
- hash-max-ziplist-entries. Konfiguriert die Speicheroptimierung für kleine aggregierte Datentypen. Standard- und Premium-Stufen.
- hash-max-ziplist-value. Konfiguriert die Speicheroptimierung für kleine aggregierte Datentypen. Standard- und Premium-Stufen.
- set-max-intset-entries. Konfiguriert die Speicheroptimierung für kleine aggregierte Datentypen. Standard- und Premium-Stufen.
- zset-max-ziplist-entries. Konfiguriert die Speicheroptimierung für kleine aggregierte Datentypen. Standard- und Premium-Stufen.
- zset-max-ziplist-value. Konfiguriert die Speicheroptimierung für kleine aggregierte Datentypen. Standard- und Premium-Stufen.
- Datenbanken. Konfiguriert die Anzahl der Datenbanken. Diese Eigenschaft kann nur bei der Cacheerstellung konfiguriert werden. Standard- und Premium-Stufen. Weitere Informationen finden Sie unter Verwalten des Azure Redis-Caches mit Azure PowerShellhttp://go.microsoft.com/fwlink/?LinkId=800051 (http://go.microsoft.com/fwlink/?LinkId=800051).
- preferred-data-archive-auth-method Preferred auth method to communicate to storage account used for data archive, specify SAS or ManagedIdentity, default value is SAS
- preferred-data-persistence-auth-method Preferred auth method to communicate to storage account used for data persistence, specify SAS or ManagedIdentity, default value is SAS
Typ: | Hashtable |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
Redis-Version. Dies sollte in Form von "major[.minor]" (nur "major" erforderlich) oder der Wert "latest" sein, der auf die neueste stabile Redis-Version verweist, die verfügbar ist. Unterstützte Versionen: 4.0, 6.0 (neueste Version). Der Standardwert ist "latest".
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
Gibt den Namen der Ressourcengruppe an, die den Redis-Cache enthält.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
Gibt die Anzahl von Shards an, die in einem Premium-Clustercache erstellt werden sollen.
Typ: | Nullable<T>[Int32] |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
Gibt die Größe des Redis-Caches an. Gültige Werte sind:
- 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 Der Standardwert ist 1 GB oder C1.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
Gibt die SKU des zu erstellenden Redis-Caches an. Gültige Werte sind:
- Grundlegend
- Norm
- Premium Der Standardwert ist "Standard".
Typ: | String |
Zulässige Werte: | Basic, Standard, Premium |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
Eine Hashtabelle, die Tags darstellt.
Typ: | Hashtable |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
Dieser Parameter ist veraltet.
Typ: | Hashtable |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
Optional: Gibt den Updatekanal für die monatlichen Redis-Updates an, die Ihr Redis-Cache empfängt. Caches mit dem Updatekanal "Vorschau" erhalten mindestens 4 Wochen vor den Caches des "Stable"-Kanals die neuesten Redis-Updates. Der Standardwert ist "Stable". Mögliche Werte sind: "Stable", "Preview"
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
Gibt eine oder mehrere durch Trennzeichen getrennte Benutzeridentitäten an, die dem Azure-Cache für Redis zugeordnet werden sollen. Die Benutzeridentitätsverweise sind ARM-Ressourcen-IDs in der Form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identities/{identityName}'
Typ: | String[] |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Typ: | SwitchParameter |
Aliase: | wi |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Optional: Gibt an, wie Verfügbarkeitszonen dem Redis-Cache zugeordnet werden. "Automatisch" ermöglicht Zonenredundanz, und Azure wählt automatisch Zonen basierend auf regionaler Verfügbarkeit und Kapazität aus. "UserDefined" wählt Verfügbarkeitszonen aus, die mit dem Parameter "zones" übergeben werden. "NoZones" erzeugt einen nicht zonalen Cache. Wenn "zonalAllocationPolicy" nicht übergeben wird, wird sie auf "UserDefined" festgelegt, wenn Zonen übergeben werden, andernfalls wird sie in Regionen, in denen Zonen unterstützt werden, und 'NoZones' in Regionen festgelegt, in denen Zonen nicht unterstützt werden.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
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]]
Feedback zu Azure PowerShell
Azure PowerShell ist ein Open Source-Projekt. Wählen Sie einen Link aus, um Feedback zu geben: