Delen via


New-AzRedisEnterpriseCache

Hiermee maakt u een Redis Enterprise-cache.

Syntaxis

CreateClusterWithDatabase (Standaard)

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

CreateClusterOnly

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

Description

Hiermee maakt of werkt u een bestaand cachecluster (overschrijven/opnieuw maken, met mogelijke downtime) bij met een gekoppelde database.

Voorbeelden

Voorbeeld 1: Een Redis Enterprise-cache maken

New-AzRedisEnterpriseCache -Name "MyCache" -ResourceGroupName "MyGroup" -Location "West US" -Sku "Enterprise_E10"
Location Name    Type                            Zone Database
-------- ----    ----                            ---- --------
West US  MyCache Microsoft.Cache/redisEnterprise      {default}

Met deze opdracht maakt u een Redis Enterprise-cache met de naam MyCache met een bijbehorende database met de naam Standaard.

Voorbeeld 2: Een Redis Enterprise-cache maken met een aantal optionele parameters

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}

Met deze opdracht maakt u een Redis Enterprise-cache met de naam MyCache met een bijbehorende database met de naam standaard, met behulp van enkele optionele parameters.

Voorbeeld 3: Geavanceerd - Een Redis Enterprise-cachecluster maken zonder een gekoppelde database

New-AzRedisEnterpriseCache -Name "MyCache" -ResourceGroupName "MyGroup" -Location "East US" -Sku "EnterpriseFlash_F300" -NoDatabase
Location Name    Type                            Zone Database
-------- ----    ----                            ---- --------
East US  MyCache Microsoft.Cache/redisEnterprise      {}

Waarschuwing: met deze opdracht maakt u een Redis Enterprise-cachecluster met de naam MyCache zonder gekoppelde database voor het opslaan van gegevens.

Voorbeeld 4: Een Redis Enterprise-cache maken met een georeplicated database

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}

Met deze opdracht maakt u een cachenaam MyCache met een georeplicated database met de naam standaard

Parameters

-AccessKeysAuthentication

Deze eigenschap kan worden ingeschakeld/uitgeschakeld om toegang met de huidige toegangssleutels toe te staan of te weigeren. Kan worden bijgewerkt, zelfs nadat de database is gemaakt.

Parametereigenschappen

Type:AccessKeysAuthentication
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

CreateClusterWithDatabase
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-AofPersistenceEnabled

[Preview] Hiermee stelt u in of AOF-persistentie is ingeschakeld. Nadat U AOF-persistentie hebt ingeschakeld, kunt u deze niet uitschakelen. Ondersteuning voor het uitschakelen van AOF-persistentie nadat deze is ingeschakeld, wordt op een later tijdstip toegevoegd.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

CreateClusterWithDatabase
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-AofPersistenceFrequency

[Preview] Hiermee stelt u de frequentie in waarmee gegevens naar schijf worden geschreven als AOF-persistentie is ingeschakeld. Toegestane waarden: 1s, altijd

Parametereigenschappen

Type:AofFrequency
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

CreateClusterWithDatabase
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-AsJob

De opdracht uitvoeren als een taak

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Capacity

De grootte van het RedisEnterprise-cluster. De standaardinstellingen zijn 2 of 3 of niet van toepassing, afhankelijk van de SKU. Geldige waarden zijn (2, 4, 6, ...) voor Enterprise_* SKU's en (3, 9, 15, ...) voor EnterpriseFlash_* SKU's. Voor andere SKU's wordt capaciteitsargument niet ondersteund.

Parametereigenschappen

Type:Int32
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:SKU-capaciteit

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ClientProtocol

Hiermee geeft u op of redis-clients verbinding kunnen maken met behulp van met TLS versleutelde of redis-protocollen - standaard is versleutelde toegestane waarden: Versleuteld, Tekst zonder opmaak

Parametereigenschappen

Type:Protocol
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

CreateClusterWithDatabase
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ClusteringPolicy

Clusteringbeleid: standaard is OSSCluster opgegeven tijdens het maken. Toegestane waarden: EnterpriseCluster, OSSCluster

Parametereigenschappen

Type:ClusteringPolicy
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

CreateClusterWithDatabase
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ClusterName

De naam van het Redis Enterprise-cluster.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Naam

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Confirm

Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Cf

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-CustomerManagedKeyEncryptionKeyUrl

Url van sleutelversleutelingssleutel is alleen geversied. Bijvoorbeeld: https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78"

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

Parametereigenschappen

Type:PSObject
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:AzureRMContext, AzureCredential

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-EvictionPolicy

Redis-verwijderingsbeleid - standaard is VluchtigeLRU toegestane waarden: AllKeysLFU, AllKeysLRU, AllKeysRandom, VolatileLRU, VolatileLFU, VolatileTTL, VolatileRandom, NoEviction

Parametereigenschappen

Type:EvictionPolicy
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

CreateClusterWithDatabase
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-GroupNickname

Naam voor de groep gekoppelde databasebronnen

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

CreateClusterWithDatabase
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-HighAvailability

Standaard ingeschakeld. Kan alleen worden bijgewerkt van uitgeschakeld naar ingeschakeld. Als highAvailability is uitgeschakeld, wordt de gegevensset niet gerepliceerd. Dit is van invloed op de SLA voor beschikbaarheid en verhoogt het risico op gegevensverlies.

Parametereigenschappen

Type:HighAvailability
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-IdentityType

Type beheerde service-identiteit (waarbij zowel SystemAssigned- als UserAssigned-typen zijn toegestaan).

Parametereigenschappen

Type:ManagedServiceIdentityType
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-IdentityUserAssignedIdentity

De set door de gebruiker toegewezen identiteiten die aan de resource zijn gekoppeld. De woordenlijstsleutels userAssignedIdentities zijn ARM-resource-id's in de vorm: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. De waarden van de woordenlijst kunnen lege objecten ({}) zijn in aanvragen.

Parametereigenschappen

Type:Hashtable
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-KeyEncryptionKeyIdentityType

Alleen userAssignedIdentity wordt ondersteund in deze API-versie; andere typen kunnen in de toekomst worden ondersteund

Parametereigenschappen

Type:CmkIdentityType
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-KeyEncryptionKeyIdentityUserAssignedIdentityResourceId

Door de gebruiker toegewezen identiteit die moet worden gebruikt voor toegang tot de URL van de sleutelversleutelingssleutel. Bijvoorbeeld: /subscriptions/<sub uuid>/resourceGroups/<resource group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-LinkedDatabase

Lijst met databaseresources die u wilt koppelen aan deze database om te maken, raadpleegt u de sectie NOTES voor de eigenschappen GEOREPLICATIONLINKEDDATABASE en maakt u een hash-tabel. Zie de sectie NOTES voor LINKEDDATABASE-eigenschappen en maak een hash-tabel om deze samen te stellen.

Parametereigenschappen

Type:

ILinkedDatabase[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

CreateClusterWithDatabase
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Location

De geografische locatie waar de resource zich bevindt.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-MinimumTlsVersion

De minimale TLS-versie voor het cluster dat moet worden ondersteund: de standaardwaarde is 1.2 Toegestane waarden: 1.0, 1.1, 1.2

Parametereigenschappen

Type:TlsVersion
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Module

Optionele set redis-modules die in deze database kunnen worden ingeschakeld, kunnen modules alleen worden toegevoegd tijdens het maken. Zie de sectie NOTES voor MODULE-eigenschappen en maak een hash-tabel om deze samen te stellen.

Parametereigenschappen

Type:

IModule[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

CreateClusterWithDatabase
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-NoDatabase

Geavanceerd: maak niet automatisch een standaarddatabase. Waarschuwing: de cache kan pas worden gebruikt als u een database maakt.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

CreateClusterOnly
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-NoWait

De opdracht asynchroon uitvoeren

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Port

TCP-poort van het database-eindpunt: standaard ingesteld op een beschikbare poort die tijdens het maken is opgegeven.

Parametereigenschappen

Type:Int32
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

CreateClusterWithDatabase
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-RdbPersistenceEnabled

[Preview] Hiermee stelt u in of RDB-persistentie is ingeschakeld. Nadat u RDB-persistentie hebt ingeschakeld, kunt u deze niet uitschakelen. Ondersteuning voor het uitschakelen van RDB-persistentie nadat deze is ingeschakeld, wordt op een latere datum toegevoegd.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

CreateClusterWithDatabase
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-RdbPersistenceFrequency

[Preview] Hiermee stelt u de frequentie in waarmee een momentopname van de database wordt gemaakt als RDB-persistentie is ingeschakeld. Toegestane waarden: 1h, 6h, 12h

Parametereigenschappen

Type:RdbFrequency
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

CreateClusterWithDatabase
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ResourceGroupName

De naam van de resourcegroep. De naam is hoofdletterongevoelig.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Sku

Het type RedisEnterprise-cluster dat moet worden geïmplementeerd. Geaccepteerde waarden: Balanced_B0, Balanced_B1, Balanced_B10, Balanced_B100, Balanced_B1000, Balanced_B150, Balanced_B20, Balanced_B250, Balanced_B3, Balanced_B350, Balanced_B5, Balanced_B50, Balanced_B500 Balanced_B700, ComputeOptimized_X10, ComputeOptimized_X100, ComputeOptimized_X150, ComputeOptimized_X20, ComputeOptimized_X250, ComputeOptimized_X3, ComputeOptimized_X350, ComputeOptimized_X5, ComputeOptimized_X50, ComputeOptimized_X500, ComputeOptimized_X700, EnterpriseFlash_F1500, EnterpriseFlash_F300, EnterpriseFlash_F700, Enterprise_E1, Enterprise_E10, Enterprise_E100, Enterprise_E20, Enterprise_E200, Enterprise_E400, Enterprise_E5, Enterprise_E50, FlashOptimized_A1000, FlashOptimized_A1500, FlashOptimized_A2000, FlashOptimized_A250, FlashOptimized_A4500, FlashOptimized_A500, FlashOptimized_A700, MemoryOptimized_M10, MemoryOptimized_M100, MemoryOptimized_M1000, MemoryOptimized_M150, MemoryOptimized_M1500, MemoryOptimized_ M20, MemoryOptimized_M2000, MemoryOptimized_M250, MemoryOptimized_M350, MemoryOptimized_M50, MemoryOptimized_M500, MemoryOptimized_M700

Parametereigenschappen

Type:SkuName
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:SkuName

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-SubscriptionId

De id van het doelabonnement.

Parametereigenschappen

Type:String
Default value:(Get-AzContext).Subscription.Id
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Tag

Clusterresourcetags.

Parametereigenschappen

Type:Hashtable
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-WhatIf

Toont wat er zou gebeuren wanneer de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Wi

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Zone

De beschikbaarheidszones waar dit cluster wordt geïmplementeerd.

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Uitvoerwaarden

ICluster