New-AzRedisCache
Hiermee maakt u een Redis Cache.
Syntaxis
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
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 : ******
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 : []
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 : ******
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 : []
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 : ******
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}
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.
- Maak het virtuele netwerk in dezelfde resourcegroep waarin u de redis-cache wilt maken. U kunt een virtueel netwerk maken vanuit New-AzVirtualNetwork PowerShell-opdracht.
- 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 : ******
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 : []
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 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 de verbindingsreeks voor het opslagaccount op met behulp van deze procedure.
- Voer deze opdracht uit Get-AzStorageAccountKey -ResourceGroupName $resourceGroupName -Name $storageAccountName in PowerShell.
- Kopieer een willekeurige sleutel uit de bovenstaande uitvoer.
- 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.
Indeling van verbindingsreeks :- "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 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=******;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 : []
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 (Verbindingsreeks in bovenstaande indeling geven.)
- 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=******;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 : []
Parameters
-Confirm
U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.
Type: | SwitchParameter |
Aliassen: | cf |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-DefaultProfile
De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.
Type: | IAzureContextContainer |
Aliassen: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-DisableAccessKeyAuthentication
Optioneel: verificatie bij Redis via toegangssleutels is uitgeschakeld wanneer deze is ingesteld als waar. De standaardwaarde is onwaar.
Type: | String |
Position: | Named |
Default value: | false |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | 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 |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-IdentityType
Hiermee geeft u het type identiteit op dat wordt gebruikt voor Azure Cache voor Redis. Geldige waarden: 'SystemAssigned' of 'UserAssigned' of 'SystemAssignedUserAssigned' of 'None'
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-Location
Hiermee geeft u de locatie op waar een Redis-cache moet worden gemaakt. Geldige waarden zijn:
- VS - noord-centraal
- VS - zuid-centraal
- VS - centraal
- Europa - west
- Europa - noord
- VS - west
- VS - oost
- VS - oost 2
- Japan - oost
- Japan West
- Brazilië - zuid
- Zuidoost-Azië
- Oost-Azië
- Australië - oost
- Australië - zuidoost
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | 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 |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-Name
Hiermee geeft u de naam van de Redis Cache te maken.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-RedisConfiguration
Hiermee geeft u Redis-configuratie-instellingen. De acceptabele 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 voor het opslagaccount voor Redis-gegevenspersistentie op. 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 |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | 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 |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | 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 |
Vereist: | True |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-ShardCount
Hiermee geeft u het aantal shards op dat moet worden gemaakt in een Premium-clustercache. De acceptabele waarden voor deze parameter zijn:
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
Type: | Nullable<T>[Int32] |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-Size
Hiermee geeft u de grootte van de Redis Cache. Geldige waarden zijn:
- 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 De standaardwaarde is 1 GB of C1.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-Sku
Hiermee geeft u de SKU van de Redis Cache te maken. Geldige waarden zijn:
- Basisch
- Standaard
- Premium De standaardwaarde is Standard.
Type: | String |
Geaccepteerde waarden: | Basic, Standard, Premium |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | 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 |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-SubnetId
De volledige resource-id van een subnet in een virtueel netwerk waarin de Azure Cache voor Redis wordt geïmplementeerd. Voorbeeldindeling: /subscriptions/{subid}/resourceGroups/{resourceGroupName}/Microsoft. {Netwerk|ClassicNetwork}/VirtualNetworks/{vnetName}/subnetten/{subnetName}
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-Tag
Een hash-tabel die tags vertegenwoordigt.
Type: | Hashtable |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-TenantSettings
Deze parameter is afgeschaft.
Type: | Hashtable |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | 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 |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-UserAssignedIdentity
Hiermee geeft u een of meer door komma's gescheiden gebruikersidentiteiten op die moeten worden gekoppeld aan De Azure Cache voor Redis. 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 |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-WhatIf
Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.
Type: | SwitchParameter |
Aliassen: | wi |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-ZonalAllocationPolicy
Optioneel: Geeft aan hoe beschikbaarheidszones worden toegewezen aan de Redis-cache. 'Automatisch' maakt zoneredundantie mogelijk en Azure selecteert automatisch zones op basis van regionale beschikbaarheid en capaciteit. UserDefined selecteert beschikbaarheidszones die door u worden doorgegeven met behulp van de parameter Zones. 'NoZones' produceert een niet-zonegebonden cache. Als 'zonealAllocationPolicy' niet wordt doorgegeven, wordt deze ingesteld op UserDefined wanneer zones worden doorgegeven, anders wordt deze ingesteld op 'Automatisch' in regio's waar zones worden ondersteund en 'NoZones' in regio's waar zones niet worden ondersteund.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-Zone
Lijst met Azure-regio's met beschikbaarheidszones.
Type: | String[] |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
Invoerwaarden
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
Verwante koppelingen
Azure PowerShell