New-AzRedisCache
Erstellt einen Redis-Cache.
Syntax
New-AzRedisCache
-ResourceGroupName <String>
-Name <String>
-Location <String>
[-Size <String>]
[-Sku <String>]
[-RedisConfiguration <Hashtable>]
[-EnableNonSslPort <Boolean>]
[-TenantSettings <Hashtable>]
[-ShardCount <Int32>]
[-MinimumTlsVersion <String>]
[-DisableAccessKeyAuthentication <Boolean>]
[-SubnetId <String>]
[-StaticIP <String>]
[-Tag <Hashtable>]
[-Zone <String[]>]
[-RedisVersion <String>]
[-UpdateChannel <String>]
[-ZonalAllocationPolicy <String>]
[-IdentityType <String>]
[-UserAssignedIdentity <String[]>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Das cmdlet New-AzRedisCache erstellt einen Azure Redis Cache.
Beispiele
Beispiel 1: Erstellen eines Redis-Caches
New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "North Central US"
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 : {}
EnableNonSslPort : False
RedisVersion : 2.8
Size : 1GB
Sku : Standard
Tag : {}
Zone : []
Mit diesem Befehl wird ein Redis-Cache erstellt.
Beispiel 2: Erstellen eines Standard-SKU-Redis-Caches
New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "North Central US" -Size 250MB -Sku "Standard" -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 Cmdlet wird ein Cache mit Azure Cache für Redis erstellt.
Beispiel 3: Erstellen eines redundanten Zonencaches
New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "Central US" -Size P1 -Sku "Premium" -Zone @("1","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 : creating
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 : {1, 2}
Mit diesem Befehl wird der Azure-Cache für Redis-Instanz in Mutliplezonen erstellt.
Beispiel 4: Erstellen eines virtuellen Netzwerks zum Aktivieren des Caches
Anforderungen für das Erstellen des Caches für virtuelle Netzwerke.
- Erstellen Sie das virtuelle Netzwerk in derselben Ressourcengruppe, in der Sie den Redis-Cache erstellen möchten. Sie können ein virtuelles Netzwerk aus New-AzVirtualNetwork PowerShell-Befehl erstellen.
- Sie benötigen Subnetz-ID für den VNET-Aktivierungscache. Die Syntax der Subnetz-ID wird unten angegeben.
Format der Subnetz-ID: /subscriptions/{subid}/resourceGroups/{resourceGroupName}/providers/Microsoft.ClassicNetwork/VirtualNetworks/{vnetName}/subnets/{subnetName}
New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "Central US" -Size P1 -Sku "Premium" -SubnetId "/subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Network/virtualNetworks/MyNet/subnets/MySubnet"
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 : creating
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
SubnetId : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Network/virtualNetworks/MyNet/subnets/MySubnet
StaticIP : 10.0.0.4
Tag : {}
Zone : []
Beispiel 5: Konfigurieren der Datenpersistenz für einen Premium Azure-Cache für Redis
Persistenz schreibt Redis-Daten in ein Azure Storage-Konto, das Sie besitzen und verwalten. Bevor Sie also die Datenpersistenz konfigurieren, müssen Sie Speicherkonto in derselben Ressourcengruppe haben. Wählen Sie ein Speicherkonto in derselben Region und einem Abonnement wie der Cache aus, und ein Premium-Speicherkonto wird empfohlen, da Premium-Speicher einen höheren Durchsatz aufweist.
Rufen Sie nach dem Erstellen eines Speicherkontos die Verbindungszeichenfolge des Speicherkontos mithilfe dieses Verfahrens ab.
- Führen Sie diesen Befehl Get-AzStorageAccountKey -ResourceGroupName $resourceGroupName -Name $storageAccountName in PowerShell aus.
- Kopieren Sie aus der obigen Ausgabe einen beliebigen Schlüssel.
- Platzieren Sie den Speicherkontoschlüssel und den Namen des Speicherkontos im folgenden Format, um die Verbindungszeichenfolge Ihres Speicherkontos abzurufen.
Verbindungszeichenfolgenformat :- "DefaultEndpointsProtocol=https; AccountName={storageAccountName}; AccountKey={storageAccountKey}; EndpointSuffix=mySuffix"
Sie müssen über die spezifischen Redis-Konfigurationseinstellungen verfügen, um die Datenpersistenz zu aktivieren.
Aktivieren der RDB-Sicherung
- rdb-backup-enabled (Set true or false)
- rdb-storage-connection-string (Verbindungszeichenfolge im obigen Format übergeben.)
- rdb-backup-frequency (Legen Sie ein Sicherungsintervall in Minuten fest. Sie können nur zwischen - 15, 30, 60, 360, 720 und 1440 Minuten wählen.)
New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "Central US" -Size P1 -Sku "Premium" -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 : creating
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 6: Konfigurieren der Datenpersistenz für einen Premium Azure-Cache für Redis – AOF-Sicherung aktiviert
Für AOF-Sicherung aktiviert.
- aof-backup-enabled (Set true or false),
- aof-storage-connection-string-0 (Verbindungszeichenfolge im obigen Format übergeben.)
- aof-storage-connection-string-1 (Sie können optional ein anderes Speicherkonto konfigurieren. Wenn ein zweites Speicherkonto konfiguriert ist, werden die Schreibvorgänge in den Replikatcache in dieses zweite Speicherkonto geschrieben.)
New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "Central US" -Size P1 -Sku "Premium" -RedisConfiguration @{"aof-backup-enabled" = "true"; "aof-storage-connection-string-0" = "DefaultEndpointsProtocol=https;AccountName=mystorageaccount;AccountKey=******;EndpointSuffix=mySuffix"}
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 : creating
SslPort : 6380
RedisConfiguration : {[maxmemory-policy, allkeys-random], [maxclients, 7500], [maxmemory-reserved, 200],
[maxfragmentationmemory-reserved, 300], [aof-backup-enabled, true]...}
EnableNonSslPort : False
RedisVersion : 4.0.14
Size : 6GB
Sku : Premium
Tag : {}
Zone : []
Parameter
-Confirm
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 |
-DefaultProfile
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 |
-DisableAccessKeyAuthentication
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 |
-EnableNonSslPort
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 |
-IdentityType
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 |
-Location
Gibt den Speicherort an, an dem ein Redis-Cache erstellt werden soll. Gültige Werte sind:
- Nord-Mittel-USA
- Süd-Mittel-USA
- Zentral-USA
- Westeuropa
- Nordeuropa
- USA (Westen)
- Ost-USA
- Ost-USA 2
- Japan Ost
- Japan West
- Brasilien Süd
- Südostasien
- Ostasien
- Australien Ost
- Australien Südosten
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-MinimumTlsVersion
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 |
-Name
Gibt den Namen des zu erstellenden Redis-Caches an.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-RedisConfiguration
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 |
-RedisVersion
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 |
-ResourceGroupName
Gibt den Namen der Ressourcengruppe an, in der der Redis-Cache erstellt werden soll.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-ShardCount
Gibt die Anzahl von Shards an, die in einem Premium-Clustercache erstellt werden sollen. Die zulässigen Werte für diesen Parameter sind:
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
Typ: | Nullable<T>[Int32] |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-Size
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 Der Standardwert ist 1 GB oder C1.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-Sku
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 |
-StaticIP
Gibt eine eindeutige IP-Adresse im Subnetz für den Redis-Cache an. Wenn Sie keinen Wert für diesen Parameter angeben, wählt dieses Cmdlet eine IP-Adresse aus dem Subnetz aus.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-SubnetId
Die vollständige Ressourcen-ID eines Subnetzes in einem virtuellen Netzwerk, um den Azure-Cache für Redis bereitzustellen. Beispielformat: /subscriptions/{subid}/resourceGroups/{resourceGroupName}/Microsoft. {Netzwerk|ClassicNetwork}/VirtualNetworks/{vnetName}/subnets/{subnetName}
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-Tag
Eine Hashtabelle, die Tags darstellt.
Typ: | Hashtable |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-TenantSettings
Dieser Parameter ist veraltet.
Typ: | Hashtable |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-UpdateChannel
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: | Stable |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-UserAssignedIdentity
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 |
-WhatIf
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 |
-ZonalAllocationPolicy
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 |
-Zone
Liste der Azure-Regionen mit Verfügbarkeitszonen.
Typ: | String[] |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
Eingaben
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]]
String[]
Ausgaben
RedisCacheAttributesWithAccessKeys
Ähnliche Themen
Azure PowerShell