New-AzRedisCache

  • Referentie
Module:
Az.RedisCache

Hiermee maakt u een 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>]
   [-SubnetId <String>]
   [-StaticIP <String>]
   [-Tag <Hashtable>]
   [-Zone <String[]>]
   [-RedisVersion <String>]
   [-UpdateChannel <String>]
   [-IdentityType <String>]
   [-UserAssignedIdentity <String[]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Met de cmdlet New-AzRedisCache wordt een Azure Redis Cache gemaakt.

Voorbeelden

Voorbeeld 1: Een Redis-cache maken

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

Met deze opdracht maakt u een Redis Cache.

Voorbeeld 2: Een Standard SKU Redis Cache maken

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

Met deze cmdlet maakt u een cache met behulp van Azure Cache voor Redis.

Voorbeeld 3: Een zoneredundante cache maken

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}

Met deze opdracht maakt u een Exemplaar van Azure Cache voor Redis in mutliple zones.

Voorbeeld 4: Cache inschakelen voor een virtueel netwerk

Vereisten voor het maken van Een virtueel netwerk inschakelen cache.

  1. Maak het virtuele netwerk in dezelfde resourcegroep waarin u de redis-cache wilt maken. U kunt een virtueel netwerk maken vanuit de PowerShell-opdracht New-AzVirtualNetwork .
  2. U hebt SubnetID nodig voor het inschakelen van de cache van VNET. Hieronder ziet u de syntaxis van subnet-id.

Indeling van SubnetID: /subscriptions/{subid}/resourceGroups/{resourceGroupName}/providers/Microsoft.ClassicNetwork/VirtualNetworks/{vnetName}/subnetten/{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               : []

Voorbeeld 5: Gegevenspersistentie configureren voor een Premium-Azure Cache voor Redis

Persistentie schrijft Redis-gegevens naar een Azure Storage-account dat u bezit en beheert. Dus voordat u gegevenspersistentie configureert, moet u een opslagaccount in dezelfde resourcegroep hebben. Kies een opslagaccount in dezelfde regio en hetzelfde abonnement als de cache en een Premium Storage-account wordt aanbevolen omdat Premium-opslag een hogere doorvoer heeft.

Nadat u een opslagaccount hebt gemaakt, haalt u het opslagaccount op verbindingsreeks met behulp van deze procedure.

  1. Voer deze opdracht Get-AzStorageAccountKey -ResourceGroupName $resourceGroupName -Name $storageAccountName uit in PowerShell.
  2. Kopieer een willekeurige sleutel uit de bovenstaande uitvoer.
  3. Plaats de sleutel van het opslagaccount en de naam van het opslagaccount in de onderstaande indeling om de verbindingsreeks van uw opslagaccount op te halen.

Verbinding maken ion String Format :- "DefaultEndpointsProtocol=https; AccountName={storageAccountName}; AccountKey={storageAccountKey}; EndpointSuffix=mySuffix"

U moet de specifieke Redis-configuratie-instellingen hebben om persistentie van gegevens in te schakelen.

Inschakelen van RDB-back-up

  • rdb-backup ingeschakeld (waar of onwaar instellen)
  • rdb-storage-connection-string (Geef verbindingsreeks in de bovenstaande indeling.)
  • rdb-backup-frequency (stel een back-upinterval in minuten in. U kunt alleen kiezen uit - 15, 30, 60, 360, 720 en 1440 minuten.)
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               : []

Voorbeeld 6: Gegevenspersistentie configureren voor een Premium-Azure Cache voor Redis - AOF-back-up ingeschakeld

Voor AOF-back-up ingeschakeld.

  • aof-back-up ingeschakeld (waar of onwaar instellen),
  • aof-storage-connection-string-0 (Geef verbindingsreeks in de bovenstaande indeling.)
  • aof-storage-connection-string-1 (u kunt eventueel een ander opslagaccount configureren. Als een tweede opslagaccount is geconfigureerd, worden de schrijfbewerkingen naar de replicacache naar dit tweede opslagaccount geschreven.)
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               : []

Parameters

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

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

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.

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

-EnableNonSslPort

Geeft aan of de niet-SSL-poort is ingeschakeld. De standaardwaarde is $False (de niet-SSL-poort is uitgeschakeld).

Type:Nullable<T>[Boolean]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-IdentityType

Hiermee geeft u het type identiteit dat wordt gebruikt voor de Azure Cache voor Redis. Geldige waarden: 'SystemAssigned' of 'UserAssigned' of 'SystemAssignedUserAssigned' of 'None'

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

-Location

Hiermee geeft u de locatie op waar een Redis-cache moet worden gemaakt. Geldige waarden zijn:

  • VS - noord-centraal
  • VS - zuid-centraal
  • Central US
  • Europa -west
  • Europa - noord
  • VS - west
  • VS - oost
  • VS - oost 2
  • Japan - oost
  • Japan - west
  • Brazilië - zuid
  • Azië - zuidoost
  • Azië - oost
  • Australië - oost
  • Australië - zuidoost
Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-MinimumTlsVersion

Geef de TLS-versie op die clients nodig hebben om verbinding te maken met de cache.

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

-Name

Hiermee geeft u de naam van de Redis Cache te maken.

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

-RedisConfiguration

Hiermee geeft u Redis-configuratie-instellingen. De aanvaardbare waarden voor deze parameter zijn:

  • rdb-backup ingeschakeld. Hiermee geeft u op dat Redis-gegevenspersistentie is ingeschakeld. Alleen de Premium-laag.
  • rdb-storage-connection-string. Hiermee geeft u de verbindingsreeks aan het opslagaccount voor Redis-gegevenspersistentie. Alleen de Premium-laag.
  • rdb-backup-frequency. Hiermee geeft u de back-upfrequentie voor Redis-gegevenspersistentie. Alleen de Premium-laag.
  • maxmemory-reserved. Hiermee configureert u het geheugen dat is gereserveerd voor niet-cacheprocessen. Standard- en Premium-lagen.
  • maxmemory-beleid. Hiermee configureert u het verwijderingsbeleid voor de cache. Alle prijscategorieën.
  • notify-keyspace-events. Hiermee configureert u keyspacemeldingen. Standard- en Premium-lagen.
  • hash-max-ziplist-vermeldingen. Hiermee configureert u geheugenoptimalisatie voor kleine geaggregeerde gegevenstypen. Standard- en Premium-lagen.
  • hash-max-ziplist-value. Hiermee configureert u geheugenoptimalisatie voor kleine geaggregeerde gegevenstypen. Standard- en Premium-lagen.
  • set-max-intset-entries. Hiermee configureert u geheugenoptimalisatie voor kleine geaggregeerde gegevenstypen. Standard- en Premium-lagen.
  • zset-max-ziplist-vermeldingen. Hiermee configureert u geheugenoptimalisatie voor kleine geaggregeerde gegevenstypen. Standard- en Premium-lagen.
  • zset-max-ziplist-value. Hiermee configureert u geheugenoptimalisatie voor kleine geaggregeerde gegevenstypen. Standard- en Premium-lagen.
  • Databases. Hiermee configureert u het aantal databases. Deze eigenschap kan alleen worden geconfigureerd bij het maken van de cache. Standard- en Premium-lagen. Zie Azure Redis Cache beheren met Azure PowerShellhttp://go.microsoft.com/fwlink/?LinkId=800051 (http://go.microsoft.com/fwlink/?LinkId=800051) voor meer informatie.
  • preferred-data-archive-auth-method Preferred authentication 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 to communicate to storage account used for data persistence, specify SAS or ManagedIdentity, default value is SAS
Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-RedisVersion

Redis-versie. Dit moet de vorm 'major[.minor]' hebben (alleen 'major' is vereist) of de waarde 'latest' die verwijst naar de meest recente stabiele Redis-versie die beschikbaar is. Ondersteunde versies: 4.0, 6.0 (nieuwste versie). De standaardwaarde is 'latest'.

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

-ResourceGroupName

Hiermee geeft u de naam op van de resourcegroep waarin de Redis Cache moet worden gemaakt.

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

-ShardCount

Hiermee geeft u het aantal shards op dat moet worden gemaakt in een Premium-clustercache. De aanvaardbare waarden voor deze parameter zijn:

  • 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

Hiermee geeft u de grootte van de Redis Cache. Geldige waarden zijn:

  • P1
  • P2
  • P3
  • P4
  • B5
  • C0
  • C1
  • C2
  • C3
  • C4
  • C5
  • C6
  • 250 MB
  • 1 GB
  • 2,5 GB
  • 6 GB
  • 13 GB
  • 26 GB
  • 53 GB De standaardwaarde is 1 GB of C1.
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Sku

Hiermee geeft u de SKU van de Redis Cache te maken. Geldige waarden zijn:

  • Basic
  • Standaard
  • Premium De standaardwaarde is Standard.
Type:String
Accepted values:Basic, Standard, Premium
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-StaticIP

Hiermee geeft u een uniek IP-adres in het subnet voor de Redis Cache. Als u geen waarde voor deze parameter opgeeft, kiest deze cmdlet een IP-adres uit het subnet.

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

-SubnetId

De volledige resource-id van een subnet in een virtueel netwerk om de Azure Cache voor Redis te implementeren. Voorbeeldindeling: /subscriptions/{subid}/resourceGroups/{resourceGroupName}/Microsoft. {Netwerk|ClassicNetwork}/VirtualNetworks/{vnetName}/subnetten/{subnetName}

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

-Tag

Een hash-tabel die tags vertegenwoordigt.

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

-TenantSettings

Deze parameter is afgeschaft.

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

-UpdateChannel

Optioneel: Hiermee geeft u het updatekanaal voor de maandelijkse Redis-updates op die uw Redis-cache ontvangt. Caches die gebruikmaken van het updatekanaal 'Preview' krijgen de meest recente Redis-updates ten minste 4 weken voor de 'Stabiele' kanaalcaches. De standaardwaarde is 'Stabiel'. Mogelijke waarden zijn: 'Stabiel', 'Preview'

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

-UserAssignedIdentity

Hiermee geeft u een of meer door komma's gescheiden gebruikersidentiteiten op die aan de Azure Cache voor Redis moeten worden gekoppeld. De verwijzingen naar gebruikersidentiteiten zijn ARM-resource-id's in de vorm: /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

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

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

-Zone

Lijst met Azure-regio's met beschikbaarheidszones.

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

Invoerwaarden

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

Uitvoerwaarden

RedisCacheAttributesWithAccessKeys