Dela via


New-AzRedisEnterpriseCache

Skapar en Redis Enterprise-cache.

Syntax

CreateClusterWithDatabase (Standard)

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

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

-AccessKeysAuthentication

Den här egenskapen kan aktiveras/inaktiveras för att tillåta eller neka åtkomst med de aktuella åtkomstnycklarna. Kan uppdateras även efter att databasen har skapats.

Parameteregenskaper

Typ:AccessKeysAuthentication
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

CreateClusterWithDatabase
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-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.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

CreateClusterWithDatabase
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-AofPersistenceFrequency

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

Parameteregenskaper

Typ:AofFrequency
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

CreateClusterWithDatabase
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-AsJob

Kör kommandot som ett jobb

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Capacity

Storleken på RedisEnterprise-klustret. Standardvärdet är 2 eller 3 eller inte tillämpligt beroende på SKU. Giltiga värden är (2, 4, 6, ...) för Enterprise_* SKU:er och (3, 9, 15, ...) för EnterpriseFlash_* SKU:er. För andra SKU:er stöds inte kapacitetsargumentet.

Parameteregenskaper

Typ:Int32
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:SkuCapacity (på engelska)

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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

Parameteregenskaper

Typ:Protocol
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

CreateClusterWithDatabase
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-ClusteringPolicy

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

Parameteregenskaper

Typ:ClusteringPolicy
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

CreateClusterWithDatabase
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-ClusterName

Namnet på Redis Enterprise-klustret.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:Namn

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Confirm

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:jfr

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-CustomerManagedKeyEncryptionKeyUrl

Url för nyckelkrypteringsnyckel är endast version. Ex: https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78"

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-DefaultProfile

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

Parameteregenskaper

Typ:PSObject
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:AzureRMContext, AzureCredential

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-EvictionPolicy

Redis-borttagningsprincip – standardvärdet är VolatileLRU Tillåtna värden: AllKeysLFU, AllKeysLRU, AllKeysRandom, VolatileLRU, VolatileLFU, VolatileTTL, VolatileRandom, NoEviction

Parameteregenskaper

Typ:EvictionPolicy
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

CreateClusterWithDatabase
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-GroupNickname

Namn på gruppen med länkade databasresurser

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

CreateClusterWithDatabase
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-HighAvailability

Aktiverad som standard. Kan bara uppdateras från inaktiverad till aktiverad. Om highAvailability är inaktiverat replikeras inte datauppsättningen. Detta påverkar serviceavtalet för tillgänglighet och ökar risken för dataförlust.

Parameteregenskaper

Typ:HighAvailability
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-IdentityType

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

Parameteregenskaper

Typ:ManagedServiceIdentityType
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:Hashtable
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-KeyEncryptionKeyIdentityType

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

Parameteregenskaper

Typ:CmkIdentityType
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:

ILinkedDatabase[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

CreateClusterWithDatabase
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Location

Den geo-plats där resursen finns.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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

Parameteregenskaper

Typ:TlsVersion
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:

IModule[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

CreateClusterWithDatabase
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-NoDatabase

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

CreateClusterOnly
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-NoWait

Kör kommandot asynkront

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Port

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

Parameteregenskaper

Typ:Int32
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

CreateClusterWithDatabase
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

CreateClusterWithDatabase
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-RdbPersistenceFrequency

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

Parameteregenskaper

Typ:RdbFrequency
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

CreateClusterWithDatabase
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-ResourceGroupName

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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Sku

Typen av RedisEnterprise-kluster som ska distribueras. Godkända värden: 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, 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

Parameteregenskaper

Typ:SkuName
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:SkuName

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-SubscriptionId

ID för målprenumerationen.

Parameteregenskaper

Typ:String
Standardvärde:(Get-AzContext).Subscription.Id
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Tag

Klusterresurstaggar.

Parameteregenskaper

Typ:Hashtable
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-WhatIf

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:Wi

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Zone

Tillgänglighetszonerna där det här klustret ska distribueras.

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Utdata

ICluster