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ě
- 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 .
- 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.
- Spusťte tento příkaz Get-AzStorageAccountKey -ResourceGroupName $resourceGroupName -Name $storageAccountName v PowerShellu.
- Z výstupu výše zkopírujte libovolný klíč.
- 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
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
Související odkazy
Azure PowerShell