Azure Redis beheren met Azure PowerShell
Azure Managed Redis
Als u een exemplaar van Azure Managed Redis (preview) wilt maken, meldt u zich aan bij Azure Portal en selecteert u Een resource maken.
Selecteer op de pagina Nieuw de optie Databases en selecteer vervolgens Azure Cache voor Redis.
Configureer op de pagina Nieuwe Redis-cache de instellingen voor de nieuwe cache.
Selecteer Volgende: Netwerken en selecteer een openbaar of privé-eindpunt.
Selecteer Volgende: Geavanceerd. Hier kunt u eventuele Redis-modules configureren die aan het exemplaar moeten worden toegevoegd.
Stel clusterbeleid in op Enterprise voor een niet-geclusterde cache of op OSS voor een geclusterde cache. Zie Clusterbeleid voor meer informatie over het kiezen van Clusterbeleid.
Als u actieve geo-replicatie gebruikt, moet deze worden geconfigureerd tijdens het maken. Zie Actieve geo-replicatie configureren voor Azure Managed Redis-exemplaren voor instructies hierover.
Belangrijk
U kunt het clusterbeleid van een Azure Managed Redis-exemplaar (preview) niet wijzigen nadat u het hebt gemaakt. Als u RediSearch gebruikt , is het clusterbeleid voor ondernemingen vereist en
NoEvictionwordt het enige verwijderingsbeleid ondersteund.Belangrijk
Als u dit cache-exemplaar in een geo-replicatiegroep gebruikt, kan verwijderingsbeleid niet worden gewijzigd nadat het exemplaar is gemaakt. Zorg ervoor dat u het verwijderingsbeleid van uw primaire knooppunten kent voordat u de cache maakt. Zie Vereisten voor actieve geo-replicatie voor meer informatie over actieve geo-replicatie.
Belangrijk
U kunt modules niet wijzigen nadat u een cache-exemplaar hebt gemaakt. Modules moeten zijn ingeschakeld op het moment dat u een Azure Cache voor Redis exemplaar maakt. Er is geen optie om de configuratie van een module in te schakelen nadat u een cache hebt gemaakt.
Selecteer Volgende: Tags en overslaan.
Selecteer Volgende: Beoordelen en maken.
Controleer de instellingen en selecteer Maken.
Het duurt enkele minuten voordat het Redis-exemplaar is gemaakt. U kunt de voortgang controleren op de overzichtspagina van Azure Managed Redis. Als u bij Status Wordt uitgevoerd ziet staan, kunt u de cache gebruiken.
Azure Cache voor Redis
Meld u aan bij Azure Portal om een cache te maken. Selecteer een resource maken in het portalmenu.
Voer in het deelvenster Aan de slag Azure Cache voor Redis in de zoekbalk in. Zoek Azure Cache voor Redis in de zoekresultaten en selecteer Vervolgens Maken.
Configureer in het deelvenster Nieuwe Redis Cache op het tabblad Basis de volgende instellingen voor uw cache:
Instelling Actie Beschrijving Abonnement Selecteer uw Azure-abonnement. Het abonnement dat moet worden gebruikt om het nieuwe exemplaar van Azure Cache voor Redis te maken. Resourcegroep Selecteer een resourcegroep of selecteer Nieuwe maken en voer een nieuwe resourcegroepnaam in. Een naam voor de resourcegroep waarin u uw cache en andere resources wilt maken. Door al uw app-resources in één resourcegroep te plaatsen, kunt u ze eenvoudig beheren of verwijderen. DNS-naam Voer een unieke naam in. De cachenaam moet een tekenreeks van 1 tot 63 tekens zijn die alleen cijfers, letters en afbreekstreepjes bevat. De naam moet beginnen en eindigen met een getal of letter en mag geen opeenvolgende afbreekstreepjes bevatten. De hostnaam van uw cache-exemplaar is \<DNS name>.redis.cache.windows.net.Location Selecteer een locatie. Een Azure-regio in de buurt van andere services die gebruikmaken van uw cache. Cache-SKU Selecteer een SKU. De SKU bepaalt de grootte, prestaties en functieparameters die beschikbaar zijn voor de cache. Zie Azure Cache voor Redis overzicht voor meer informatie. Cachegrootte Selecteer een cachegrootte. Zie Azure Cache voor Redis overzicht voor meer informatie. Selecteer het tabblad Netwerken of selecteer Volgende: Netwerken.
Selecteer op het tabblad Netwerken een connectiviteitsmethode die u voor de cache wilt gebruiken.
Selecteer het tabblad Geavanceerd of selecteer Volgende: Geavanceerd.
Controleer of selecteer in het deelvenster Geavanceerd een verificatiemethode op basis van de volgende informatie:
- Microsoft Entra Authentication is standaard ingeschakeld voor een nieuwe Basic-, Standard- of Premium-cache en toegangssleutelsverificatie is uitgeschakeld.
- Voor Basic- of Standard-caches kunt u de selectie voor een niet-TLS-poort kiezen.
- Voor Standard- en Premium-caches kunt u ervoor kiezen om beschikbaarheidszones in te schakelen. U kunt beschikbaarheidszones niet uitschakelen nadat de cache is gemaakt.
- Voor een Premium-cache configureert u de instellingen voor niet-TLS-poort, clustering, beheerde identiteit en gegevenspersistentie.
Belangrijk
Voor optimale beveiliging wordt u aangeraden Microsoft Entra ID met beheerde identiteiten te gebruiken om aanvragen tegen uw cache te autoriseren, indien mogelijk. Autorisatie met behulp van Microsoft Entra ID en beheerde identiteiten biedt superieure beveiliging en gebruiksgemak ten opzichte van autorisatie van gedeelde toegangssleutels. Zie Microsoft Entra ID gebruiken voor cacheverificatie voor meer informatie over het gebruik van beheerde identiteiten met uw cache.
(Optioneel) Selecteer het tabblad Tags of selecteer Volgende: Tags.
(Optioneel) Voer op het tabblad Tags een tagnaam en -waarde in als u de cacheresource wilt categoriseren.
Selecteer de knop Controleren en maken.
Op het tabblad Controleren en maken valideert Azure uw configuratie automatisch.
Nadat het groene bericht Validatie is geslaagd , selecteert u Maken.
Een nieuwe cache-implementatie vindt meer dan enkele minuten plaats. U kunt de voortgang van de implementatie controleren in het deelvenster Azure Cache voor Redis Overzicht. Wanneer de status Wordt uitgevoerd, is de cache gereed voor gebruik.
In dit artikel leest u hoe u azure Redis-exemplaren maakt, bijwerkt en schaalt.
Notitie
Azure heeft twee verschillende implementatiemodellen die u kunt gebruiken om resources te maken en ermee te werken: Azure Resource Manager en klassiek. Dit artikel is van toepassing op het gebruik van het Resource Manager-implementatiemodel. We bevelen het Resource Manager-implementatiemodel voor de meeste nieuwe implementaties, in plaats van het klassieke implementatiemodel.
Zie Azure Resource Manager versus klassieke implementatie voor meer informatie over het klassieke implementatiemodel : Implementatiemodellen en de status van uw resources begrijpen.
Vereisten
Als u Azure PowerShell al hebt geïnstalleerd, moet u Beschikken over Azure PowerShell versie 12.4.0 of hoger. U kunt de versie van Azure PowerShell controleren met deze opdracht via de Azure PowerShell-opdrachtprompt.
Get-Module Az | format-table version
Eerst moet u zich met deze opdracht aanmelden bij Azure.
Connect-AzAccount
Geef het e-mailadres van uw Azure-account en uw wachtwoord op in het aanmeldingsdialoogvenster van Microsoft Azure.
Als u meerdere Azure-abonnementen hebt, moet u vervolgens uw Azure-abonnement instellen. Voer deze opdracht uit om een lijst met uw huidige abonnementen weer te geven.
Get-AzSubscription | sort SubscriptionName | Select SubscriptionName
Voer de volgende opdracht uit om het abonnement op te geven. In het volgende voorbeeld is ContosoSubscriptionde naam van het abonnement.
Select-AzSubscription -SubscriptionName ContosoSubscription
Voordat u Windows PowerShell kunt gebruiken met Azure Resource Manager, moet u de configuratie controleren:
- Windows PowerShell, versie 3.0 of 4.0. Als u de versie van Windows PowerShell wilt zoeken, typt u:
$PSVersionTableen controleert u of de waardePSVersion3.0 of 4.0 is. Zie Windows Management Framework 3.0 als u een compatibele versie wilt installeren.
Gebruik de Cmdlet Get-Help om gedetailleerde hulp te krijgen voor alle cmdlets die u in deze zelfstudie ziet.
Get-Help <cmdlet-name> -Detailed
Als u bijvoorbeeld hulp voor de New-AzRedisEnterpriseCache cmdlet wilt krijgen, typt u:
Get-Help New-AzRedisEnterpriseCache -Detailed
Verbinding maken met andere clouds
Standaard is AzureCloudde Azure-omgeving, die het globale Azure-cloudexemplaren vertegenwoordigt. Als u verbinding wilt maken met een ander exemplaar, gebruikt u de opdracht met de Connect-AzAccount -Environment of-opdrachtregelswitchEnvironmentName met de gewenste omgevings- of omgevingsnaam.
Voer de Get-AzEnvironment cmdlet uit om de lijst met beschikbare omgevingen weer te geven.
Verbinding maken met de Azure Government Cloud
Gebruik een van de volgende opdrachten om verbinding te maken met de Azure Government Cloud.
Connect-AzAccount -EnvironmentName AzureUSGovernment
Or
Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureUSGovernment)
Als u een cache wilt maken in de Azure Government Cloud, gebruikt u een van de volgende locaties.
- USGov Virginia
- USGov Iowa
Zie de ontwikkelaarshandleiding voor Microsoft Azure Government en Microsoft Azure Government voor meer informatie over de Azure Government-cloud.
Verbinding maken met Microsoft Azure beheerd door 21Vianet Cloud
Gebruik een van de volgende opdrachten om verbinding te maken met de Azure-cloud die wordt beheerd door 21Vianet.
Connect-AzAccount -EnvironmentName AzureChinaCloud
Or
Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureChinaCloud)
Als u een cache wilt maken in Azure die wordt beheerd door 21Vianet Cloud, gebruikt u een van de volgende locaties.
- China - oost
- China - noord
Verbinding maken met Microsoft Azure Duitsland
Gebruik een van de volgende opdrachten om verbinding te maken met Microsoft Azure Duitsland.
Connect-AzAccount -EnvironmentName AzureGermanCloud
Or
Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureGermanCloud)
Als u een cache wilt maken in Microsoft Azure Duitsland, gebruikt u een van de volgende locaties.
- Duitsland - centraal
- Duitsland - noordoost
Zie Microsoft Azure Duitsland voor meer informatie over Microsoft Azure Duitsland.
Azure Managed Redis PowerShell-parameters en -eigenschappen
Zie New-AzRedisEnterpriseCache voor een lijst met alle door Azure beheerde Redis PowerShell-parameters en -eigenschappen.
Een door Azure beheerde Redis maken
Nieuwe azure Managed Redis-exemplaren worden gemaakt met behulp van de cmdlet New-AzRedisEnterpriseCache .
Belangrijk
De eerste keer dat u een Azure Managed Redis in een abonnement maakt met behulp van Azure Portal, registreert de portal de Microsoft.Cache naamruimte voor dat abonnement. Als u de eerste Azure Managed Redis in een abonnement probeert te maken met behulp van PowerShell, moet u die naamruimte eerst registreren met behulp van de volgende opdracht; anders mislukken cmdlets zoals New-AzRedisEnterpriseCache en Get-AzRedisEnterpriseCache mislukken.
Register-AzResourceProvider -ProviderNamespace "Microsoft.Cache"
Voer de volgende opdracht uit om een lijst met beschikbare parameters en de bijbehorende beschrijvingen weer New-AzRedisEnterpriseCachete geven.
PS C:\> Get-Help New-AzRedisEnterpriseCache -detailed
NAME
New-AzRedisEnterpriseCache
SYNOPSIS
Creates a new Azure Managed Redis.
SYNTAX
New-AzRedisEnterpriseCache -Name <String> -ResourceGroupName <String> -Location <String> [-RedisVersion <String>]
[-Sku <String>] [-MaxMemoryPolicy <String>] [-RedisConfiguration <Hashtable>] [-EnableNonSslPort
<Boolean>] [-ShardCount <Integer>] [-VirtualNetwork <String>] [-Subnet <String>] [-StaticIP <String>]
[<CommonParameters>]
DESCRIPTION
The New-AzRedisEnterpriseCache cmdlet creates a new Azure Managed Redis.
PARAMETERS
-Name <String>
Name of the Azure Managed Redis to create.
-ResourceGroupName <String>
Name of resource group in which to create the Azure Managed Redis.
-Location <String>
Location in which to create the Azure Managed Redis.
-RedisVersion <String>
RedisVersion is deprecated and will be removed in future release.
-Sku <String>
Sku of Azure Managed Redis.
-MaxMemoryPolicy <String>
The 'MaxMemoryPolicy' setting has been deprecated. Please use 'RedisConfiguration' setting to set
MaxMemoryPolicy. e.g. -RedisConfiguration @{"maxmemory-policy" = "allkeys-lru"}
-RedisConfiguration <Hashtable>
All Redis Configuration Settings. Few possible keys: rdb-backup-enabled, rdb-storage-connection-string,
rdb-backup-frequency, maxmemory-reserved, maxmemory-policy, notify-keyspace-events, hash-max-ziplist-entries,
hash-max-ziplist-value, set-max-intset-entries, zset-max-ziplist-entries, zset-max-ziplist-value, databases.
-EnableNonSslPort <Boolean>
EnableNonSslPort is used by Azure Managed Redis. If no value is provided, the default value is false and the
non-SSL port will be disabled. Possible values are true and false.
-ShardCount <Integer>
The number of shards to create on a Cluster Cache.
-VirtualNetwork <String>
The exact ARM resource ID of the virtual network to deploy the Azure Managed Redis in. Example format: /subscriptions/{
subid}/resourceGroups/{resourceGroupName}/providers/Microsoft.ClassicNetwork/VirtualNetworks/{vnetName}
-Subnet <String>
Required when deploying an Azure Managed Redis inside an existing Azure Virtual Network.
-StaticIP <String>
Required when deploying an Azure Managed Redis inside an existing Azure Virtual Network.
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
Voer de volgende opdracht uit om een cache met standaardparameters te maken.
New-AzRedisEnterpriseCache -ResourceGroupName myGroup -Name mycache -Location "North Central US"
ResourceGroupName, Nameen Location zijn vereiste parameters, maar de resten zijn optioneel en hebben standaardwaarden. Als u de vorige opdracht uitvoert, wordt een Azure Managed Redis-exemplaar gemaakt met de opgegeven naam, locatie en resourcegroep. Het exemplaar is 1 GB groot, waarbij de niet-SSL-poort is uitgeschakeld.
Als u clustering wilt inschakelen, geeft u een aantal shards op met behulp van de ShardCount parameter.
Als u waarden voor de RedisConfiguration parameter wilt opgeven, plaatst u de waarden in {} als sleutel-/waardeparen, zoals @{"maxmemory-policy" = "allkeys-random", "notify-keyspace-events" = "KEA"}. In het volgende voorbeeld wordt een cache van 1 GB gemaakt met allkeys-random maxmemory-beleid en keyspace-meldingen geconfigureerd met KEA. Zie Keyspace-meldingen (geavanceerde instellingen) en geheugenbeleid voor meer informatie.
New-AzRedisEnterpriseCache -ResourceGroupName myGroup -Name mycache -Location "North Central US" -RedisConfiguration @{"maxmemory-policy" = "allkeys-random", "notify-keyspace-events" = "KEA"}
De instelling voor databases configureren tijdens het maken van de cache
De instelling kan alleen worden geconfigureerd tijdens het databases maken van de cache. In het volgende voorbeeld wordt een cache met 48 databases gemaakt met behulp van de cmdlet New-AzRedisEnterpriseCache .
New-AzRedisEnterpriseCache -ResourceGroupName myGroup -Name mycache -Location "North Central US" -Sku B1 -RedisConfiguration @{"databases" = "48"}
Zie De standaardconfiguratie van de Azure Managed Redis-server voor meer informatie over de databases eigenschap. Zie de vorige sectie Een beheerde Redis-sectie maken voor meer informatie over het maken van een cache met de cmdlet New-AzRedisEnterpriseCache .
Een door Azure beheerde Redis bijwerken
Azure Managed Redis-exemplaren worden bijgewerkt met behulp van de cmdlet [Set-AzRedisEnterpriseCache].
Voer de volgende opdracht uit om een lijst met beschikbare parameters en de bijbehorende beschrijvingen weer Set-AzRedisEnterpriseCachete geven.
PS C:\> Get-Help Set-AzRedisEnterpriseCache -detailed
NAME
Set-AzRedisEnterpriseCache
SYNOPSIS
Set Azure Managed Redis updatable parameters.
SYNTAX
Set-AzRedisEnterpriseCache -Name <String> -ResourceGroupName <String> [-Sku <String>]
[-MaxMemoryPolicy <String>] [-RedisConfiguration <Hashtable>] [-EnableNonSslPort <Boolean>] [-ShardCount
<Integer>] [<CommonParameters>]
DESCRIPTION
The Set-AzRedisEnterpriseCache cmdlet sets Azure Managed Redis parameters.
PARAMETERS
-Name <String>
Name of the Azure Managed Redis to update.
-ResourceGroupName <String>
Name of the resource group for the cache.
-Sku <String>
Sku of Azure Managed Redis.
-MaxMemoryPolicy <String>
The 'MaxMemoryPolicy' setting has been deprecated. Please use 'RedisConfiguration' setting to set
MaxMemoryPolicy. e.g. -RedisConfiguration @{"maxmemory-policy" = "allkeys-lru"}
-RedisConfiguration <Hashtable>
All Redis Configuration Settings. Few possible keys: rdb-backup-enabled, rdb-storage-connection-string,
rdb-backup-frequency, maxmemory-reserved, maxmemory-policy, notify-keyspace-events, hash-max-ziplist-entries,
hash-max-ziplist-value, set-max-intset-entries, zset-max-ziplist-entries, zset-max-ziplist-value.
-EnableNonSslPort <Boolean>
EnableNonSslPort is used by Azure Managed Redis. The default value is null and no change will be made to the
currently configured value. Possible values are true and false.
-ShardCount <Integer>
The number of shards to create on a Cluster Cache.
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
De Set-AzRedisEnterpriseCache cmdlet kan worden gebruikt om eigenschappen zoals Sku, EnableNonSslPorten de RedisConfiguration waarden bij te werken.
Met de volgende opdracht wordt het maxmemory-beleid voor de Azure Managed Redis met de naam myCache bijgewerkt.
Set-AzRedisEnterpriseCache -ResourceGroupName "myGroup" -Name "myCache" -RedisConfiguration @{"maxmemory-policy" = "allkeys-random"}
Informatie over een door Azure beheerde Redis ophalen
U kunt informatie over een cache ophalen met behulp van de cmdlet Get-AzRedisEnterpriseCache .
Voer de volgende opdracht uit om een lijst met beschikbare parameters en de bijbehorende beschrijvingen weer Get-AzRedisEnterpriseCachete geven.
PS C:\> Get-Help Get-AzRedisEnterpriseCache -detailed
NAME
Get-AzRedisEnterpriseCache
SYNOPSIS
Gets details about a single cache or all caches in the specified resource group or all caches in the current
subscription.
SYNTAX
Get-AzRedisEnterpriseCache [-Name <String>] [-ResourceGroupName <String>] [<CommonParameters>]
DESCRIPTION
The Get-AzRedisEnterpriseCache cmdlet gets the details about a cache or caches depending on input parameters. If both
ResourceGroupName and Name parameters are provided then Get-AzRedisEnterpriseCache will return details about the
specific cache name provided.
If only ResourceGroupName is provided than it will return details about all caches in the specified resource group.
If no parameters are given than it will return details about all caches the current subscription.
PARAMETERS
-Name <String>
The name of the cache. When this parameter is provided along with ResourceGroupName, Get-AzRedisEnterpriseCache
returns the details for the cache.
-ResourceGroupName <String>
The name of the resource group that contains the cache or caches. If ResourceGroupName is provided with Name
then Get-AzRedisEnterpriseCache returns the details of the cache specified by Name. If only the ResourceGroup
parameter is provided, then details for all caches in the resource group are returned.
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
Als u informatie wilt retourneren over alle caches in het huidige abonnement, voert u deze uit Get-AzRedisEnterpriseCache zonder parameters.
Get-AzRedisEnterpriseCache
Als u informatie wilt retourneren over alle caches in een specifieke resourcegroep, voert u deze uit Get-AzRedisEnterpriseCache met de ResourceGroupName parameter.
Get-AzRedisEnterpriseCache -ResourceGroupName myGroup
Als u informatie over een specifieke cache wilt retourneren, voert u deze uit Get-AzRedisEnterpriseCache met de Name parameter die de naam van de cache bevat en de ResourceGroupName parameter met de resourcegroep die die cache bevat.
PS C:\> Get-AzRedisEnterpriseCache -Name myCache -ResourceGroupName myGroup
Name : mycache
Id : /subscriptions/12ad12bd-abdc-2231-a2ed-a2b8b246bbad4/resourceGroups/myGroup/providers/Mi
crosoft.Cache/Redis/mycache
Location : South Central US
Type : Microsoft.Cache/Redis
HostName : mycache.redis.cache.windows.net
Port : 10000
ProvisioningState : Succeeded
SslPort : 6380
RedisConfiguration : {[maxmemory-policy, volatile-lru], [maxmemory-reserved, 62], [notify-keyspace-events, KEA],
[maxclients, 1000]...}
EnableNonSslPort : False
RedisVersion : 3.0
Sku : B1
ResourceGroupName : myGroup
VirtualNetwork :
Subnet :
StaticIP :
TenantSettings : {}
ShardCount :
De toegangssleutels voor een door Azure beheerde Redis ophalen
Als u de toegangssleutels voor uw cache wilt ophalen, kunt u de cmdlet Get-AzRedisEnterpriseCacheKey gebruiken.
Voer de volgende opdracht uit om een lijst met beschikbare parameters en de bijbehorende beschrijvingen weer Get-AzRedisEnterpriseCacheKeyte geven.
PS C:\> Get-Help Get-AzRedisEnterpriseCacheKey -detailed
NAME
Get-AzRedisEnterpriseCacheKey
SYNOPSIS
Gets the accesskeys for the specified Azure Managed Redis.
SYNTAX
Get-AzRedisEnterpriseCacheKey -Name <String> -ResourceGroupName <String> [<CommonParameters>]
DESCRIPTION
The Get-AzRedisEnterpriseCacheKey cmdlet gets the access keys for the specified cache.
PARAMETERS
-Name <String>
Name of the Azure Managed Redis.
-ResourceGroupName <String>
Name of the resource group for the cache.
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
Als u de sleutels voor uw cache wilt ophalen, roept u de Get-AzRedisEnterpriseCacheKey cmdlet aan en geeft u de naam van de cache door aan de naam van de resourcegroep die de cache bevat.
PS C:\> Get-AzRedisEnterpriseCacheKey -Name myCache -ResourceGroupName myGroup
PrimaryKey : b2wdt43sfetlju4hfbryfnregrd9wgIcc6IA3zAO1lY=
SecondaryKey : ABhfB757JgjIgt785JgKH9865eifmekfnn649303JKL=
Toegangssleutels voor azure Managed Redis opnieuw genereren
Als u de toegangssleutels voor uw cache opnieuw wilt genereren, kunt u de cmdlet New-AzRedisEnterpriseCacheKey gebruiken.
Voer de volgende opdracht uit om een lijst met beschikbare parameters en de bijbehorende beschrijvingen weer New-AzRedisEnterpriseCacheKeyte geven.
PS C:\> Get-Help New-AzRedisEnterpriseCacheKey -detailed
NAME
New-AzRedisEnterpriseCacheKey
SYNOPSIS
Regenerates the access key of an Azure Managed Redis.
SYNTAX
New-AzRedisEnterpriseCacheKey -Name <String> -ResourceGroupName <String> -KeyType <String> [-Force] [<CommonParameters>]
DESCRIPTION
The New-AzRedisEnterpriseCacheKey cmdlet regenerate the access key of an Azure Managed Redis.
PARAMETERS
-Name <String>
Name of the Azure Managed Redis.
-ResourceGroupName <String>
Name of the resource group for the cache.
-KeyType <String>
Specifies whether to regenerate the primary or secondary access key. Possible values are Primary or Secondary.
-Force
When the Force parameter is provided, the specified access key is regenerated without any confirmation prompts.
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
Als u de primaire of secundaire sleutel voor uw cache opnieuw wilt genereren, roept u de New-AzRedisEnterpriseCacheKey cmdlet aan en geeft u de naam, resourcegroep door en geeft u Primary de KeyType parameter opSecondary. In het volgende voorbeeld wordt de secundaire toegangssleutel voor een cache opnieuw gegenereerd.
PS C:\> New-AzRedisEnterpriseCacheKey -Name myCache -ResourceGroupName myGroup -KeyType Secondary
Confirm
Are you sure you want to regenerate Secondary key for Azure Managed Redis 'myCache'?
[Y] Yes [N] No [S] Suspend [?] Help (default is "Y"): Y
PrimaryKey : b2wdt43sfetlju4hfbryfnregrd9wgIcc6IA3zAO1lY=
SecondaryKey : c53hj3kh4jhHjPJk8l0jji785JgKH9865eifmekfnn6=
Een door Azure beheerde Redis verwijderen
Als u een door Azure beheerde Redis wilt verwijderen, gebruikt u de cmdlet Remove-AzRedisEnterpriseCache .
Voer de volgende opdracht uit om een lijst met beschikbare parameters en de bijbehorende beschrijvingen weer Remove-AzRedisEnterpriseCachete geven.
PS C:\> Get-Help Remove-AzRedisEnterpriseCache -detailed
NAME
Remove-AzRedisEnterpriseCache
SYNOPSIS
Remove Azure Managed Redis if exists.
SYNTAX
Remove-AzRedisEnterpriseCache -Name <String> -ResourceGroupName <String> [-Force] [-PassThru] [<CommonParameters>
DESCRIPTION
The Remove-AzRedisEnterpriseCache cmdlet removes an Azure Managed Redis if it exists.
PARAMETERS
-Name <String>
Name of the Azure Managed Redis to remove.
-ResourceGroupName <String>
Name of the resource group of the cache to remove.
-Force
When the Force parameter is provided, the cache is removed without any confirmation prompts.
-PassThru
By default Remove-AzRedisEnterpriseCache removes the cache and does not return any value. If the PassThru par
is provided then Remove-AzRedisEnterpriseCache returns a boolean value indicating the success of the operatio
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
In het volgende voorbeeld wordt de benoemde myCache cache verwijderd.
PS C:\> Remove-AzRedisEnterpriseCache -Name myCache -ResourceGroupName myGroup
Confirm
Are you sure you want to remove Azure Managed Redis 'myCache'?
[Y] Yes [N] No [S] Suspend [?] Help (default is "Y"): Y
Een door Azure beheerde Redis importeren
U kunt gegevens importeren in een azure Managed Redis-exemplaar met behulp van de Import-AzRedisEnterpriseCache cmdlet.
Voer de volgende opdracht uit om een lijst met beschikbare parameters en de bijbehorende beschrijvingen weer Import-AzRedisEnterpriseCachete geven.
PS C:\> Get-Help Import-AzRedisEnterpriseCache -detailed
NAME
Import-AzRedisEnterpriseCache
SYNOPSIS
Import data from blobs to Azure Managed Redis.
SYNTAX
Import-AzRedisEnterpriseCache -Name <String> -ResourceGroupName <String> -Files <String[]> [-Format <String>] [-Force]
[-PassThru] [<CommonParameters>]
DESCRIPTION
The Import-AzRedisEnterpriseCache cmdlet imports data from the specified blobs into Azure Managed Redis.
PARAMETERS
-Name <String>
The name of the cache.
-ResourceGroupName <String>
The name of the resource group that contains the cache.
-Files <String[]>
SAS urls of blobs whose content should be imported into the cache.
-Format <String>
Format for the blob. Currently "rdb" is the only supported, with other formats expected in the future.
-Force
When the Force parameter is provided, import will be performed without any confirmation prompts.
-PassThru
By default Import-AzRedisEnterpriseCache imports data in cache and does not return any value. If the PassThru
parameter is provided then Import-AzRedisEnterpriseCache returns a boolean value indicating the success of the
operation.
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
Met de volgende opdracht worden gegevens geïmporteerd uit de blob die is opgegeven door de SAS-URI in Azure Managed Redis.
PS C:\>Import-AzRedisEnterpriseCache -ResourceGroupName "resourceGroupName" -Name "cacheName" -Files @("https://mystorageaccount.blob.core.windows.net/mycontainername/blobname?sv=2015-04-05&sr=b&sig=caIwutG2uDa0NZ8mjdNJdgOY8%2F8mhwRuGNdICU%2B0pI4%3D&st=2016-05-27T00%3A00%3A00Z&se=2016-05-28T00%3A00%3A00Z&sp=rwd") -Force
Een door Azure beheerde Redis exporteren
U kunt gegevens exporteren uit een Azure Managed Redis-exemplaar met behulp van de Export-AzRedisEnterpriseCache cmdlet.
Voer de volgende opdracht uit om een lijst met beschikbare parameters en de bijbehorende beschrijvingen weer Export-AzRedisEnterpriseCachete geven.
PS C:\> Get-Help Export-AzRedisEnterpriseCache -detailed
NAME
Export-AzRedisEnterpriseCache
SYNOPSIS
Exports data from Azure Managed Redis to a specified container.
SYNTAX
Export-AzRedisEnterpriseCache -Name <String> -ResourceGroupName <String> -Prefix <String> -Container <String> [-Format
<String>] [-PassThru] [<CommonParameters>]
DESCRIPTION
The Export-AzRedisEnterpriseCache cmdlet exports data from Azure Managed Redis to a specified container.
PARAMETERS
-Name <String>
The name of the cache.
-ResourceGroupName <String>
The name of the resource group that contains the cache.
-Prefix <String>
Prefix to use for blob names.
-Container <String>
SAS url of container where data should be exported.
-Format <String>
Format for the blob. Currently "rdb" is the only supported, with other formats expected in the future.
-PassThru
By default Export-AzRedisEnterpriseCache does not return any value. If the PassThru parameter is provided
then Export-AzRedisEnterpriseCache returns a boolean value indicating the success of the operation.
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
Met de volgende opdracht exporteert u gegevens uit een Azure Managed Redis-exemplaar naar de container die is opgegeven door de SAS-URI.
PS C:\>Export-AzRedisEnterpriseCache -ResourceGroupName "resourceGroupName" -Name "cacheName" -Prefix "blobprefix"
-Container "https://mystorageaccount.blob.core.windows.net/mycontainer?sv=2015-04-05&sr=c&sig=HezZtBZ3DURmEGDduauE7
pvETY4kqlPI8JCNa8ATmaw%3D&st=2016-05-27T00%3A00%3A00Z&se=2016-05-28T00%3A00%3A00Z&sp=rwdl"
Een door Azure beheerde Redis opnieuw opstarten (preview)
U kunt uw Exemplaar van Azure Managed Redis (preview) opnieuw opstarten met behulp van de Reset-AzRedisEnterpriseCache cmdlet.
Voer de volgende opdracht uit om een lijst met beschikbare parameters en de bijbehorende beschrijvingen weer Reset-AzRedisEnterpriseCachete geven.
PS C:\> Get-Help Reset-AzRedisEnterpriseCache -detailed
NAME
Reset-AzRedisEnterpriseCache
SYNOPSIS
Reboot specified node(s) of an Azure Managed Redis instance.
SYNTAX
Reset-AzRedisEnterpriseCache -Name <String> -ResourceGroupName <String> -RebootType <String> [-ShardId <Integer>]
[-Force] [-PassThru] [<CommonParameters>]
DESCRIPTION
The Reset-AzRedisEnterpriseCache cmdlet reboots the specified node(s) of an Azure Managed Redis instance.
PARAMETERS
-Name <String>
The name of the cache.
-ResourceGroupName <String>
The name of the resource group that contains the cache.
-RebootType <String>
Which node to reboot. Possible values are "PrimaryNode", "SecondaryNode", "AllNodes".
-ShardId <Integer>
Which shard to reboot when rebooting a cache with clustering enabled.
-Force
When the Force parameter is provided, reset will be performed without any confirmation prompts.
-PassThru
By default Reset-AzRedisEnterpriseCache does not return any value. If the PassThru parameter is provided
then Reset-AzRedisEnterpriseCache returns a boolean value indicating the success of the operation.
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
Met de volgende opdracht worden beide knooppunten van de opgegeven cache opnieuw opgestart.
PS C:\>Reset-AzRedisEnterpriseCache -ResourceGroupName "resourceGroupName" -Name "cacheName" -RebootType "AllNodes"
-Force
Notitie
Azure heeft twee verschillende implementatiemodellen die u kunt gebruiken om resources te maken en ermee te werken: Azure Resource Manager en klassiek. Dit artikel is van toepassing op het gebruik van het Resource Manager-implementatiemodel. We bevelen het Resource Manager-implementatiemodel voor de meeste nieuwe implementaties, in plaats van het klassieke implementatiemodel.
Zie Azure Resource Manager versus klassieke implementatie voor meer informatie over het klassieke implementatiemodel : Implementatiemodellen en de status van uw resources begrijpen.
Vereisten
Als u Azure PowerShell al hebt geïnstalleerd, moet u Azure PowerShell versie 1.0.0 of hoger hebben. U kunt de versie van Azure PowerShell controleren met deze opdracht via de Azure PowerShell-opdrachtprompt.
Get-Module Az | format-table version
Eerst moet u zich met deze opdracht aanmelden bij Azure.
Connect-AzAccount
Geef het e-mailadres van uw Azure-account en uw wachtwoord op in het aanmeldingsdialoogvenster van Microsoft Azure.
Als u meerdere Azure-abonnementen hebt, moet u vervolgens uw Azure-abonnement instellen. Voer deze opdracht uit om een lijst met uw huidige abonnementen weer te geven.
Get-AzSubscription | sort SubscriptionName | Select SubscriptionName
Voer de volgende opdracht uit om het abonnement op te geven. In het volgende voorbeeld is ContosoSubscriptionde naam van het abonnement.
Select-AzSubscription -SubscriptionName ContosoSubscription
Voordat u Windows PowerShell kunt gebruiken met Azure Resource Manager, moet u de configuratie controleren:
- Windows PowerShell, versie 3.0 of 4.0. Als u de versie van Windows PowerShell wilt zoeken, typt u:
$PSVersionTableen controleert u of de waardePSVersion3.0 of 4.0 is. Zie Windows Management Framework 3.0 als u een compatibele versie wilt installeren.
Gebruik de Cmdlet Get-Help om gedetailleerde hulp te krijgen voor alle cmdlets die u in deze zelfstudie ziet.
Get-Help <cmdlet-name> -Detailed
Als u bijvoorbeeld hulp voor de New-AzRedisCache cmdlet wilt krijgen, typt u:
Get-Help New-AzRedisCache -Detailed
Verbinding maken met andere clouds
Standaard is AzureCloudde Azure-omgeving, die het globale Azure-cloudexemplaren vertegenwoordigt. Als u verbinding wilt maken met een ander exemplaar, gebruikt u de opdracht met de Connect-AzAccount -Environment of-opdrachtregelswitchEnvironmentName met de gewenste omgevings- of omgevingsnaam.
Voer de Get-AzEnvironment cmdlet uit om de lijst met beschikbare omgevingen weer te geven.
Verbinding maken met de Azure Government Cloud
Gebruik een van de volgende opdrachten om verbinding te maken met de Azure Government Cloud.
Connect-AzAccount -EnvironmentName AzureUSGovernment
Or
Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureUSGovernment)
Als u een cache wilt maken in de Azure Government Cloud, gebruikt u een van de volgende locaties.
- USGov Virginia
- USGov Iowa
Zie de ontwikkelaarshandleiding voor Microsoft Azure Government en Microsoft Azure Government voor meer informatie over de Azure Government-cloud.
Verbinding maken met Microsoft Azure beheerd door 21Vianet Cloud
Gebruik een van de volgende opdrachten om verbinding te maken met de Azure-cloud die wordt beheerd door 21Vianet.
Connect-AzAccount -EnvironmentName AzureChinaCloud
Or
Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureChinaCloud)
Als u een cache wilt maken in Azure die wordt beheerd door 21Vianet Cloud, gebruikt u een van de volgende locaties.
- China - oost
- China - noord
Verbinding maken met Microsoft Azure Duitsland
Gebruik een van de volgende opdrachten om verbinding te maken met Microsoft Azure Duitsland.
Connect-AzAccount -EnvironmentName AzureGermanCloud
Or
Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureGermanCloud)
Als u een cache wilt maken in Microsoft Azure Duitsland, gebruikt u een van de volgende locaties.
- Duitsland - centraal
- Duitsland - noordoost
Zie Microsoft Azure Duitsland voor meer informatie over Microsoft Azure Duitsland.
Eigenschappen die worden gebruikt voor Azure Cache voor Redis PowerShell
De volgende tabel bevat Azure PowerShell-eigenschappen en -beschrijvingen voor algemene parameters bij het maken en beheren van uw Azure Cache voor Redis-exemplaren.
| Parameter | Description | Standaard |
|---|---|---|
| Naam | Naam van de cache | |
| Locatie | Locatie van de cache | |
| ResourceGroupName | Naam van resourcegroep waarin de cache moet worden gemaakt | |
| Tekengrootte | De grootte van de 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 | 1 GB |
| ShardCount | Het aantal shards dat moet worden gemaakt bij het maken van een Premium-cache waarvoor clustering is ingeschakeld. Geldige waarden zijn: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 | |
| SKU | Hiermee geeft u de SKU van de cache. Geldige waarden zijn: Basic, Standard, Premium | Standaard |
| RedisConfiguration | Hiermee geeft u Redis-configuratie-instellingen. Zie de volgende eigenschappentabel voor RedisConfiguration voor meer informatie over elke instelling. | |
| EnableNonSslPort | Geeft aan of de niet-SSL-poort is ingeschakeld. | Onwaar |
| MaxMemoryPolicy | Deze parameter is afgeschaft. Gebruik in plaats daarvan RedisConfiguration. | |
| StaticIP | Wanneer u uw cache host in een VNET, geeft u een uniek IP-adres op in het subnet voor de cache. Indien niet opgegeven, wordt er een voor u gekozen vanuit het subnet. | |
| Subnet | Wanneer u uw cache host in een VNET, geeft u de naam op van het subnet waarin de cache moet worden geïmplementeerd. | |
| VirtualNetwork | Wanneer u uw cache host in een VNET, geeft u de resource-id op van het VNET waarin de cache moet worden geïmplementeerd. | |
| KeyType | Hiermee geeft u op welke toegangssleutel opnieuw moet worden gegenereerd bij het vernieuwen van toegangssleutels. Geldige waarden zijn: Primair, Secundair |
Eigenschappen van RedisConfiguration
| Eigenschappen | Beschrijving | Prijscategorieën |
|---|---|---|
| rdb-backup ingeschakeld | Of Redis-gegevenspersistentie is ingeschakeld | Alleen Premium |
| rdb-storage-connection-string | De verbindingsreeks naar het opslagaccount voor Redis-gegevenspersistentie | Alleen Premium |
| rdb-backup-frequency | De back-upfrequentie voor Redis-gegevenspersistentie | Alleen Premium |
| maxmemory-reserved | Hiermee configureert u het geheugen dat is gereserveerd voor niet-cacheprocessen | Standard en Premium |
| maxmemory-policy | Hiermee configureert u het verwijderingsbeleid voor de cache | Alle prijscategorieën |
| notify-keyspace-events | Keyspace-meldingen configureren | Standard en Premium |
| hash-max-ziplist-vermeldingen | Hiermee configureert u geheugenoptimalisatie voor kleine geaggregeerde gegevenstypen | Standard en Premium |
| hash-max-ziplist-value | Hiermee configureert u geheugenoptimalisatie voor kleine geaggregeerde gegevenstypen | Standard en Premium |
| set-max-intset-entries | Hiermee configureert u geheugenoptimalisatie voor kleine geaggregeerde gegevenstypen | Standard en Premium |
| zset-max-ziplist-entries | Hiermee configureert u geheugenoptimalisatie voor kleine geaggregeerde gegevenstypen | Standard en Premium |
| zset-max-ziplist-value | Hiermee configureert u geheugenoptimalisatie voor kleine geaggregeerde gegevenstypen | Standard en Premium |
| databases | Hiermee configureert u het aantal databases. Deze eigenschap kan alleen worden geconfigureerd bij het maken van de cache. | Standard en Premium |
Een Azure Cache voor Redis maken
Nieuwe Azure Cache voor Redis-exemplaren worden gemaakt met behulp van de cmdlet New-AzRedisCache.
Belangrijk
De eerste keer dat u een Azure Cache voor Redis maakt in een abonnement met behulp van Azure Portal, registreert de portal de Microsoft.Cache naamruimte voor dat abonnement. Als u probeert de eerste Azure Cache voor Redis te maken in een abonnement met behulp van PowerShell, moet u die naamruimte eerst registreren met behulp van de volgende opdracht; anders mislukken cmdlets zoals New-AzRedisCache en Get-AzRedisCache mislukken.
Register-AzResourceProvider -ProviderNamespace "Microsoft.Cache"
Voer de volgende opdracht uit om een lijst met beschikbare parameters en de bijbehorende beschrijvingen weer New-AzRedisCachete geven.
PS C:\> Get-Help New-AzRedisCache -detailed
NAME
New-AzRedisCache
SYNOPSIS
Creates a new Azure Cache for Redis.
SYNTAX
New-AzRedisCache -Name <String> -ResourceGroupName <String> -Location <String> [-RedisVersion <String>]
[-Size <String>] [-Sku <String>] [-MaxMemoryPolicy <String>] [-RedisConfiguration <Hashtable>] [-EnableNonSslPort
<Boolean>] [-ShardCount <Integer>] [-VirtualNetwork <String>] [-Subnet <String>] [-StaticIP <String>]
[<CommonParameters>]
DESCRIPTION
The New-AzRedisCache cmdlet creates a new Azure Cache for Redis.
PARAMETERS
-Name <String>
Name of the Azure Cache for Redis to create.
-ResourceGroupName <String>
Name of resource group in which to create the Azure Cache for Redis.
-Location <String>
Location in which to create the Azure Cache for Redis.
-RedisVersion <String>
RedisVersion is deprecated and will be removed in future release.
-Size <String>
Size of the Azure Cache for Redis. The default value is 1GB or C1. Possible values are P1, P2, P3, P4, C0, C1, C2, C3,
C4, C5, C6, 250MB, 1GB, 2.5GB, 6GB, 13GB, 26GB, 53GB.
-Sku <String>
Sku of Azure Cache for Redis. The default value is Standard. Possible values are Basic, Standard and Premium.
-MaxMemoryPolicy <String>
The 'MaxMemoryPolicy' setting has been deprecated. Please use 'RedisConfiguration' setting to set
MaxMemoryPolicy. e.g. -RedisConfiguration @{"maxmemory-policy" = "allkeys-lru"}
-RedisConfiguration <Hashtable>
All Redis Configuration Settings. Few possible keys: rdb-backup-enabled, rdb-storage-connection-string,
rdb-backup-frequency, maxmemory-reserved, maxmemory-policy, notify-keyspace-events, hash-max-ziplist-entries,
hash-max-ziplist-value, set-max-intset-entries, zset-max-ziplist-entries, zset-max-ziplist-value, databases.
-EnableNonSslPort <Boolean>
EnableNonSslPort is used by Azure Cache for Redis. If no value is provided, the default value is false and the
non-SSL port will be disabled. Possible values are true and false.
-ShardCount <Integer>
The number of shards to create on a Premium Cluster Cache.
-VirtualNetwork <String>
The exact ARM resource ID of the virtual network to deploy the Azure Cache for Redis in. Example format: /subscriptions/{
subid}/resourceGroups/{resourceGroupName}/providers/Microsoft.ClassicNetwork/VirtualNetworks/{vnetName}
-Subnet <String>
Required when deploying an Azure Cache for Redis inside an existing Azure Virtual Network.
-StaticIP <String>
Required when deploying an Azure Cache for Redis inside an existing Azure Virtual Network.
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
Voer de volgende opdracht uit om een cache met standaardparameters te maken.
New-AzRedisCache -ResourceGroupName myGroup -Name mycache -Location "North Central US"
ResourceGroupName, Nameen Location zijn vereiste parameters, maar de resten zijn optioneel en hebben standaardwaarden. Als u de vorige opdracht uitvoert, maakt u een standard-SKU Azure Cache voor Redis exemplaar met de opgegeven naam, locatie en resourcegroep. Het exemplaar is 1 GB groot, waarbij de niet-SSL-poort is uitgeschakeld.
Als u een Premium-cache wilt maken, geeft u een grootte op van P1 (6 GB - 60 GB), P2 (13 GB - 130 GB), P3 (26 GB - 260 GB) of P4 (53 GB - 530 GB). Als u clustering wilt inschakelen, geeft u een aantal shards op met behulp van de ShardCount parameter. In het volgende voorbeeld wordt een P1 Premium-cache gemaakt met drie shards. Een P1 Premium-cache is 6 GB groot en omdat we drie shards hebben opgegeven, is de totale grootte 18 GB (3 x 6 GB).
New-AzRedisCache -ResourceGroupName myGroup -Name mycache -Location "North Central US" -Sku Premium -Size P1 -ShardCount 3
Als u waarden voor de RedisConfiguration parameter wilt opgeven, plaatst u de waarden in {} als sleutel-/waardeparen, zoals @{"maxmemory-policy" = "allkeys-random", "notify-keyspace-events" = "KEA"}. In het volgende voorbeeld wordt een standaard cache van 1 GB gemaakt met allkeys-random maxmemory-beleid en keyspace-meldingen geconfigureerd met KEA. Zie Keyspace-meldingen (geavanceerde instellingen) en geheugenbeleid voor meer informatie.
New-AzRedisCache -ResourceGroupName myGroup -Name mycache -Location "North Central US" -RedisConfiguration @{"maxmemory-policy" = "allkeys-random", "notify-keyspace-events" = "KEA"}
De instelling voor databases configureren tijdens het maken van de cache
De instelling kan alleen worden geconfigureerd tijdens het databases maken van de cache. In het volgende voorbeeld wordt een premium P3-cache (26 GB) gemaakt met 48 databases met behulp van de cmdlet New-AzRedisCache .
New-AzRedisCache -ResourceGroupName myGroup -Name mycache -Location "North Central US" -Sku Premium -Size P3 -RedisConfiguration @{"databases" = "48"}
Zie De standaardconfiguratie van Azure Cache voor Redis server voor meer informatie over de databases eigenschap. Zie de vorige sectie Een Azure Cache voor Redis maken voor meer informatie over het maken van een cache met de cmdlet New-AzRedisCache.
Een Azure Cache voor Redis bijwerken
Azure Cache voor Redis exemplaren worden bijgewerkt met behulp van de Set-AzRedisCache-cmdlet.
Voer de volgende opdracht uit om een lijst met beschikbare parameters en de bijbehorende beschrijvingen weer Set-AzRedisCachete geven.
PS C:\> Get-Help Set-AzRedisCache -detailed
NAME
Set-AzRedisCache
SYNOPSIS
Set Azure Cache for Redis updatable parameters.
SYNTAX
Set-AzRedisCache -Name <String> -ResourceGroupName <String> [-Size <String>] [-Sku <String>]
[-MaxMemoryPolicy <String>] [-RedisConfiguration <Hashtable>] [-EnableNonSslPort <Boolean>] [-ShardCount
<Integer>] [<CommonParameters>]
DESCRIPTION
The Set-AzRedisCache cmdlet sets Azure Cache for Redis parameters.
PARAMETERS
-Name <String>
Name of the Azure Cache for Redis to update.
-ResourceGroupName <String>
Name of the resource group for the cache.
-Size <String>
Size of the Azure Cache for Redis. The default value is 1GB or C1. Possible values are P1, P2, P3, P4, C0, C1, C2, C3,
C4, C5, C6, 250MB, 1GB, 2.5GB, 6GB, 13GB, 26GB, 53GB.
-Sku <String>
Sku of Azure Cache for Redis. The default value is Standard. Possible values are Basic, Standard and Premium.
-MaxMemoryPolicy <String>
The 'MaxMemoryPolicy' setting has been deprecated. Please use 'RedisConfiguration' setting to set
MaxMemoryPolicy. e.g. -RedisConfiguration @{"maxmemory-policy" = "allkeys-lru"}
-RedisConfiguration <Hashtable>
All Redis Configuration Settings. Few possible keys: rdb-backup-enabled, rdb-storage-connection-string,
rdb-backup-frequency, maxmemory-reserved, maxmemory-policy, notify-keyspace-events, hash-max-ziplist-entries,
hash-max-ziplist-value, set-max-intset-entries, zset-max-ziplist-entries, zset-max-ziplist-value.
-EnableNonSslPort <Boolean>
EnableNonSslPort is used by Azure Cache for Redis. The default value is null and no change will be made to the
currently configured value. Possible values are true and false.
-ShardCount <Integer>
The number of shards to create on a Premium Cluster Cache.
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
De Set-AzRedisCache cmdlet kan worden gebruikt om eigenschappen zoals Size, Skuen EnableNonSslPortde RedisConfiguration waarden bij te werken.
Met de volgende opdracht wordt het maxmemory-beleid bijgewerkt voor de Azure Cache voor Redis met de naam myCache.
Set-AzRedisCache -ResourceGroupName "myGroup" -Name "myCache" -RedisConfiguration @{"maxmemory-policy" = "allkeys-random"}
Een Azure Cache voor Redis schalen
Set-AzRedisCachekan worden gebruikt om een Azure Cache voor Redis exemplaar te schalen wanneer de Size, Skuof ShardCount eigenschappen worden gewijzigd.
Notitie
Het schalen van een cache met Behulp van PowerShell is onderhevig aan dezelfde limieten en richtlijnen als het schalen van een cache vanuit Azure Portal. U kunt schalen naar een andere prijscategorie met de volgende beperkingen.
- U kunt niet schalen van een hogere prijscategorie naar een lagere prijscategorie.
- U kunt niet schalen van een Premium-cache naar een Standard - of Basic-cache .
- U kunt niet schalen vanuit een Standard-cache naar een Basic-cache .
- U kunt schalen van een Basic-cache naar een Standard-cache , maar u kunt de grootte niet tegelijkertijd wijzigen. Als u een andere grootte nodig hebt, kunt u een volgende schaalbewerking uitvoeren naar de gewenste grootte.
- U kunt niet rechtstreeks schalen van een Basic-cache naar een Premium-cache . U moet schalen van Basic naar Standard in één schaalbewerking en vervolgens van Standard naar Premium in een volgende schaalbewerking.
- U kunt niet schalen van een grotere grootte naar de grootte C0 (250 MB).
Zie Azure Cache voor Redis schalen voor meer informatie.
In het volgende voorbeeld ziet u hoe u een cache met de naam myCache kunt schalen naar een cache van 2,5 GB. Deze opdracht werkt voor zowel een Basic- als een Standard-cache.
Set-AzRedisCache -ResourceGroupName myGroup -Name myCache -Size 2.5GB
Nadat deze opdracht is uitgegeven, wordt de status van de cache geretourneerd---similar om aan te roepen Get-AzRedisCache. De ProvisioningState is ingesteld op Scaling.
PS C:\> Set-AzRedisCache -Name myCache -ResourceGroupName myGroup -Size 2.5GB
Name : mycache
Id : /subscriptions/12ad12bd-abdc-2231-a2ed-a2b8b246bbad4/resourceGroups/mygroup/providers/Mi
crosoft.Cache/Redis/mycache
Location : South Central US
Type : Microsoft.Cache/Redis
HostName : mycache.redis.cache.windows.net
Port : 6379
ProvisioningState : Scaling
SslPort : 6380
RedisConfiguration : {[maxmemory-policy, volatile-lru], [maxmemory-reserved, 150], [notify-keyspace-events, KEA],
[maxmemory-delta, 150]...}
EnableNonSslPort : False
RedisVersion : 3.0
Size : 1GB
Sku : Standard
ResourceGroupName : mygroup
PrimaryKey : ....
SecondaryKey : ....
VirtualNetwork :
Subnet :
StaticIP :
TenantSettings : {}
ShardCount :
Wanneer de schaalbewerking is voltooid, worden de ProvisioningState wijzigingen gewijzigd in Succeeded. Als u een andere schaalbewerking wilt maken--- bijvoorbeeld van Basic naar Standard wijzigen en vervolgens de grootte wijzigen--- moet u wachten totdat de vorige bewerking is voltooid of krijgt u een foutmelding die er ongeveer als volgt uitziet.
Set-AzRedisCache : Conflict: The resource '...' is not in a stable state, and is currently unable to accept the update request.
Informatie over een Azure Cache voor Redis
U kunt informatie over een cache ophalen met behulp van de cmdlet Get-AzRedisCache .
Voer de volgende opdracht uit om een lijst met beschikbare parameters en de bijbehorende beschrijvingen weer Get-AzRedisCachete geven.
PS C:\> Get-Help Get-AzRedisCache -detailed
NAME
Get-AzRedisCache
SYNOPSIS
Gets details about a single cache or all caches in the specified resource group or all caches in the current
subscription.
SYNTAX
Get-AzRedisCache [-Name <String>] [-ResourceGroupName <String>] [<CommonParameters>]
DESCRIPTION
The Get-AzRedisCache cmdlet gets the details about a cache or caches depending on input parameters. If both
ResourceGroupName and Name parameters are provided then Get-AzRedisCache will return details about the
specific cache name provided.
If only ResourceGroupName is provided than it will return details about all caches in the specified resource group.
If no parameters are given than it will return details about all caches the current subscription.
PARAMETERS
-Name <String>
The name of the cache. When this parameter is provided along with ResourceGroupName, Get-AzRedisCache
returns the details for the cache.
-ResourceGroupName <String>
The name of the resource group that contains the cache or caches. If ResourceGroupName is provided with Name
then Get-AzRedisCache returns the details of the cache specified by Name. If only the ResourceGroup
parameter is provided, then details for all caches in the resource group are returned.
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
Als u informatie wilt retourneren over alle caches in het huidige abonnement, voert u deze uit Get-AzRedisCache zonder parameters.
Get-AzRedisCache
Als u informatie wilt retourneren over alle caches in een specifieke resourcegroep, voert u deze uit Get-AzRedisCache met de ResourceGroupName parameter.
Get-AzRedisCache -ResourceGroupName myGroup
Als u informatie over een specifieke cache wilt retourneren, voert u deze uit Get-AzRedisCache met de Name parameter die de naam van de cache bevat en de ResourceGroupName parameter met de resourcegroep die die cache bevat.
PS C:\> Get-AzRedisCache -Name myCache -ResourceGroupName myGroup
Name : mycache
Id : /subscriptions/12ad12bd-abdc-2231-a2ed-a2b8b246bbad4/resourceGroups/myGroup/providers/Mi
crosoft.Cache/Redis/mycache
Location : South Central US
Type : Microsoft.Cache/Redis
HostName : mycache.redis.cache.windows.net
Port : 6379
ProvisioningState : Succeeded
SslPort : 6380
RedisConfiguration : {[maxmemory-policy, volatile-lru], [maxmemory-reserved, 62], [notify-keyspace-events, KEA],
[maxclients, 1000]...}
EnableNonSslPort : False
RedisVersion : 3.0
Size : 1GB
Sku : Standard
ResourceGroupName : myGroup
VirtualNetwork :
Subnet :
StaticIP :
TenantSettings : {}
ShardCount :
De toegangssleutels voor een Azure Cache voor Redis ophalen
Als u de toegangssleutels voor uw cache wilt ophalen, kunt u de cmdlet Get-AzRedisCacheKey gebruiken.
Voer de volgende opdracht uit om een lijst met beschikbare parameters en de bijbehorende beschrijvingen weer Get-AzRedisCacheKeyte geven.
PS C:\> Get-Help Get-AzRedisCacheKey -detailed
NAME
Get-AzRedisCacheKey
SYNOPSIS
Gets the accesskeys for the specified Azure Cache for Redis.
SYNTAX
Get-AzRedisCacheKey -Name <String> -ResourceGroupName <String> [<CommonParameters>]
DESCRIPTION
The Get-AzRedisCacheKey cmdlet gets the access keys for the specified cache.
PARAMETERS
-Name <String>
Name of the Azure Cache for Redis.
-ResourceGroupName <String>
Name of the resource group for the cache.
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
Als u de sleutels voor uw cache wilt ophalen, roept u de Get-AzRedisCacheKey cmdlet aan en geeft u de naam van de cache door aan de naam van de resourcegroep die de cache bevat.
PS C:\> Get-AzRedisCacheKey -Name myCache -ResourceGroupName myGroup
PrimaryKey : b2wdt43sfetlju4hfbryfnregrd9wgIcc6IA3zAO1lY=
SecondaryKey : ABhfB757JgjIgt785JgKH9865eifmekfnn649303JKL=
Toegangssleutels voor uw Azure Cache voor Redis opnieuw genereren
Als u de toegangssleutels voor uw cache opnieuw wilt genereren, kunt u de cmdlet New-AzRedisCacheKey gebruiken.
Voer de volgende opdracht uit om een lijst met beschikbare parameters en de bijbehorende beschrijvingen weer New-AzRedisCacheKeyte geven.
PS C:\> Get-Help New-AzRedisCacheKey -detailed
NAME
New-AzRedisCacheKey
SYNOPSIS
Regenerates the access key of an Azure Cache for Redis.
SYNTAX
New-AzRedisCacheKey -Name <String> -ResourceGroupName <String> -KeyType <String> [-Force] [<CommonParameters>]
DESCRIPTION
The New-AzRedisCacheKey cmdlet regenerate the access key of an Azure Cache for Redis.
PARAMETERS
-Name <String>
Name of the Azure Cache for Redis.
-ResourceGroupName <String>
Name of the resource group for the cache.
-KeyType <String>
Specifies whether to regenerate the primary or secondary access key. Possible values are Primary or Secondary.
-Force
When the Force parameter is provided, the specified access key is regenerated without any confirmation prompts.
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
Als u de primaire of secundaire sleutel voor uw cache opnieuw wilt genereren, roept u de New-AzRedisCacheKey cmdlet aan en geeft u de naam, resourcegroep door en geeft u Primary de KeyType parameter opSecondary. In het volgende voorbeeld wordt de secundaire toegangssleutel voor een cache opnieuw gegenereerd.
PS C:\> New-AzRedisCacheKey -Name myCache -ResourceGroupName myGroup -KeyType Secondary
Confirm
Are you sure you want to regenerate Secondary key for Azure Cache for Redis 'myCache'?
[Y] Yes [N] No [S] Suspend [?] Help (default is "Y"): Y
PrimaryKey : b2wdt43sfetlju4hfbryfnregrd9wgIcc6IA3zAO1lY=
SecondaryKey : c53hj3kh4jhHjPJk8l0jji785JgKH9865eifmekfnn6=
Een Azure Cache voor Redis verwijderen
Als u een Azure Cache voor Redis wilt verwijderen, gebruikt u de cmdlet Remove-AzRedisCache.
Voer de volgende opdracht uit om een lijst met beschikbare parameters en de bijbehorende beschrijvingen weer Remove-AzRedisCachete geven.
PS C:\> Get-Help Remove-AzRedisCache -detailed
NAME
Remove-AzRedisCache
SYNOPSIS
Remove Azure Cache for Redis if exists.
SYNTAX
Remove-AzRedisCache -Name <String> -ResourceGroupName <String> [-Force] [-PassThru] [<CommonParameters>
DESCRIPTION
The Remove-AzRedisCache cmdlet removes an Azure Cache for Redis if it exists.
PARAMETERS
-Name <String>
Name of the Azure Cache for Redis to remove.
-ResourceGroupName <String>
Name of the resource group of the cache to remove.
-Force
When the Force parameter is provided, the cache is removed without any confirmation prompts.
-PassThru
By default Remove-AzRedisCache removes the cache and does not return any value. If the PassThru par
is provided then Remove-AzRedisCache returns a boolean value indicating the success of the operatio
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
In het volgende voorbeeld wordt de benoemde myCache cache verwijderd.
PS C:\> Remove-AzRedisCache -Name myCache -ResourceGroupName myGroup
Confirm
Are you sure you want to remove Azure Cache for Redis 'myCache'?
[Y] Yes [N] No [S] Suspend [?] Help (default is "Y"): Y
Een Azure Cache voor Redis importeren
U kunt gegevens importeren in een Azure Cache voor Redis exemplaar met behulp van de Import-AzRedisCache cmdlet.
Belangrijk
Importeren/exporteren is alleen beschikbaar voor Caches in de Premium-laag . Zie Gegevens importeren en exporteren in Azure Cache voor Redis voor meer informatie over Importeren/exporteren.
Voer de volgende opdracht uit om een lijst met beschikbare parameters en de bijbehorende beschrijvingen weer Import-AzRedisCachete geven.
PS C:\> Get-Help Import-AzRedisCache -detailed
NAME
Import-AzRedisCache
SYNOPSIS
Import data from blobs to Azure Cache for Redis.
SYNTAX
Import-AzRedisCache -Name <String> -ResourceGroupName <String> -Files <String[]> [-Format <String>] [-Force]
[-PassThru] [<CommonParameters>]
DESCRIPTION
The Import-AzRedisCache cmdlet imports data from the specified blobs into Azure Cache for Redis.
PARAMETERS
-Name <String>
The name of the cache.
-ResourceGroupName <String>
The name of the resource group that contains the cache.
-Files <String[]>
SAS urls of blobs whose content should be imported into the cache.
-Format <String>
Format for the blob. Currently "rdb" is the only supported, with other formats expected in the future.
-Force
When the Force parameter is provided, import will be performed without any confirmation prompts.
-PassThru
By default Import-AzRedisCache imports data in cache and does not return any value. If the PassThru
parameter is provided then Import-AzRedisCache returns a boolean value indicating the success of the
operation.
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
Met de volgende opdracht importeert u gegevens uit de blob die is opgegeven door de SAS-URI in Azure Cache voor Redis.
PS C:\>Import-AzRedisCache -ResourceGroupName "resourceGroupName" -Name "cacheName" -Files @("https://mystorageaccount.blob.core.windows.net/mycontainername/blobname?sv=2015-04-05&sr=b&sig=caIwutG2uDa0NZ8mjdNJdgOY8%2F8mhwRuGNdICU%2B0pI4%3D&st=2016-05-27T00%3A00%3A00Z&se=2016-05-28T00%3A00%3A00Z&sp=rwd") -Force
Een Azure Cache voor Redis exporteren
U kunt gegevens exporteren uit een Azure Cache voor Redis exemplaar met behulp van de Export-AzRedisCache cmdlet.
Belangrijk
Importeren/exporteren is alleen beschikbaar voor Caches in de Premium-laag . Zie Gegevens importeren en exporteren in Azure Cache voor Redis voor meer informatie over Importeren/exporteren.
Voer de volgende opdracht uit om een lijst met beschikbare parameters en de bijbehorende beschrijvingen weer Export-AzRedisCachete geven.
PS C:\> Get-Help Export-AzRedisCache -detailed
NAME
Export-AzRedisCache
SYNOPSIS
Exports data from Azure Cache for Redis to a specified container.
SYNTAX
Export-AzRedisCache -Name <String> -ResourceGroupName <String> -Prefix <String> -Container <String> [-Format
<String>] [-PassThru] [<CommonParameters>]
DESCRIPTION
The Export-AzRedisCache cmdlet exports data from Azure Cache for Redis to a specified container.
PARAMETERS
-Name <String>
The name of the cache.
-ResourceGroupName <String>
The name of the resource group that contains the cache.
-Prefix <String>
Prefix to use for blob names.
-Container <String>
SAS url of container where data should be exported.
-Format <String>
Format for the blob. Currently "rdb" is the only supported, with other formats expected in the future.
-PassThru
By default Export-AzRedisCache does not return any value. If the PassThru parameter is provided
then Export-AzRedisCache returns a boolean value indicating the success of the operation.
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
Met de volgende opdracht worden gegevens uit een Azure Cache voor Redis exemplaar geëxporteerd naar de container die is opgegeven door de SAS-URI.
PS C:\>Export-AzRedisCache -ResourceGroupName "resourceGroupName" -Name "cacheName" -Prefix "blobprefix"
-Container "https://mystorageaccount.blob.core.windows.net/mycontainer?sv=2015-04-05&sr=c&sig=HezZtBZ3DURmEGDduauE7
pvETY4kqlPI8JCNa8ATmaw%3D&st=2016-05-27T00%3A00%3A00Z&se=2016-05-28T00%3A00%3A00Z&sp=rwdl"
Een Azure Cache voor Redis opnieuw opstarten
U kunt uw Azure Cache voor Redis-exemplaar opnieuw opstarten met behulp van de Reset-AzRedisCache cmdlet.
Belangrijk
Opnieuw opstarten is alleen beschikbaar voor caches in de Basic-, Standard- en Premium-laag . Zie Cachebeheer - opnieuw opstarten voor meer informatie over het opnieuw opstarten van uw cache.
Voer de volgende opdracht uit om een lijst met beschikbare parameters en de bijbehorende beschrijvingen weer Reset-AzRedisCachete geven.
PS C:\> Get-Help Reset-AzRedisCache -detailed
NAME
Reset-AzRedisCache
SYNOPSIS
Reboot specified node(s) of an Azure Cache for Redis instance.
SYNTAX
Reset-AzRedisCache -Name <String> -ResourceGroupName <String> -RebootType <String> [-ShardId <Integer>]
[-Force] [-PassThru] [<CommonParameters>]
DESCRIPTION
The Reset-AzRedisCache cmdlet reboots the specified node(s) of an Azure Cache for Redis instance.
PARAMETERS
-Name <String>
The name of the cache.
-ResourceGroupName <String>
The name of the resource group that contains the cache.
-RebootType <String>
Which node to reboot. Possible values are "PrimaryNode", "SecondaryNode", "AllNodes".
-ShardId <Integer>
Which shard to reboot when rebooting a premium cache with clustering enabled.
-Force
When the Force parameter is provided, reset will be performed without any confirmation prompts.
-PassThru
By default Reset-AzRedisCache does not return any value. If the PassThru parameter is provided
then Reset-AzRedisCache returns a boolean value indicating the success of the operation.
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
Met de volgende opdracht worden beide knooppunten van de opgegeven cache opnieuw opgestart.
PS C:\>Reset-AzRedisCache -ResourceGroupName "resourceGroupName" -Name "cacheName" -RebootType "AllNodes"
-Force
Volgende stappen
Zie de volgende bronnen voor meer informatie over het gebruik van Windows PowerShell met Azure:
- Azure Cache voor Redis cmdlet-documentatie op MSDN
- Azure Resource Manager-cmdlets: informatie over het gebruik van de cmdlets in de Azure Resource Manager-module.
- Resourcegroepen gebruiken om uw Azure-resources te beheren: informatie over het maken en beheren van resourcegroepen in Azure Portal.
- Azure-blog: Meer informatie over nieuwe functies in Azure.
- Windows PowerShell-blog: meer informatie over nieuwe functies in Windows PowerShell.
- "Hey, Scripting Guy!" Blog: Krijg echte tips en trucs uit de Windows PowerShell-community.