New-AzRedisCache

Referens

Modul:: Az.RedisCache

Skapar en Redis Cache.

Syntax

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

Cmdleten New-AzRedisCache skapar en Azure Redis Cache.

Exempel

Exempel 1: Skapa en 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               : []

Det här kommandot skapar en Redis Cache.

Exempel 2: Skapa en Standard 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               : []

Den här cmdleten skapar en cache med Azure Cache for Redis.

Exempel 3: Skapa en zonredundant cache

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}

Det här kommandot skapar Azure Cache for Redis-instansen i mutliple-zoner.

Exempel 4: Skapa en aktiverad cache för virtuellt nätverk

Krav för att skapa virtuellt nätverk aktiverar cache.

Skapa det virtuella nätverket i samma resursgrupp där du vill skapa redis-cachen. Du kan skapa ett virtuellt nätverk från powershell-kommandot New-AzVirtualNetwork .
Du behöver SubnetID för aktivering av VNET-cache. Syntaxen för SubnetID anges nedan.

Format för 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               : []

Exempel 5: Konfigurera datapersistence för en Premium Azure Cache for Redis

Persistence skriver Redis-data till ett Azure Storage-konto som du äger och hanterar. Innan du konfigurerar datapersistence måste du därför ha ett lagringskonto i samma resursgrupp. Välj ett lagringskonto i samma region och prenumeration som cachen, och ett Premium Storage-konto rekommenderas eftersom Premium Storage har högre dataflöde.

När du har skapat ett lagringskonto hämtar du lagringskontot anslutningssträng med den här proceduren.

Kör det här kommandot Get-AzStorageAccountKey -ResourceGroupName $resourceGroupName -Name $storageAccountName i powershell.
Kopiera valfri nyckel från ovanstående utdata.
Placera lagringskontonyckeln och lagringskontonamnet i formatet nedan för att hämta anslutningssträng för ditt lagringskonto.

Format för anslutningssträng :- "DefaultEndpointsProtocol=https; AccountName={storageAccountName}; AccountKey={storageAccountKey}; EndpointSuffix=mySuffix"

Du måste ha de specifika Redis-konfigurationsinställningarna för att aktivera datapersistence.

Aktivera RDB-säkerhetskopiering

rdb-backup-enabled (Ange sant eller falskt)
rdb-storage-connection-string (Ge anslutningssträng i ovanstående format.)
rdb-backup-frequency (Ange ett intervall för säkerhetskopiering i minuter. Du kan bara välja mellan - 15, 30, 60, 360, 720 och 1440 minuter.)

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

Exempel 6: Konfigurera datapersistence för en Premium Azure Cache for Redis – AOF-säkerhetskopiering aktiverad

För AOF-säkerhetskopiering aktiverat.

aof-backup-enabled (Ange sant eller falskt),
aof-storage-connection-string-0 (Ge anslutningssträng i ovanstående format.)
aof-storage-connection-string-1 (du kan också konfigurera ett annat lagringskonto. Om ett andra lagringskonto har konfigurerats skrivs skrivningar till replikcachen till det andra lagringskontot.)

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

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:	SwitchParameter
Alias:	cf
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:	IAzureContextContainer
Alias:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-DisableAccessKeyAuthentication

Valfritt: Autentisering till Redis via åtkomstnycklar inaktiveras när det anges som sant. Standardvärdet är "falsk".

Typ:	String
Position:	Named
Standardvärde:	false
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-EnableNonSslPort

Anger om icke-SSL-porten är aktiverad. Standardvärdet är $False (icke-SSL-porten är inaktiverad).

Typ:	Nullable<T>[Boolean]
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-IdentityType

Anger vilken typ av identitet som används för Azure Cache for Redis. Giltiga värden: "SystemAssigned" eller "UserAssigned" eller "SystemAssignedUserAssigned" eller "None"

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-Location

Anger den plats där du vill skapa en Redis Cache. Giltiga värden är:

USA, norra centrala
USA, södra centrala
Central US
Västeuropa
Europa, norra
USA, västra
East US
USA, östra 2
Japan, östra
Japan, västra
Brasilien, södra
Sydostasien
Asien, östra
Australien, östra
Australien, sydöstra

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-MinimumTlsVersion

Ange den TLS-version som krävs av klienter för att ansluta till cacheminnet.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-Name

Anger namnet på Redis Cache som ska skapas.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-RedisConfiguration

Anger Redis-konfigurationsinställningar. De acceptabla värdena för den här parametern är:

rdb-backup-enabled. Anger att Redis-datapersistence är aktiverat. Endast Premium-nivå.
rdb-storage-connection-string. Anger anslutningssträng till lagringskontot för Redis-datapersistence. Endast Premium-nivå.
rdb-backup-frequency. Anger säkerhetskopieringsfrekvensen för Redis-datapersistence. Endast Premium-nivå.
maxmemory-reserved. Konfigurerar det minne som är reserverat för processer som inte är cachelagrade. Standard- och Premium-nivåer.
maxmemory-policy. Konfigurerar borttagningsprincipen för cacheminnet. Alla prisnivåer.
notify-keyspace-events. Konfigurerar keyspace-meddelanden. Standard- och premiumnivåer.
hash-max-ziplist-entries. Konfigurerar minnesoptimering för små mängddatatyper. Standard- och Premium-nivåer.
hash-max-ziplist-value. Konfigurerar minnesoptimering för små mängddatatyper. Standard- och Premium-nivåer.
set-max-intset-entries. Konfigurerar minnesoptimering för små mängddatatyper. Standard- och Premium-nivåer.
zset-max-ziplist-entries. Konfigurerar minnesoptimering för små mängddatatyper. Standard- och Premium-nivåer.
zset-max-ziplist-value. Konfigurerar minnesoptimering för små mängddatatyper. Standard- och Premium-nivåer.
Databaser. Konfigurerar antalet databaser. Den här egenskapen kan endast konfigureras när cacheminnet skapas. Standard- och Premium-nivåer. Mer information finns i Hantera Azure Redis Cache med Azure PowerShellhttp://go.microsoft.com/fwlink/?LinkId=800051 (http://go.microsoft.com/fwlink/?LinkId=800051).
preferred-data-archive-auth-method Preferred auth-method Preferred auth method to communicate to storage account used for data archive, specify SAS or ManagedIdentity, default value is SAS
preferred-data-persistence-auth-method Preferred auth-method Preferred auth method to communicate to storage account used for data persistence, specify SAS or ManagedIdentity, default value is SAS

Typ:	Hashtable
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-RedisVersion

Redis-version. Detta bör vara i formatet "major[.minor]" (endast "major" krävs) eller värdet "senaste" som refererar till den senaste stabila Redis-versionen som är tillgänglig. Versioner som stöds: 4.0, 6.0 (senaste). Standardvärdet är "senaste".

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-ResourceGroupName

Anger namnet på resursgruppen där Redis Cache ska skapas.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-ShardCount

Anger antalet shards som ska skapas i ett Premium-klustercachen. De acceptabla värdena för den här parametern är:

Typ:	Nullable<T>[Int32]
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-Size

Anger storleken på Redis Cache. Giltiga värden är:

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 Standardvärdet är 1 GB eller C1.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-Sku

Anger SKU:n för Redis Cache som ska skapas. Giltiga värden är:

Basic
Standard
Premium Standardvärdet är Standard.

Typ:	String
Godkända värden:	Basic, Standard, Premium
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-StaticIP

Anger en unik IP-adress i undernätet för Redis Cache. Om du inte anger något värde för den här parametern väljer den här cmdleten en IP-adress från undernätet.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-SubnetId

Det fullständiga resurs-ID:t för ett undernät i ett virtuellt nätverk för att distribuera Azure Cache for Redis i. Exempelformat: /subscriptions/{subid}/resourceGroups/{resourceGroupName}/Microsoft. {Nätverk|ClassicNetwork}/VirtualNetworks/{vnetName}/subnets/{subnetName}

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-Tag

En hash-tabell som representerar taggar.

Typ:	Hashtable
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-TenantSettings

Den här parametern är inaktuell.

Typ:	Hashtable
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-UpdateChannel

Valfritt: Anger uppdateringskanalen för de månatliga Redis-uppdateringar som Redis Cache tar emot. Cacheminnen med hjälp av uppdateringskanalen Förhandsversion hämtar de senaste Redis-uppdateringarna minst 4 veckor före "Stabila" kanalcacheminnen. Standardvärdet är "Stabilt". Möjliga värden är: "Stabil", "Förhandsversion"

Typ:	String
Position:	Named
Standardvärde:	Stable
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-UserAssignedIdentity

Anger en eller flera kommaavgränsade användaridentiteter som ska associeras med Azure Cache for Redis. Användaridentitetsreferenserna är ARM-resurs-ID:n i formuläret: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identities/{identityName}'

Typ:	String[]
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Typ:	SwitchParameter
Alias:	wi
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Zone

Lista över Azure-regioner med tillgänglighetszoner.

Typ:	String[]
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

Indata

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

Utdata

RedisCacheAttributesWithAccessKeys

Dela via

New-AzRedisCache

Syntax

Description

Exempel

Exempel 1: Skapa en Redis Cache

Exempel 2: Skapa en Standard SKU Redis Cache

Exempel 3: Skapa en zonredundant cache

Exempel 4: Skapa en aktiverad cache för virtuellt nätverk

Exempel 5: Konfigurera datapersistence för en Premium Azure Cache for Redis

Exempel 6: Konfigurera datapersistence för en Premium Azure Cache for Redis – AOF-säkerhetskopiering aktiverad

Parametrar

-Confirm

-DefaultProfile

-DisableAccessKeyAuthentication

-EnableNonSslPort

-IdentityType

-Location

-MinimumTlsVersion

-Name

-RedisConfiguration

-RedisVersion

-ResourceGroupName

-ShardCount

-Size

-Sku

-StaticIP

-SubnetId

-Tag

-TenantSettings

-UpdateChannel

-UserAssignedIdentity

-WhatIf

-Zone

Indata

Utdata

Ytterligare resurser

Dela via

New-AzRedisCache

Syntax

Description

Exempel

Exempel 1: Skapa en Redis Cache

Exempel 2: Skapa en Standard SKU Redis Cache

Exempel 3: Skapa en zonredundant cache

Exempel 4: Skapa en aktiverad cache för virtuellt nätverk

Exempel 5: Konfigurera datapersistence för en Premium Azure Cache for Redis

Exempel 6: Konfigurera datapersistence för en Premium Azure Cache for Redis – AOF-säkerhetskopiering aktiverad

Parametrar

-Confirm

-DefaultProfile

-DisableAccessKeyAuthentication

-EnableNonSslPort

-IdentityType

-Location

-MinimumTlsVersion

-Name

-RedisConfiguration

-RedisVersion

-ResourceGroupName

-ShardCount

-Size

-Sku

-StaticIP

-SubnetId

-Tag

-TenantSettings

-UpdateChannel

-UserAssignedIdentity

-WhatIf

-Zone

Indata

Utdata

Relaterade länkar

Ytterligare resurser