Sdílet prostřednictvím


New-AzRedisCache

Vytvoří mezipaměť Redis Cache.

Syntaxe

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

Description

Rutina New-AzRedisCache vytvoří Azure Redis Cache.

Příklady

Příklad 1: Vytvoření mezipaměti 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               : []

Tento příkaz vytvoří Redis Cache.

Příklad 2: Vytvoření standardní SKU Redis Cache

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               : []

Tato rutina vytvoří mezipaměť pomocí Azure Cache for Redis.

Příklad 3: Vytvoření zónově redundantní mezipaměti

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}

Tento příkaz vytvoří instanci Azure Cache for Redis v mutliple zónách.

Příklad 4: Vytvoření mezipaměti povolení virtuální sítě

Požadavky na vytvoření mezipaměti povolení virtuální sítě

  1. Vytvořte virtuální síť ve stejné skupině prostředků, ve které chcete vytvořit mezipaměť Redis. Virtuální síť můžete vytvořit z příkazu New-AzVirtualNetwork powershellu.
  2. Pro povolení mezipaměti virtuální sítě budete potřebovat ID podsítě. Syntaxe SUBNETID je uvedena níže.

Formát 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               : []

Příklad 5: Konfigurace trvalosti dat pro Azure Cache for Redis úrovně Premium

Trvalost zapisuje data Redis do účtu Azure Storage, který vlastníte a spravujete. Než tedy nakonfigurujete trvalost dat, musíte mít účet úložiště ve stejné skupině prostředků. Zvolte účet úložiště ve stejné oblasti a předplatném jako mezipaměť a doporučujeme účet Premium Storage, protože premium storage má vyšší propustnost.

Po vytvoření účtu úložiště pomocí tohoto postupu získejte připojovací řetězec účtu úložiště.

  1. Spusťte tento příkaz Get-AzStorageAccountKey -ResourceGroupName $resourceGroupName -Name $storageAccountName v PowerShellu.
  2. Z výstupu výše zkopírujte libovolný klíč.
  3. Zadejte klíč účtu úložiště a název účtu úložiště ve formátu níže, abyste získali připojovací řetězec vašeho účtu úložiště.

Formát připojovacího řetězce :- "DefaultEndpointsProtocol=https; AccountName={storageAccountName}; AccountKey={storageAccountKey}; EndpointSuffix=mySuffix"

Abyste mohli povolit trvalost dat, musíte mít konkrétní nastavení konfigurace Redis.

Povolení zálohování RDB

  • Povolení zálohování rdb (nastavení hodnoty true nebo false)
  • rdb-storage-connection-string (Zadejte připojovací řetězec ve výše uvedeném formátu.)
  • rdb-backup-frequency (Nastavte interval zálohování v minutách. Můžete si vybrat jenom z - 15, 30, 60, 360, 720 a 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               : []

Příklad 6: Konfigurace trvalosti dat pro službu Premium Azure Cache for Redis – Povolení zálohování AOF

Pro povolení zálohování AOF.

  • aof-backup-enabled (Nastavit true nebo false),
  • aof-storage-connection-string-0 (Zadejte připojovací řetězec ve výše uvedeném formátu.)
  • aof-storage-connection-string-1 (Volitelně můžete nakonfigurovat jiný účet úložiště. Pokud je nakonfigurovaný druhý účet úložiště, zápisy do mezipaměti repliky se zapíšou do tohoto druhého účtu úložiště.)
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

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DisableAccessKeyAuthentication

Volitelné: Ověřování pro Redis prostřednictvím přístupových klíčů je zakázané, pokud je nastavená hodnota true. Výchozí hodnota je false.

Typ:String
Position:Named
Default value:false
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-EnableNonSslPort

Určuje, jestli je povolený port bez SSL. Výchozí hodnota je $False (port bez SSL je zakázaný).

Typ:Nullable<T>[Boolean]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-IdentityType

Určuje typ identity, který se používá pro Azure Cache for Redis. Platné hodnoty: SystemAssigned nebo UserAssigned nebo SystemAssignedUserAssigned nebo None

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Location

Určuje umístění, ve kterém se má vytvořit redis Cache. Platné hodnoty jsou:

  • USA – středosever
  • USA – středojižní
  • USA – střed
  • Západní Evropa
  • Severní Evropa
  • USA – západ
  • USA – východ
  • USA – východ 2
  • Japonsko – východ
  • Japonsko – západ
  • Brazílie – jih
  • Jihovýchodní Asie
  • Východní Asie
  • Austrálie – východ
  • Austrálie – jihovýchod
Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-MinimumTlsVersion

Zadejte verzi protokolu TLS vyžadovanou klienty pro připojení k mezipaměti.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Name

Určuje název mezipaměti Redis, který se má vytvořit.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-RedisConfiguration

Určuje nastavení konfigurace Redis. Přijatelné hodnoty pro tento parametr jsou:

  • Povoleno zálohování rdb. Určuje, že je povolena trvalost dat Redis. Pouze úroveň Premium.
  • rdb-storage-connection-string. Určuje připojovací řetězec k účtu úložiště pro trvalost dat Redis. Pouze úroveň Premium.
  • rdb-backup-frequency. Určuje frekvenci zálohování pro trvalost dat Redis. Pouze úroveň Premium.
  • maxmemory-reserved. Nakonfiguruje paměť vyhrazenou pro procesy mimo mezipaměť. Úrovně Standard a Premium.
  • maxmemory-policy. Nakonfiguruje zásadu vyřazení pro mezipaměť. Všechny cenové úrovně.
  • notify-keyspace-events. Konfiguruje oznámení o prostoru klíčů. Úrovně Standard a Premium.
  • hash-max-ziplist-entries. Konfiguruje optimalizaci paměti pro malé agregované datové typy. Úrovně Standard a Premium.
  • hash-max-ziplist-value. Konfiguruje optimalizaci paměti pro malé agregované datové typy. Úrovně Standard a Premium.
  • set-max-intset-entries. Konfiguruje optimalizaci paměti pro malé agregované datové typy. Úrovně Standard a Premium.
  • zset-max-ziplist-entries. Konfiguruje optimalizaci paměti pro malé agregované datové typy. Úrovně Standard a Premium.
  • zset-max-ziplist-value. Konfiguruje optimalizaci paměti pro malé agregované datové typy. Úrovně Standard a Premium.
  • databáze. Konfiguruje počet databází. Tuto vlastnost lze nakonfigurovat pouze při vytváření mezipaměti. Úrovně Standard a Premium. Další informace najdete v tématu Správa služby Azure Redis Cache pomocíhttp://go.microsoft.com/fwlink/?LinkId=800051 Azure PowerShellu (http://go.microsoft.com/fwlink/?LinkId=800051).
  • preferred-data-archive-auth-method Preferred auth method to communicate to storage account used for data archive, specify SAS or ManagedIdentity, default value is SAS
  • upřednostňovaná metoda ověřování metodou preferovaného ověřování dat pro komunikaci s účtem úložiště používaným pro trvalost dat, zadání SAS nebo ManagedIdentity, výchozí hodnota je SAS.
Typ:Hashtable
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-RedisVersion

Verze Redis. Mělo by to být ve formátu major[.minor] (vyžaduje se pouze hlavní) nebo hodnota "latest", která odkazuje na nejnovější stabilní verzi Redis, která je k dispozici. Podporované verze: 4.0, 6.0 (nejnovější). Výchozí hodnota je "latest".

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ResourceGroupName

Určuje název skupiny prostředků, ve které se má vytvořit Redis Cache.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ShardCount

Určuje počet horizontálních oddílů, které se mají vytvořit v mezipaměti clusteru Premium. Přijatelné hodnoty pro tento parametr jsou:

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
Typ:Nullable<T>[Int32]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Size

Určuje velikost mezipaměti Redis Cache. Platné hodnoty jsou:

  • 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 Výchozí hodnota je 1 GB nebo C1.
Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Sku

Určuje skladovou položku mezipaměti Redis, která se má vytvořit. Platné hodnoty jsou:

  • Základní
  • Standard
  • Premium Výchozí hodnota je Standard.
Typ:String
Přípustné hodnoty:Basic, Standard, Premium
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-StaticIP

Určuje jedinečnou IP adresu v podsíti služby Redis Cache. Pokud nezadáte hodnotu pro tento parametr, tato rutina zvolí IP adresu z podsítě.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-SubnetId

Úplné ID prostředku podsítě ve virtuální síti pro nasazení služby Azure Cache for Redis. Příklad formátu: /subscriptions/{subid}/resourceGroups/{resourceGroupName}/Microsoft. {Network|ClassicNetwork}/VirtualNetworks/{vnetName}/subnets/{subnetName}

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Tag

Tabulka hash, která představuje značky.

Typ:Hashtable
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-TenantSettings

Tento parametr je zastaralý.

Typ:Hashtable
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-UpdateChannel

Volitelné: Určuje aktualizační kanál pro měsíční aktualizace Redis, které bude vaše služba Redis Cache přijímat. Mezipaměti používající aktualizační kanál Preview získávají nejnovější aktualizace Redis alespoň 4 týdny před mezipaměťmi kanálů Stable. Výchozí hodnota je Stabilní. Mezi možné hodnoty patří: Stabilní, Preview.

Typ:String
Position:Named
Default value:Stable
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-UserAssignedIdentity

Určuje jednu nebo více identit uživatele s hodnocením čárkami, které se mají přidružit ke službě Azure Cache for Redis. Odkazy na identitu uživatele budou ID prostředků ARM ve formuláři: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identityies/{identityName}.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ZonalAllocationPolicy

Volitelné: Volitelné: Určuje, jak se zóny dostupnosti přidělují do mezipaměti Redis. Možnost Automatické umožňuje redundanci zón a Azure automaticky vybere zóny na základě regionální dostupnosti a kapacity. UserDefined vybere zóny dostupnosti předané vámi pomocí parametru zones. NoZones vytvoří zónovou mezipaměť. Pokud se nepředá 'zonalAllocationPolicy', nastaví se při předávání zón na Hodnotu UserDefined. V opačném případě se v oblastech, kde jsou zóny podporované, nastaví na Hodnotu Automatic a NoZones v oblastech, ve kterých nejsou zóny podporovány.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Zone

Seznam oblastí Azure s zónami dostupnosti.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

Vstupy

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[]

Výstupy

RedisCacheAttributesWithAccessKeys