Share via


New-AzRedisEnterpriseCache

Skapar en 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>]

Description

Skapar eller uppdaterar ett befintligt cachekluster (skriv över/återskapa, med potentiell stilleståndstid) med en associerad databas.

Exempel

Exempel 1: Skapa en Redis Enterprise-cache

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

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

Det här kommandot skapar en Redis Enterprise-cache med namnet MyCache med en associerad databas med namnet default.

Exempel 2: Skapa en Redis Enterprise-cache med några valfria parametrar

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}

Det här kommandot skapar en Redis Enterprise-cache med namnet MyCache med en associerad databas med namnet default med hjälp av några valfria parametrar.

Exempel 3: Avancerat – Skapa ett Redis Enterprise-cachekluster utan en associerad databas

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

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

Varning! Det här kommandot skapar ett Redis Enterprise-cachekluster med namnet MyCache utan någon associerad databas för att lagra data.

Exempel 4: Skapa en Redis Enterprise-cache med en georeplikerad databas

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}

Det här kommandot skapar ett cachenamn MyCache med en georeplikerad databas med namnet default

Parametrar

-AofPersistenceEnabled

[Förhandsversion] Anger om AOF-persistens är aktiverat. När du har aktiverat AOF-persistens kan du inte inaktivera det. Stöd för att inaktivera AOF-beständighet efter aktivering läggs till vid ett senare tillfälle.

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

-AofPersistenceFrequency

[Förhandsversion] Anger hur ofta data skrivs till disk om AOF-beständighet är aktiverat. Tillåtna värden: 1:a, alltid

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

-AsJob

Kör kommandot som ett jobb

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

-Capacity

Storleken på Redis Enterprise-klustret – standardvärdet är 2 eller 3 beroende på SKU. Tillåtna värden är (2, 4, 6, ...) för Företags-SKU:er och (3, 9, 15, ...) för Flash-SKU:er.

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

-ClientProtocol

Anger om Redis-klienter kan ansluta med TLS-krypterade eller redis-protokoll i klartext – standardvärdet är Krypterade tillåtna värden: Krypterade, Oformaterad text

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

-ClusteringPolicy

Klustringsprincip – standardvärdet är OSSCluster Angiven vid skapandetillfället. Tillåtna värden: EnterpriseCluster, OSSCluster

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

-ClusterName

Namnet på Redis Enterprise-klustret.

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

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

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

-CustomerManagedKeyEncryptionKeyUrl

Url för nyckelkrypteringsnyckel är endast version. 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

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

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

-EvictionPolicy

Redis-borttagningsprincip – standardvärdet är VolatileLRU Tillåtna värden: 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

Namn på gruppen med länkade databasresurser

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

-IdentityType

Typ av hanterad tjänstidentitet (där både SystemAssigned- och UserAssigned-typer tillåts).

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

-IdentityUserAssignedIdentity

Uppsättningen användartilldelade identiteter som är associerade med resursen. Ordlistenycklarna userAssignedIdentities är ARM-resurs-ID:er i formuläret: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Ordlistevärdena kan vara tomma objekt ({}) i begäranden.

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

-KeyEncryptionKeyIdentityType

Endast userAssignedIdentity stöds i den här API-versionen. andra typer kan stödjas i framtiden

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

-KeyEncryptionKeyIdentityUserAssignedIdentityResourceId

Användartilldelad identitet som ska användas för åtkomst till url för nyckelkrypteringsnyckel. Exempel: /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

Lista över databasresurser som ska länkas till den här databasen För att skapa, se AVSNITTET ANTECKNINGAR för GEOREPLICATIONLINKEDDATABASE-egenskaper och skapa en hash-tabell. Information om hur du skapar finns i AVSNITTET ANTECKNINGAR för LINKEDDATABASE-egenskaper och skapa en hash-tabell.

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

-Location

Den geo-plats där resursen finns.

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

-MinimumTlsVersion

Den lägsta TLS-versionen för klustret att stödja – standardvärdet är 1,2 Tillåtna värden: 1.0, 1.1, 1.2

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

-Module

Valfri uppsättning redis-moduler som ska aktiveras i den här databasen – moduler kan bara läggas till vid skapandetillfället. Information om hur du skapar finns i AVSNITTET ANTECKNINGAR för MODULE-egenskaper och skapa en hash-tabell.

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

-NoDatabase

Avancerat – Skapa inte automatiskt en standarddatabas. Varning! Cachen kan inte användas förrän du har skapat en databas.

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

-NoWait

Kör kommandot asynkront

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

-Port

TCP-port för databasslutpunkten – standardvärdet är en tillgänglig port som anges vid tidpunkten för skapande.

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

-RdbPersistenceEnabled

[Förhandsversion] Anger om RDB-persistens är aktiverat. När du har aktiverat RDB-persistens kan du inte inaktivera det. Stöd för att inaktivera RDB-beständighet efter aktivering läggs till vid ett senare tillfälle.

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

-RdbPersistenceFrequency

[Förhandsversion] Anger hur ofta en ögonblicksbild av databasen skapas om RDB-persistens är aktiverat. Tillåtna värden: 1h, 6h, 12h

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

-ResourceGroupName

Namnet på resursgruppen. Namnet är skiftlägesokänsligt.

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

-Sku

Typen av Redis Enterprise-kluster som ska distribueras. Tillåtna värden: 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

ID för målprenumerationen.

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

-Tag

Klusterresurstaggar.

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

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

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

-Zone

Det Tillgänglighetszoner där klustret ska distribueras.

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

Utdata

ICluster

Kommentarer

ALIAS

EGENSKAPER FÖR KOMPLEXA PARAMETRAR

Skapa parametrarna som beskrivs nedan genom att skapa en hash-tabell som innehåller lämpliga egenskaper. Information om hash-tabeller finns i Get-Help about_Hash_Tables.

LINKEDDATABASE <ILinkedDatabase[]>: Lista över databasresurser som ska länkas till den här databasen För att skapa, se AVSNITTET ANTECKNINGAR för GEOREPLICATIONLINKEDDATABASE-egenskaper och skapa en hash-tabell.

  • [Id <String>]: Resurs-ID för en databasresurs som ska länkas till den här databasen.

MODULE <IModule[]>: Valfri uppsättning redis-moduler som ska aktiveras i den här databasen – moduler kan bara läggas till vid skapandetillfället.

  • Name <String>: Namnet på modulen, t.ex. "RedisBloom", "RediSearch", "RedisTimeSeries"
  • [Arg <String>]: Konfigurationsalternativ för modulen, t.ex. "ERROR_RATE 0.01 INITIAL_SIZE 400".