Udostępnij za pośrednictwem


New-AzRedisEnterpriseCache

Tworzy pamięć podręczną Redis Enterprise Cache.

Składnia

New-AzRedisEnterpriseCache
   -ClusterName <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Location <String>
   -Sku <SkuName>
   [-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>]
New-AzRedisEnterpriseCache
   -ClusterName <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Location <String>
   -Sku <SkuName>
   [-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>]

Opis

Tworzy lub aktualizuje istniejący klaster pamięci podręcznej (zastępowanie/ponowne tworzenie z potencjalnym przestojem) ze skojarzona bazą danych.

Przykłady

Przykład 1. Tworzenie pamięci podręcznej 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}

To polecenie tworzy pamięć podręczną Redis Enterprise o nazwie MyCache ze skojarzona baza danych o nazwie default.

Przykład 2. Tworzenie pamięci podręcznej Redis Enterprise Przy użyciu niektórych parametrów opcjonalnych

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}

To polecenie tworzy pamięć podręczną Redis Enterprise o nazwie MyCache ze skojarzona bazą danych o nazwie default przy użyciu niektórych parametrów opcjonalnych.

Przykład 3: Zaawansowane — tworzenie klastra pamięci podręcznej Redis Enterprise Bez skojarzonej bazy danych

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

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

Ostrzeżenie: To polecenie tworzy klaster pamięci podręcznej Redis Enterprise o nazwie MyCache bez skojarzonej bazy danych do przechowywania danych.

Przykład 4. Tworzenie pamięci podręcznej Redis Enterprise z georeplikowaną bazą danych

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}

To polecenie tworzy nazwę pamięci podręcznej MyCache z georeplikowaną bazą danych o nazwie default

Parametry

-AccessKeysAuthentication

Tę właściwość można włączyć/wyłączyć, aby zezwolić lub odmówić dostępu przy użyciu bieżących kluczy dostępu. Można aktualizować nawet po utworzeniu bazy danych.

Typ:AccessKeysAuthentication
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-AofPersistenceEnabled

[Wersja zapoznawcza] Określa, czy włączono trwałość AOF. Po włączeniu trwałości AOF nie będzie można go wyłączyć. Obsługa wyłączania trwałości AOF po włączeniu zostanie dodana w późniejszym terminie.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-AofPersistenceFrequency

[Wersja zapoznawcza] Ustawia częstotliwość zapisywania danych na dysku, jeśli włączono trwałość AOF. Dozwolone wartości: 1s, zawsze

Typ:AofFrequency
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-AsJob

Uruchamianie polecenia jako zadania

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Capacity

Rozmiar klastra RedisEnterprise. Wartość domyślna to 2 lub 3 lub nie dotyczy w zależności od jednostki SKU. Prawidłowe wartości to (2, 4, 6, ...) dla jednostek SKU Enterprise_* i (3, 9, 15, ...) dla jednostek SKU EnterpriseFlash_*. W przypadku innych argumentów pojemności jednostek SKU nie jest obsługiwany.

Typ:Int32
Aliasy:SkuCapacity
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ClientProtocol

Określa, czy klienci usługi Redis mogą łączyć się przy użyciu protokołów redis szyfrowanych przy użyciu protokołu TLS lub zwykłego tekstu — wartość domyślna to Szyfrowane dozwolone wartości: Encrypted, Plaintext

Typ:Protocol
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ClusteringPolicy

Zasady klastrowania — wartość domyślna to OSSCluster Określony w czasie tworzenia. Dozwolone wartości: EnterpriseCluster, OSSCluster

Typ:ClusteringPolicy
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ClusterName

Nazwa klastra Redis Enterprise.

Typ:String
Aliasy:Name
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-CustomerManagedKeyEncryptionKeyUrl

Tylko adres URL klucza szyfrowania klucza. Na przykład: https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78"

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Typ:PSObject
Aliasy:AzureRMContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-EvictionPolicy

Zasady eksmisji redis — wartość domyślna to VolatileLRU Dozwolone wartości: AllKeysLFU, AllKeysLRU, AllKeysRandom, VolatileLRU, VolatileLFU, VolatileTTL, VolatileRandom, NoEviction

Typ:EvictionPolicy
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-GroupNickname

Nazwa grupy połączonych zasobów bazy danych

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-HighAvailability

Domyślnie włączone. Można aktualizować tylko z wyłączonego w celu włączenia. Jeśli funkcja highAvailability jest wyłączona, zestaw danych nie jest replikowany. Ma to wpływ na umowę SLA dostępności i zwiększa ryzyko utraty danych.

Typ:HighAvailability
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-IdentityType

Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned).

Typ:ManagedServiceIdentityType
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-IdentityUserAssignedIdentity

Zestaw tożsamości przypisanych przez użytkownika skojarzonych z zasobem. Klucze słownika userAssignedIdentities będą identyfikatorami zasobów usługi ARM w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Wartości słownika mogą być pustymi obiektami ({}) w żądaniach.

Typ:Hashtable
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-KeyEncryptionKeyIdentityType

Tylko userAssignedIdentity jest obsługiwany w tej wersji interfejsu API; inne typy mogą być obsługiwane w przyszłości

Typ:CmkIdentityType
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-KeyEncryptionKeyIdentityUserAssignedIdentityResourceId

Tożsamość przypisana przez użytkownika do użycia na potrzeby uzyskiwania dostępu do adresu URL klucza szyfrowania kluczy. Np. /subscriptions/<sub uuid>/resourceGroups/<grupa zasobów>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-LinkedDatabase

Lista zasobów bazy danych do połączenia z tą bazą danych Aby utworzyć, zobacz sekcję UWAGI dla właściwości GEOREPLICATIONLINKEDDATABASE i utwórz tabelę skrótów. Aby utworzyć tabelę, zobacz sekcję UWAGI dla właściwości LINKEDDATABASE i utwórz tabelę skrótów.

Typ:ILinkedDatabase[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Location

Lokalizacja geograficzna, w której znajduje się zasób.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-MinimumTlsVersion

Minimalna wersja protokołu TLS dla klastra do obsługi — wartość domyślna to 1.2 Dozwolone wartości: 1.0, 1.1, 1.2

Typ:TlsVersion
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Module

Opcjonalny zestaw modułów redis do włączenia w tej bazie danych — moduły można dodawać tylko w czasie tworzenia. Aby utworzyć tabelę, zobacz sekcję UWAGI dla właściwości modułu i utwórz tabelę skrótów.

Typ:IModule[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-NoDatabase

Zaawansowane — nie twórz automatycznie domyślnej bazy danych. Ostrzeżenie: pamięć podręczna nie będzie można używać do momentu utworzenia bazy danych.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-NoWait

Uruchom polecenie asynchronicznie

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Port

Port TCP punktu końcowego bazy danych — domyślnie jest to dostępny port określony w czasie tworzenia.

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-RdbPersistenceEnabled

[Wersja zapoznawcza] Określa, czy trwałość bazy danych RDB jest włączona. Po włączeniu trwałości bazy danych RDB nie będzie można go wyłączyć. Obsługa wyłączania trwałości bazy danych RDB po włączeniu zostanie dodana w późniejszym terminie.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-RdbPersistenceFrequency

[Wersja zapoznawcza] Ustawia częstotliwość tworzenia migawki bazy danych, jeśli włączono trwałość bazy danych RDB. Dozwolone wartości: 1h, 6h, 12h

Typ:RdbFrequency
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ResourceGroupName

Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Sku

Typ klastra RedisEnterprise do wdrożenia. Zaakceptowane wartości: 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

Typ:SkuName
Aliasy:SkuName
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-SubscriptionId

Identyfikator subskrypcji docelowej.

Typ:String
Position:Named
Domyślna wartość:(Get-AzContext).Subscription.Id
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Tag

Tagi zasobów klastra.

Typ:Hashtable
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Zone

Strefy dostępności, w których zostanie wdrożony ten klaster.

Typ:String[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wyjściowe

ICluster