New-AzRedisCache

Referenz

Modul:: Az.RedisCache

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>]
   [-SubnetId <String>]
   [-StaticIP <String>]
   [-Tag <Hashtable>]
   [-Zone <String[]>]
   [-RedisVersion <String>]
   [-UpdateChannel <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         : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          SecondaryKey       : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          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         : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          SecondaryKey       : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          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         : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          SecondaryKey       : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          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 über den PowerShell-Befehl "New-AzVirtualNetwork " 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         : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          SecondaryKey       : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          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

Durch die Persistenz werden Redis-Daten in ein Azure Storage-Konto geschrieben, das sich in Ihrem Besitz befindet und von Ihnen verwaltet wird. Bevor Sie also die Datenpersistenz konfigurieren, müssen Sie über ein Speicherkonto in derselben Ressourcengruppe verfügen. Wählen Sie ein Speicherkonto aus, das aus derselben Region und demselben Abonnement wie der Cache stammt, und wir empfehlen ein Storage Premium-Konto, da dieses einen höheren Durchsatz aufweist.

Rufen Sie nach dem Erstellen eines Speicherkontos das Speicherkonto Verbindungszeichenfolge 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.

Verbinden ion Zeichenfolgenformat :- "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 (Geben Sie Verbindungszeichenfolge im obigen Format.)
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=pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=;EndpointSuffix=mySuffix"; "rdb-backup-frequency" = "30"}

PrimaryKey         : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          SecondaryKey       : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          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 (Geben Sie Verbindungszeichenfolge im obigen Format.)
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=pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=;EndpointSuffix=mySuffix"}

PrimaryKey         : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          SecondaryKey       : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          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

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableNonSslPort

Gibt an, ob der Nicht-SSL-Port aktiviert ist. Der Standardwert ist $False (der nicht-SSL-Port ist deaktiviert).

Type:	Nullable<T>[Boolean]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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"

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Location

Gibt den Speicherort an, an dem ein Redis-Cache erstellt werden soll. Gültige Werte sind:

USA Nord Mitte
USA Süd Mitte
USA (Mitte)
Europa, Westen
Nordeuropa
USA (Westen)
East US
USA (Ost) 2
Japan, Osten
Japan, Westen
Brasilien Süd
Asien, Südosten
Asien, Osten
Australien (Osten)
Australien, Südosten

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-MinimumTlsVersion

Geben Sie die tls-Version an, die von Clients zum Herstellen einer Verbindung mit dem Cache erforderlich ist.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Gibt den Namen des zu erstellenden Redis-Caches an.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-RedisConfiguration

Gibt die Konfigurationseinstellungen für Redis an. Zulässige Werte für diesen Parameter:

rdb-backup-enabled. Gibt an, dass Redis-Datenpersistenz aktiviert ist. Nur Premium-Stufe.
rdb-storage-connection-string. Gibt den Verbindungszeichenfolge für das 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 generiert. Konfiguriert die Anzahl der Datenbanken. Diese Eigenschaft kann nur bei der Erstellung des Caches 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

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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".

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ResourceGroupName

Gibt den Namen der Ressourcengruppe an, in der der Redis-Cache erstellt werden soll.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ShardCount

Gibt die Anzahl von Shards an, die in einem Premium-Clustercache erstellt werden sollen. Zulässige Werte für diesen Parameter:

Type:	Nullable<T>[Int32]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Sku

Gibt die SKU des zu erstellenden Redis-Caches an. Gültige Werte sind:

Grundlegend
Standard
Premium Der Standardwert ist "Standard".

Type:	String
Accepted values:	Basic, Standard, Premium
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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}

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Tag

Eine Hashtabelle, die Tags darstellt.

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-TenantSettings

Dieser Parameter ist veraltet.

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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"

Type:	String
Position:	Named
Default value:	Stable
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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}'

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Zone

Liste der Azure-Regionen mit Verfügbarkeitszonen.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

Eingaben

String

Hashtable

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

New-AzRedisCache

Syntax

Beschreibung

Beispiele

Beispiel 1: Erstellen eines Redis-Caches

Beispiel 2: Erstellen eines Standard-SKU-Redis-Caches

Beispiel 3: Erstellen eines redundanten Zonencaches

Beispiel 4: Erstellen eines virtuellen Netzwerks zum Aktivieren des Caches

Beispiel 5: Konfigurieren der Datenpersistenz für einen Premium Azure-Cache für Redis

Beispiel 6: Konfigurieren der Datenpersistenz für einen Premium Azure-Cache für Redis – AOF-Sicherung aktiviert

Parameter

-Confirm

-DefaultProfile

-EnableNonSslPort

-IdentityType

-Location

-MinimumTlsVersion

-Name

-RedisConfiguration

-RedisVersion

-ResourceGroupName

-ShardCount

-Size

-Sku

-StaticIP

-SubnetId

-Tag

-TenantSettings

-UpdateChannel

-UserAssignedIdentity

-WhatIf

-Zone

Eingaben

Ausgaben

Feedback

Zusätzliche Ressourcen

New-AzRedisCache

Syntax

Beschreibung

Beispiele

Beispiel 1: Erstellen eines Redis-Caches

Beispiel 2: Erstellen eines Standard-SKU-Redis-Caches

Beispiel 3: Erstellen eines redundanten Zonencaches

Beispiel 4: Erstellen eines virtuellen Netzwerks zum Aktivieren des Caches

Beispiel 5: Konfigurieren der Datenpersistenz für einen Premium Azure-Cache für Redis

Beispiel 6: Konfigurieren der Datenpersistenz für einen Premium Azure-Cache für Redis – AOF-Sicherung aktiviert

Parameter

-Confirm

-DefaultProfile

-EnableNonSslPort

-IdentityType

-Location

-MinimumTlsVersion

-Name

-RedisConfiguration

-RedisVersion

-ResourceGroupName

-ShardCount

-Size

-Sku

-StaticIP

-SubnetId

-Tag

-TenantSettings

-UpdateChannel

-UserAssignedIdentity

-WhatIf

-Zone

Eingaben

Ausgaben

Ähnliche Themen

Feedback

Zusätzliche Ressourcen