New-AzRedisCache

  • Odwołanie
Moduł:
Az.RedisCache

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>]
   [-SubnetId <String>]
   [-StaticIP <String>]
   [-Tag <Hashtable>]
   [-Zone <String[]>]
   [-RedisVersion <String>]
   [-UpdateChannel <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         : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          SecondaryKey       : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          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         : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          SecondaryKey       : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          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         : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          SecondaryKey       : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          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ć za pomocą polecenia New-AzVirtualNetwork programu 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         : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          SecondaryKey       : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          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ć konto 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 konto magazynu parametry połączenia 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 ciągu Połączenie ion:- "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=pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=;EndpointSuffix=mySuffix"; "rdb-backup-frequency" = "30"}

PrimaryKey         : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          SecondaryKey       : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          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=pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=;EndpointSuffix=mySuffix"}

PrimaryKey         : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          SecondaryKey       : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          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.

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

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableNonSslPort

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

Type:Nullable<T>[Boolean]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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"

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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
  • South Central US
  • Central US
  • West Europe
  • Europa Północna
  • Zachodnie stany USA
  • East US
  • Wschodnie stany USA 2
  • Japonia Wschodnia
  • Japonia Zachodnia
  • Brazylia Południowa
  • Southeast Asia
  • Azja Wschodnia
  • Australia Wschodnia
  • Australia Południowo-Wschodnia
Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-MinimumTlsVersion

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

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

-Name

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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 do konta 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
Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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".

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

-ResourceGroupName

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Sku

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

  • Podstawowa
  • Standardowa (Standard)
  • Premium Wartość domyślna to Standardowa.
Type:String
Accepted values:Basic, Standard, Premium
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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}

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

-Tag

Tabela skrótów reprezentująca tagi.

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

-TenantSettings

Ten parametr został przestarzały.

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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"

Type:String
Position:Named
Default value:Stable
Required:False
Accept pipeline input:True
Accept wildcard characters: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}"

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

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

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

-Zone

Lista regionów świadczenia usługi Azure ze strefami dostępności.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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