Udostępnij za pośrednictwem


New-AzRedisCache

Tworzy pamięć podręczną Redis Cache.

Składnia

New-AzRedisCache
   -ResourceGroupName <String>
   -Name <String>
   -Location <String>
   [-Size <String>]
   [-Sku <String>]
   [-RedisConfiguration <Hashtable>]
   [-EnableNonSslPort <Boolean>]
   [-TenantSettings <Hashtable>]
   [-ShardCount <Int32>]
   [-MinimumTlsVersion <String>]
   [-DisableAccessKeyAuthentication <Boolean>]
   [-SubnetId <String>]
   [-StaticIP <String>]
   [-Tag <Hashtable>]
   [-Zone <String[]>]
   [-RedisVersion <String>]
   [-UpdateChannel <String>]
   [-ZonalAllocationPolicy <String>]
   [-IdentityType <String>]
   [-UserAssignedIdentity <String[]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Opis

Polecenie cmdlet New-AzRedisCache tworzy pamięć podręczną Azure Redis Cache.

Przykłady

Przykład 1. Tworzenie pamięci podręcznej Redis Cache

New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "North Central US"

PrimaryKey         : ******
          SecondaryKey       : ******
          ResourceGroupName  : MyGroup
          Id                 : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/mycache
          Location           : North Central US
          Name               : MyCache
          Type               : Microsoft.Cache/Redis
          HostName           : mycache.redis.cache.windows.net
          Port               : 6379
          ProvisioningState  : creating
          SslPort            : 6380
          RedisConfiguration : {}
          EnableNonSslPort   : False
          RedisVersion       : 2.8
          Size               : 1GB
          Sku                : Standard
          Tag                : {}
          Zone               : []

To polecenie tworzy pamięć podręczną Redis Cache.

Przykład 2. Tworzenie pamięci podręcznej Redis Cache w warstwie Standardowa

New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "North Central US" -Size 250MB -Sku "Standard" -RedisConfiguration @{"maxmemory-policy" = "allkeys-random"}

PrimaryKey         : ******
          SecondaryKey       : ******
          ResourceGroupName  : MyGroup
          Id                 : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/MyCache
          Location           : North Central US
          Name               : mycache
          Type               : Microsoft.Cache/Redis
          HostName           : mycache.redis.cache.windows.net
          Port               : 6379
          ProvisioningState  : creating
          SslPort            : 6380
          RedisConfiguration : {[maxmemory-policy, allkeys-random]}
          EnableNonSslPort   : False
          RedisVersion       : 2.8
          Size               : 250MB
          Sku                : Standard
          Tag                : {}
          Zone               : []

To polecenie cmdlet tworzy pamięć podręczną przy użyciu usługi Azure Cache for Redis.

Przykład 3. Tworzenie strefowo nadmiarowej pamięci podręcznej

New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "Central US" -Size P1 -Sku "Premium" -Zone @("1","2")

PrimaryKey         : ******
          SecondaryKey       : ******
          ResourceGroupName  : MyGroup
          Id                 : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/MyCache
          Location           : Central US
          Name               : mycache
          Type               : Microsoft.Cache/Redis
          HostName           : mycache.redis.cache.windows.net
          Port               : 6379
          ProvisioningState  : creating
          SslPort            : 6380
          RedisConfiguration : {[maxmemory-policy, allkeys-random], [maxclients, 7500], [maxmemory-reserved, 200],
                                [maxfragmentationmemory-reserved, 300]...}
          EnableNonSslPort   : False
          RedisVersion       : 4.0.14
          Size               : 6GB
          Sku                : Premium
          Tag                : {}
          Zone               : {1, 2}

To polecenie tworzy wystąpienie usługi Azure Cache for Redis w strefach mutliple.

Przykład 4. Tworzenie sieci wirtualnej z włączoną pamięcią podręczną

Wymagania dotyczące tworzenia pamięci podręcznej włączania sieci wirtualnej.

  1. Utwórz sieć wirtualną w tej samej grupie zasobów, w której chcesz utworzyć pamięć podręczną Redis Cache. Sieć wirtualną można utworzyć na podstawie polecenia New-AzVirtualNetwork powershell.
  2. Będzie potrzebny identyfikator SubnetID dla pamięci podręcznej włączonej przez sieć wirtualną. Poniżej podano składnię identyfikatora SubnetID.

Format identyfikatora subnetID: /subscriptions/{subid}/resourceGroups/{resourceGroupName}/providers/Microsoft.ClassicNetwork/VirtualNetworks/{vnetName}/subnets/{subnetName}

New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "Central US" -Size P1 -Sku "Premium" -SubnetId "/subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Network/virtualNetworks/MyNet/subnets/MySubnet"

PrimaryKey         : ******
          SecondaryKey       : ******
          ResourceGroupName  : MyGroup
          Id                 : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/MyCache
          Location           : Central US
          Name               : mycache
          Type               : Microsoft.Cache/Redis
          HostName           : mycache.redis.cache.windows.net
          Port               : 6379
          ProvisioningState  : creating
          SslPort            : 6380
          RedisConfiguration : {[maxmemory-policy, allkeys-random], [maxclients, 7500], [maxmemory-reserved, 200],
                                [maxfragmentationmemory-reserved, 300]...}
          EnableNonSslPort   : False
          RedisVersion       : 4.0.14
          Size               : 6GB
          Sku                : Premium
          SubnetId           : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Network/virtualNetworks/MyNet/subnets/MySubnet
          StaticIP           : 10.0.0.4
          Tag                : {}
          Zone               : []

Przykład 5. Konfigurowanie trwałości danych dla usługi Azure Cache for Redis w warstwie Premium

Trwałość zapisuje dane usługi Redis na koncie usługi Azure Storage, którego jesteś właścicielem i którymi zarządzasz. Dlatego przed skonfigurowaniem trwałości danych musisz mieć konta magazynu w tej samej grupie zasobów. Wybierz konto magazynu w tym samym regionie i subskrypcji co pamięć podręczna, a konto usługi Premium Storage jest zalecane, ponieważ magazyn w warstwie Premium ma wyższą przepływność.

Po utworzeniu konta magazynu pobierz parametry połączenia konta magazynu przy użyciu tej procedury.

  1. Uruchom to polecenie Get-AzStorageAccountKey -ResourceGroupName $resourceGroupName -Name $storageAccountName w programie PowerShell.
  2. Z danych wyjściowych powyższych skopiuj dowolny klucz.
  3. Umieść klucz konta magazynu i nazwę konta magazynu w formacie poniżej, aby uzyskać parametry połączenia konta magazynu.

Format parametrów połączenia:- "DefaultEndpointsProtocol=https; AccountName={storageAccountName}; AccountKey={storageAccountKey}; EndpointSuffix=mySuffix"

Aby umożliwić trwałość danych, musisz mieć określone ustawienia konfiguracji usługi Redis.

W przypadku włączenia kopii zapasowej bazy danych RDB

  • Obsługa kopii zapasowej bazy danych rdb (ustaw wartość true lub false)
  • rdb-storage-connection-string (Nadaj parametry połączenia w powyższym formacie).
  • rdb-backup-frequency (Ustaw interwał tworzenia kopii zapasowej w minutach. Możesz wybrać tylko spośród - 15, 30, 60, 360, 720 i 1440 minut.
New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "Central US" -Size P1 -Sku "Premium" -RedisConfiguration @{"rdb-backup-enabled" = "true"; "rdb-storage-connection-string" = "DefaultEndpointsProtocol=https;AccountName=mystorageaccount;AccountKey=******;EndpointSuffix=mySuffix"; "rdb-backup-frequency" = "30"}

PrimaryKey         : ******
          SecondaryKey       : ******
          ResourceGroupName  : MyGroup
          Id                 : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/MyCache
          Location           : Central US
          Name               : mycache
          Type               : Microsoft.Cache/Redis
          HostName           : mycache.redis.cache.windows.net
          Port               : 6379
          ProvisioningState  : creating
          SslPort            : 6380
          RedisConfiguration : {[maxmemory-policy, allkeys-random], [maxclients, 7500], [maxmemory-reserved, 200],
                                [maxfragmentationmemory-reserved, 300], [rdb-backup-enabled, true]....}
          EnableNonSslPort   : False
          RedisVersion       : 4.0.14
          Size               : 6GB
          Sku                : Premium
          Tag                : {}
          Zone               : []

Przykład 6. Konfigurowanie trwałości danych dla usługi Azure Cache for Redis w warstwie Premium — włączono tworzenie kopii zapasowej AOF

W przypadku włączonej kopii zapasowej AOF.

  • aof-backup-enabled (Ustaw wartość true lub false)
  • aof-storage-connection-string-0 (Nadaj parametry połączenia w powyższym formacie).
  • aof-storage-connection-string-1 (opcjonalnie można skonfigurować inne konto magazynu. Jeśli skonfigurowano drugie konto magazynu, zapisy w pamięci podręcznej repliki są zapisywane na tym drugim koncie magazynu).
New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "Central US" -Size P1 -Sku "Premium" -RedisConfiguration @{"aof-backup-enabled" = "true"; "aof-storage-connection-string-0" = "DefaultEndpointsProtocol=https;AccountName=mystorageaccount;AccountKey=******;EndpointSuffix=mySuffix"}

PrimaryKey         : ******
          SecondaryKey       : ******
          ResourceGroupName  : MyGroup
          Id                 : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/MyCache
          Location           : Central US
          Name               : mycache
          Type               : Microsoft.Cache/Redis
          HostName           : mycache.redis.cache.windows.net
          Port               : 6379
          ProvisioningState  : creating
          SslPort            : 6380
          RedisConfiguration : {[maxmemory-policy, allkeys-random], [maxclients, 7500], [maxmemory-reserved, 200],
                                [maxfragmentationmemory-reserved, 300], [aof-backup-enabled, true]...}
          EnableNonSslPort   : False
          RedisVersion       : 4.0.14
          Size               : 6GB
          Sku                : Premium
          Tag                : {}
          Zone               : []

Parametry

-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

-DefaultProfile

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

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

-DisableAccessKeyAuthentication

Opcjonalnie: Uwierzytelnianie w usłudze Redis za pośrednictwem kluczy dostępu jest wyłączone po ustawieniu wartości true. Wartość domyślna to false.

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

-EnableNonSslPort

Wskazuje, czy port inny niż SSL jest włączony. Wartość domyślna to $False (port bez protokołu SSL jest wyłączony).

Typ:Nullable<T>[Boolean]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-IdentityType

Określa typ tożsamości używanej dla usługi Azure Cache for Redis. Prawidłowe wartości: "SystemAssigned" lub "UserAssigned" lub "SystemAssignedUserAssigned" lub "None"

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

-Location

Określa lokalizację, w której ma zostać utworzona pamięć podręczna Redis Cache. Prawidłowe wartości to:

  • Północno-środkowe stany USA
  • Południowo-środkowe stany USA
  • Środkowe stany USA
  • Europa Zachodnia
  • Europa Północna
  • Zachodnie stany USA
  • Wschodnie stany USA
  • Wschodnie stany USA 2
  • Japonia Wschodnia
  • Japonia Zachodnia
  • Brazylia Południowa
  • Azja Południowo-Wschodnia
  • Azja Wschodnia
  • Australia Wschodnia
  • Australia Południowo-Wschodnia
Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-MinimumTlsVersion

Określ wersję protokołu TLS wymaganą przez klientów do nawiązania połączenia z pamięcią podręczną.

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

-Name

Określa nazwę pamięci podręcznej Redis Cache do utworzenia.

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

-RedisConfiguration

Określa ustawienia konfiguracji usługi Redis. Dopuszczalne wartości tego parametru to:

  • usługa rdb z włączoną obsługą kopii zapasowej. Określa, że włączono trwałość danych usługi Redis. Tylko warstwa Premium.
  • rdb-storage-connection-string. Określa parametry połączenia z kontem magazynu dla trwałości danych usługi Redis. Tylko warstwa Premium.
  • rdb-backup-frequency. Określa częstotliwość tworzenia kopii zapasowych dla trwałości danych usługi Redis. Tylko warstwa Premium.
  • maxmemory-reserved. Konfiguruje pamięć zarezerwowaną dla procesów innych niż pamięć podręczna. Warstwy Standardowa i Premium.
  • maxmemory-policy. Konfiguruje zasady eksmisji dla pamięci podręcznej. Wszystkie warstwy cenowe.
  • notify-keyspace-events. Konfiguruje powiadomienia dotyczące przestrzeni kluczy. Warstwy Standardowa i Premium.
  • hash-max-ziplist-entries. Konfiguruje optymalizację pamięci dla małych zagregowanych typów danych. Warstwy Standardowa i Premium.
  • hash-max-ziplist-value. Konfiguruje optymalizację pamięci dla małych zagregowanych typów danych. Warstwy Standardowa i Premium.
  • set-max-intset-entries. Konfiguruje optymalizację pamięci dla małych zagregowanych typów danych. Warstwy Standardowa i Premium.
  • zset-max-ziplist-entries. Konfiguruje optymalizację pamięci dla małych zagregowanych typów danych. Warstwy Standardowa i Premium.
  • zset-max-ziplist-value. Konfiguruje optymalizację pamięci dla małych zagregowanych typów danych. Warstwy Standardowa i Premium.
  • Baz danych. Konfiguruje liczbę baz danych. Tę właściwość można skonfigurować tylko podczas tworzenia pamięci podręcznej. Warstwy Standardowa i Premium. Aby uzyskać więcej informacji, zobacz Zarządzanie usługą Azure Redis Cache przy użyciu programu Azure PowerShellhttp://go.microsoft.com/fwlink/?LinkId=800051 (http://go.microsoft.com/fwlink/?LinkId=800051).
  • preferred-data-archive-auth-method Preferowana metoda uwierzytelniania do komunikowania się z kontem magazynu używanym na potrzeby archiwizacji danych, określenie sygnatury dostępu współdzielonego lub identyfikatora zarządzanego, wartość domyślna to SAS
  • preferred-data-persistence-auth-method Preferowana metoda uwierzytelniania do komunikowania się z kontem magazynu używanym na potrzeby trwałości danych, określenie sygnatury dostępu współdzielonego lub identyfikatora zarządzanego, wartość domyślna to SAS
Typ:Hashtable
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-RedisVersion

Wersja usługi Redis. Powinno to mieć postać "główna[pomocnicza]" (wymagana jest tylko wartość główna) lub wartość "latest", która odnosi się do najnowszej stabilnej wersji usługi Redis, która jest dostępna. Obsługiwane wersje: 4.0, 6.0 (najnowsza wersja). Wartość domyślna to "latest".

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

-ResourceGroupName

Określa nazwę grupy zasobów, w której ma zostać utworzona pamięć podręczna Redis Cache.

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

-ShardCount

Określa liczbę fragmentów do utworzenia w pamięci podręcznej klastra Premium. Dopuszczalne wartości tego parametru to:

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
Typ:Nullable<T>[Int32]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Size

Określa rozmiar pamięci podręcznej Redis Cache. Prawidłowe wartości to:

  • P1
  • P2
  • P3
  • P4
  • P5
  • C0
  • C1
  • C2
  • C3
  • C4
  • C5
  • C6
  • 250 MB
  • 1 GB
  • 2,5 GB
  • 6 GB
  • 13 GB
  • 26 GB
  • 53 GB Wartość domyślna to 1 GB lub C1.
Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Sku

Określa jednostkę SKU pamięci podręcznej Redis Cache do utworzenia. Prawidłowe wartości to:

  • Podstawowy
  • Norma
  • Premium Wartość domyślna to Standardowa.
Typ:String
Dopuszczalne wartości:Basic, Standard, Premium
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-StaticIP

Określa unikatowy adres IP w podsieci dla pamięci podręcznej Redis Cache. Jeśli nie określisz wartości dla tego parametru, to polecenie cmdlet wybierze adres IP z podsieci.

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

-SubnetId

Pełny identyfikator zasobu podsieci w sieci wirtualnej w celu wdrożenia usługi Azure Cache for Redis. Przykładowy format: /subscriptions/{subid}/resourceGroups/{resourceGroupName}/Microsoft. {Sieć|ClassicNetwork}/VirtualNetworks/{vnetName}/subnets/{subnetName}

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

-Tag

Tabela skrótów reprezentująca tagi.

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

-TenantSettings

Ten parametr został przestarzały.

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

-UpdateChannel

Opcjonalnie: określa kanał aktualizacji miesięcznych aktualizacji usługi Redis, które będą odbierane przez pamięć podręczną Redis Cache. Pamięci podręczne korzystające z kanału aktualizacji "Wersja zapoznawcza" pobierają najnowsze aktualizacje usługi Redis co najmniej 4 tygodnie przed pamięciami podręcznymi kanału "Stable". Wartość domyślna to "Stable". Możliwe wartości to: "Stable", "Preview"

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

-UserAssignedIdentity

Określa co najmniej jedną tożsamość użytkownika rozdzieloną przecinkami, która ma być skojarzona z usługą Azure Cache for Redis. Odwołania do tożsamości użytkownika będą identyfikatorami zasobów usługi ARM w postaci : "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identities/{identityName}"

Typ:String[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
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

-ZonalAllocationPolicy

Opcjonalnie: Opcjonalnie: określa sposób przydzielania stref dostępności do pamięci podręcznej Redis Cache. Opcja "Automatyczne" umożliwia nadmiarowość strefy, a platforma Azure automatycznie wybiera strefy na podstawie dostępności regionalnej i pojemności. Element "UserDefined" wybierze strefy dostępności przekazane za pomocą parametru "zones". Wartość "NoZones" spowoduje utworzenie nieostrej pamięci podręcznej. Jeśli wartość "zonalAllocationPolicy" nie zostanie przekazana, zostanie ona ustawiona na wartość "UserDefined", gdy strefy są przekazywane, w przeciwnym razie zostanie ustawiona wartość "Automatyczna" w regionach, w których strefy są obsługiwane i "NoZones" w regionach, w których strefy nie są obsługiwane.

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

-Zone

Lista regionów platformy Azure z strefami dostępności .

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

Dane wejściowe

String

Hashtable

Nullable<T>[[System.Boolean, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

Nullable<T>[[System.Int32, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

String[]

Dane wyjściowe

RedisCacheAttributesWithAccessKeys