New-AzRedisEnterpriseCache

Referenz

Modul:: Az.RedisEnterpriseCache

Erstellt einen Redis Enterprise-Cache.

Syntax

New-AzRedisEnterpriseCache
   -ClusterName <String>
   -ResourceGroupName <String>
   -Location <String>
   -Sku <SkuName>
   [-SubscriptionId <String>]
   [-AofPersistenceEnabled]
   [-AofPersistenceFrequency <AofFrequency>]
   [-Capacity <Int32>]
   [-ClientProtocol <Protocol>]
   [-ClusteringPolicy <ClusteringPolicy>]
   [-CustomerManagedKeyEncryptionKeyUrl <String>]
   [-EvictionPolicy <EvictionPolicy>]
   [-GroupNickname <String>]
   [-IdentityType <ManagedServiceIdentityType>]
   [-IdentityUserAssignedIdentity <Hashtable>]
   [-KeyEncryptionKeyIdentityType <CmkIdentityType>]
   [-KeyEncryptionKeyIdentityUserAssignedIdentityResourceId <String>]
   [-LinkedDatabase <ILinkedDatabase[]>]
   [-MinimumTlsVersion <TlsVersion>]
   [-Module <IModule[]>]
   [-Port <Int32>]
   [-RdbPersistenceEnabled]
   [-RdbPersistenceFrequency <RdbFrequency>]
   [-Tag <Hashtable>]
   [-Zone <String[]>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]

New-AzRedisEnterpriseCache
   -ClusterName <String>
   -ResourceGroupName <String>
   -Location <String>
   -Sku <SkuName>
   -NoDatabase
   [-SubscriptionId <String>]
   [-Capacity <Int32>]
   [-CustomerManagedKeyEncryptionKeyUrl <String>]
   [-IdentityType <ManagedServiceIdentityType>]
   [-IdentityUserAssignedIdentity <Hashtable>]
   [-KeyEncryptionKeyIdentityType <CmkIdentityType>]
   [-KeyEncryptionKeyIdentityUserAssignedIdentityResourceId <String>]
   [-MinimumTlsVersion <TlsVersion>]
   [-Tag <Hashtable>]
   [-Zone <String[]>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]

Beschreibung

Erstellt oder aktualisiert einen vorhandenen Cachecluster (überschreiben/neu erstellen, mit potenziellen Ausfallzeiten) mit einer zugeordneten Datenbank.

Beispiele

Beispiel 1: Erstellen eines Redis Enterprise-Caches

New-AzRedisEnterpriseCache -Name "MyCache" -ResourceGroupName "MyGroup" -Location "West US" -Sku "Enterprise_E10"

Location Name    Type                            Zone Database
-------- ----    ----                            ---- --------
West US  MyCache Microsoft.Cache/redisEnterprise      {default}

Mit diesem Befehl wird ein Redis Enterprise-Cache namens "MyCache" mit einer zugeordneten Datenbank namens "Standard" erstellt.

Beispiel 2: Erstellen eines Redis Enterprise-Caches mit einigen optionalen Parametern

New-AzRedisEnterpriseCache -Name "MyCache" -ResourceGroupName "MyGroup" -Location "East US" -Sku "Enterprise_E20" -Capacity 4 -MinimumTlsVersion "1.2" -Zone "1","2","3" -Tag @{"tag1" = "value1"} -Module "{name:RedisBloom, args:`"ERROR_RATE 0.00 INITIAL_SIZE 400`"}","{name:RedisTimeSeries, args:`"RETENTION_POLICY 20`"}","{name:RediSearch}" -ClientProtocol "Plaintext" -EvictionPolicy "NoEviction" -ClusteringPolicy "EnterpriseCluster" -AofPersistenceEnabled -AofPersistenceFrequency "1s"

Location Name    Type                            Zone      Database
-------- ----    ----                            ----      --------
East US  MyCache Microsoft.Cache/redisEnterprise {1, 2, 3} {default}

Mit diesem Befehl wird ein Redis Enterprise-Cache namens "MyCache" mit einer zugeordneten Datenbank namens "Standard" mit einigen optionalen Parametern erstellt.

Beispiel 3: Erweitert – Erstellen eines Redis Enterprise-Cacheclusters ohne zugeordnete Datenbank

New-AzRedisEnterpriseCache -Name "MyCache" -ResourceGroupName "MyGroup" -Location "East US" -Sku "EnterpriseFlash_F300" -NoDatabase

Location Name    Type                            Zone Database
-------- ----    ----                            ---- --------
East US  MyCache Microsoft.Cache/redisEnterprise      {}

Warnung: Mit diesem Befehl wird ein Redis Enterprise-Cachecluster namens "MyCache" erstellt, ohne dass eine zugeordnete Datenbank Daten enthält.

Beispiel 4: Erstellen eines Redis Enterprise-Caches mit einer georeplizierten Datenbank

New-AzRedisEnterpriseCache -Name "MyCache" -ResourceGroupName "MyGroup" -Location "West US" -Sku "Enterprise_E10" -ClientProtocol "Encrypted" -EvictionPolicy "NoEviction" -ClusteringPolicy "EnterpriseCluster" -GroupNickname "GroupNickname" -LinkedDatabase '{id:"/subscriptions/6b9ac7d2-7f6d-4de4-962c-43fda44bc3f2/resourceGroups/MyGroup/providers/Microsoft.Cache/redisEnterprise/MyCache/databases/default"}'

Location Name      Type                            Zone Database
-------- ----      ----                            ---- --------
West US  MyCache   Microsoft.Cache/redisEnterprise      {default}

Mit diesem Befehl wird ein Cachename "MyCache" mit einer georeplizierten Datenbank namens "Standard" erstellt.

Parameter

-AofPersistenceEnabled

[Vorschau] Legt fest, ob die AOF-Persistenz aktiviert ist. Nach dem Aktivieren der AOF-Persistenz können Sie sie nicht deaktivieren. Unterstützung für das Deaktivieren der AOF-Persistenz nach dem Aktivieren wird zu einem späteren Zeitpunkt hinzugefügt.

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

-AofPersistenceFrequency

[Vorschau] Legt die Häufigkeit fest, mit der Daten auf den Datenträger geschrieben werden, wenn die AOF-Persistenz aktiviert ist. Zulässige Werte: 1s, immer

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

-AsJob

Ausführen des Befehls als Auftrag

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

-Capacity

Die Größe des Redis Enterprise-Clusters – standardmäßig 2 oder 3, je nach SKU. Zulässige Werte sind (2, 4, 6, ...) für Enterprise-SKUs und (3, 9, 15, ...) für Flash-SKUs.

Type:	Int32
Aliases:	SkuCapacity
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ClientProtocol

Gibt an, ob Redis-Clients eine Verbindung mithilfe von TLS-verschlüsselten oder Nur-Text-Redis-Protokollen herstellen können – Standard sind verschlüsselte zulässige Werte: Verschlüsselt, Nur-Text

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

-ClusteringPolicy

Clustering-Richtlinie – Standardmäßig ist OSSCluster zur Erstellungszeit angegeben. Zulässige Werte: EnterpriseCluster, OSSCluster

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

-ClusterName

Der Name des Redis Enterprise-Clusters.

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

-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

-CustomerManagedKeyEncryptionKeyUrl

Schlüsselverschlüsselungsschlüssel-URL ist nur versionsgeschützt. Ex: https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78"

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

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Type:	PSObject
Aliases:	AzureRMContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EvictionPolicy

Redis eviction policy - default is VolatileLRU Allowed values: AllKeysLFU, AllKeysLRU, AllKeysRandom, VolatileLRU, VolatileLFU, VolatileTTL, VolatileRandom, NoEviction

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

-GroupNickname

Name für die Gruppe der verknüpften Datenbankressourcen

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

-IdentityType

Typ der verwalteten Dienstidentität (wobei systemAssigned- und UserAssigned-Typen zulässig sind).

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

-IdentityUserAssignedIdentity

Die Gruppe der benutzerzuweisungen Identitäten, die der Ressource zugeordnet sind. Die Wörterbuchschlüssel "userAssignedIdentities" sind ARM-Ressourcen-IDs im Formular: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Die Wörterbuchwerte können leere Objekte ({}) in Anforderungen sein.

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

-KeyEncryptionKeyIdentityType

In dieser API-Version wird nur userAssignedIdentity unterstützt. Andere Typen können in Zukunft unterstützt werden.

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

-KeyEncryptionKeyIdentityUserAssignedIdentityResourceId

Vom Benutzer zugewiesene Identität, die für den Zugriff auf die URL des Schlüsselverschlüsselungsschlüssels verwendet werden soll. Beispiel: /subscriptions/<sub uuid>/resourceGroups/resource group>/<providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId.

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

-LinkedDatabase

Liste der Datenbankressourcen, die mit dieser Datenbank verknüpft werden sollen. Weitere Informationen finden Sie im ABSCHNITT NOTES für GEOREPLICATIONLINKEDDATABASE-Eigenschaften und Erstellen einer Hashtabelle. Informationen zum Erstellen finden Sie im Abschnitt "NOTES" für LINKEDDATABASE-Eigenschaften und erstellen eine Hashtabelle.

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

-Location

Der geografische Standort, an dem sich die Ressource befindet.

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

-MinimumTlsVersion

Die mindeste TLS-Version für den zu unterstützenden Cluster – Standardwert ist 1.2 Zulässige Werte: 1.0, 1.1, 1.2

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

-Module

Optionaler Satz von Redis-Modulen, die in dieser Datenbank aktiviert werden sollen – Module können nur zur Erstellungszeit hinzugefügt werden. Informationen zum Erstellen finden Sie im Abschnitt "NOTES" für MODULeigenschaften und erstellen eine Hashtabelle.

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

-NoDatabase

Erweitert – Erstellen Sie keine Standarddatenbank automatisch. Warnung: Der Cache kann erst verwendet werden, wenn Sie eine Datenbank erstellen.

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

-NoWait

Asynchrones Ausführen des Befehls

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

-Port

TCP-Port des Datenbankendpunkts – standardmäßig ein verfügbarer Port, der zur Erstellungszeit angegeben ist.

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

-RdbPersistenceEnabled

[Vorschau] Legt fest, ob die RDB-Persistenz aktiviert ist. Nach dem Aktivieren der RDB-Persistenz können Sie sie nicht deaktivieren. Unterstützung für das Deaktivieren der RDB-Persistenz nach dem Aktivieren wird zu einem späteren Zeitpunkt hinzugefügt.

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

-RdbPersistenceFrequency

[Vorschau] Legt die Häufigkeit fest, mit der eine Momentaufnahme der Datenbank erstellt wird, wenn RDB-Persistenz aktiviert ist. Zulässige Werte: 1h, 6h, 12h

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

-ResourceGroupName

Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet.

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

-Sku

Der Typ des bereitzustellenden Redis Enterprise-Clusters. Zulässige Werte: Enterprise_E10, Enterprise_E20, Enterprise_E50, Enterprise_E100, EnterpriseFlash_F300, EnterpriseFlash_F700, EnterpriseFlash_F1500

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

-SubscriptionId

Hierbei handelt es sich um die ID des Zielabonnements.

Type:	String
Position:	Named
Default value:	(Get-AzContext).Subscription.Id
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Tag

Clusterressourcentags.

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

Die Verfügbarkeitszonen, an der dieser Cluster bereitgestellt wird.

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

Ausgaben

ICluster

Hinweise

ALIASE

KOMPLEXE PARAMETEREIGENSCHAFTEN

Um die unten beschriebenen Parameter zu erstellen, erstellen Sie eine Hashtabelle mit den entsprechenden Eigenschaften. Informationen zu Hashtabellen finden Sie unter "Get-Help about_Hash_Tables".

LINKEDDATABASE <ILinkedDatabase[]>: Liste der Datenbankressourcen, die mit dieser Datenbank verknüpft werden sollen. Weitere Informationen finden Sie im ABSCHNITT NOTES für GEOREPLICATIONLINKEDDATABASE-Eigenschaften und Erstellen einer Hashtabelle.

[Id <String>]: Ressourcen-ID einer Datenbankressource, die mit dieser Datenbank verknüpft werden soll.

MODULE <IModule[]>: Optionaler Satz von Redis-Modulen, die in dieser Datenbank aktiviert werden sollen - Module können nur zur Erstellungszeit hinzugefügt werden.

Name <String>: Der Name des Moduls, z. B. 'RedisBloom', 'RediSearch', 'RedisTimeSeries'
[Arg <String>]: Konfigurationsoptionen für das Modul, z. B. "ERROR_RATE 0,01 INITIAL_SIZE 400".