New-AzRedisCache

Referentie

Module:: Az.RedisCache

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>]
   [-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 de PowerShell-opdracht New-AzVirtualNetwork .
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 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.

Voer deze opdracht Get-AzStorageAccountKey -ResourceGroupName $resourceGroupName -Name $storageAccountName uit 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 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=******;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 (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=******;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

Hiermee wordt u 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 false.

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 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
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
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
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 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
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 aanvaardbare waarden voor deze parameter zijn:

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
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
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	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
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 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
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 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
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-WhatIf

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

Type:	SwitchParameter
Aliassen:	wi
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
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

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

Delen via

New-AzRedisCache

Syntaxis

Description

Voorbeelden

Voorbeeld 1: Een Redis-cache maken

Voorbeeld 2: Een Standard SKU Redis Cache maken

Voorbeeld 3: Een zoneredundante cache maken

Voorbeeld 4: Cache inschakelen voor een virtueel netwerk

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

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

Parameters

-Confirm

-DefaultProfile

-DisableAccessKeyAuthentication

-EnableNonSslPort

-IdentityType

-Location

-MinimumTlsVersion

-Name

-RedisConfiguration

-RedisVersion

-ResourceGroupName

-ShardCount

-Size

-Sku

-StaticIP

-SubnetId

-Tag

-TenantSettings

-UpdateChannel

-UserAssignedIdentity

-WhatIf

-Zone

Invoerwaarden

Uitvoerwaarden

Aanvullende resources

Delen via

New-AzRedisCache

Syntaxis

Description

Voorbeelden

Voorbeeld 1: Een Redis-cache maken

Voorbeeld 2: Een Standard SKU Redis Cache maken

Voorbeeld 3: Een zoneredundante cache maken

Voorbeeld 4: Cache inschakelen voor een virtueel netwerk

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

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

Parameters

-Confirm

-DefaultProfile

-DisableAccessKeyAuthentication

-EnableNonSslPort

-IdentityType

-Location

-MinimumTlsVersion

-Name

-RedisConfiguration

-RedisVersion

-ResourceGroupName

-ShardCount

-Size

-Sku

-StaticIP

-SubnetId

-Tag

-TenantSettings

-UpdateChannel

-UserAssignedIdentity

-WhatIf

-Zone

Invoerwaarden

Uitvoerwaarden

Verwante koppelingen

Aanvullende resources