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>]
   [-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 pomocí příkazu Prostředí PowerShell New-AzVirtualNetwork .
  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ě získejte účet úložiště připojovací řetězec tímto postupem.

  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 (Dejte 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 zobrazí výzvu 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í hodnotou 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
  • Středojižní USA
  • Střední USA
  • Západní Evropa
  • Severní Evropa
  • USA – západ
  • East US
  • USA – východ 2
  • Japonsko – východ
  • Japonsko – západ
  • Brazílie – jih
  • Southeast Asia
  • 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. Tento parametr přijímá tyto hodnoty:

  • 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í Azure PowerShelluhttp://go.microsoft.com/fwlink/?LinkId=800051 (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. Tento parametr přijímá tyto hodnoty:

  • 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:

  • O1
  • P2
  • P3
  • P4
  • P5
  • C0
  • S1
  • C2
  • C3
  • C4
  • C5
  • C6
  • 250 MB
  • 1GB
  • 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:

  • Basic
  • 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

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

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

-Zone

Seznam oblastí Azure se 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