Verwalten von Azure Redis mit Azure PowerShell
Azure Managed Redis
Melden Sie sich zum Erstellen einer Azure Managed Redis-Instanz (Vorschau) beim Azure-Portal an, und wählen Sie Ressource erstellen aus.
Geben Sie auf der Seite Neu im Suchfeld Azure Cache for Redis ein.
Konfigurieren Sie auf der Seite Neuer Redis Cache die Einstellungen für den neuen Cache.
Einstellung Wert auswählen BESCHREIBUNG Abonnement Öffnen Sie die Dropdownliste, und wählen Sie Ihr Abonnement aus. Das Abonnement, unter dem diese neue Azure Managed Redis-Instanz erstellt wird. Ressourcengruppe Öffnen Sie die Dropdownliste, und wählen Sie eine Ressourcengruppe aus, oder wählen Sie Neu erstellen aus, und geben Sie einen Namen für eine neue Ressourcengruppe ein. Der Name der Ressourcengruppe, in der Ihr Cache und weitere Ressourcen erstellt werden. Wenn Sie alle Ihre App-Ressourcen in einer Ressourcengruppe zusammenfassen, können Sie sie einfacher gemeinsam verwalten oder löschen. DNS-Name Geben Sie einen Namen ein, der in der Region eindeutig ist. Der Cachename muss zwischen 1 und 63 Zeichen lang sein, wenn er mit dem Regionsnamen des Cache kombiniert wird, und darf nur Ziffern, Buchstaben und Bindestriche enthalten. (Wenn der Cachename weniger als 45 Zeichen lang ist, sollte er in allen derzeit verfügbaren Regionen funktionieren.) Der Name muss mit einer Zahl oder einem Buchstaben beginnen und enden und darf keine aufeinanderfolgenden Bindestriche enthalten. Der Hostname Ihrer Cache-Instanz ist \<DNS name\>.\<Azure region\>.redis.azure.net.Location Öffnen Sie die Dropdownliste, und wählen Sie einen Standort aus. Azure Managed Redis ist in ausgewählten Azure-Regionen verfügbar. Cachetyp Wählen Sie in der Dropdownliste die Leistungsstufe und die Cachegröße aus. Die Stufe bestimmt die Leistung der Redis-Instanz, während die Cachegröße den zur Datenspeicherung verfügbaren Arbeitsspeicher bestimmt. Einen Leitfaden zum Auswählen der richtigen Leistungsstufe finden Sie unter Auswählen der richtigen Dienstebene. 
Wählen Sie Weiter: Netzwerk aus, um einen öffentlichen oder privaten Endpunkt auszuwählen.
Klicken Sie auf Weiter: Erweitert.
Konfigurieren Sie alle Redis-Module, die Sie der Instanz hinzufügen möchten.
Folgendes gilt standardmäßig für neue verwaltete Caches:
- Microsoft Entra ID ist aktiviert.
- Die Authentifizierung mit Zugriffsschlüsseln ist aus Sicherheitsgründen deaktiviert.
Wichtig
Für eine optimale Sicherheit empfehlen wir, Microsoft Entra ID mit verwalteten Identitäten zu verwenden, um Anforderungen nach Möglichkeit für Ihren Cache zu autorisieren. Die Autorisierung mit Microsoft Entra ID und verwalteten Identitäten bietet eine höhere Sicherheit und Benutzerfreundlichkeit als die Autorisierung mit gemeinsam verwendetem Schlüssel. Weitere Informationen zum Verwenden verwalteter Identitäten mit Ihren Caches finden Sie unter Verwenden von Microsoft Entra ID für die Cacheauthentifizierung.
Legen Sie Clusteringrichtlinie auf Enterprise für einen nicht gruppierten Cache fest oder OSS für einen gruppierten Cache. Weitere Informationen zum Auswählen einer Clusterrichtlinie finden Sie unter Clusterrichtlinie.
Bei Verwendung der aktiven Georeplikation muss diese während der Erstellung konfiguriert werden. Weitere Informationen finden Sie unter Konfigurieren der aktiven Georeplikation für Azure Managed Redis-Instanzen.
Wichtig
Sie können die Clusterrichtlinie einer Azure Managed Redis-Instanz (Vorschau) nach der Erstellung nicht mehr ändern. Wenn Sie RediSearch verwenden, ist die Enterprise-Clusterrichtlinie erforderlich, und
NoEvictionwird die einzige Entfernungsrichtlinie unterstützt.Wichtig
Wenn Sie diese Cacheinstanz in einer Georeplikationsgruppe verwenden, können Entfernungsrichtlinien nach der Erstellung der Instanz nicht mehr geändert werden. Achten Sie darauf, die Entfernungsrichtlinie Ihrer primären Knoten zu kennen, bevor Sie den Cache erstellen. Weitere Informationen zur aktiven Georeplikation finden Sie unter Voraussetzungen für die aktive Georeplikation.
Wichtig
Module können nach dem Erstellen einer Cache-Instanz nicht mehr geändert werden. Module müssen zum Zeitpunkt der Erstellung einer Azure Cache for Redis-Instanz aktiviert sein. Es gibt keine Option, die Konfiguration eines Moduls zu aktivieren, nachdem Sie einen Cache erstellt haben.
Wählen Sie Weiter: Tags aus, und überspringen Sie den Schritt.
Klicken Sie auf Weiter: Überprüfen + erstellen.
Überprüfen Sie die Einstellungen, und wählen Sie Erstellen aus.
Das Erstellen der Redis-Instanz dauert einige Minuten. Sie können den Fortschritt auf der Seite Übersicht von Azure Managed Redis überwachen. Wenn Wird ausgeführt als Status angezeigt wird, ist der Cache einsatzbereit.
Azure Cache for Redis
Um einen Cache zu erstellen, melden Sie sich im Azure-Portal an. Klicken Sie im Menü des Portals auf Ressource erstellen.
Geben Sie auf der Seite Erste Schritte den Begriff Azure Cache for Redis in das Suchfeld ein. Suchen Sie in den Suchergebnissen nach Azure Cache for Redis, und wählen Sie dann Erstellen aus.
Konfigurieren Sie im Bereich Neuer Redis-Cache auf der Registerkarte Grundlagen die folgenden Einstellungen für Ihren Cache:
Einstellung Aktion Beschreibung Abonnement Wählen Sie Ihr Azure-Abonnement. Das Abonnement, das zum Erstellen der neuen Instanz von Azure Cache for Redis verwendet werden soll. Ressourcengruppe Wählen Sie eine Ressourcengruppe aus, oder wählen Sie Neu erstellen aus, und geben Sie einen Namen für eine neue Ressourcengruppe ein. Der Name der Ressourcengruppe, in der Ihr Cache und weitere Ressourcen erstellt werden. Wenn Sie alle Ihre App-Ressourcen in einer Ressourcengruppe zusammenfassen, können Sie sie einfacher gemeinsam verwalten oder löschen. DNS-Name Geben Sie einen eindeutigen Namen ein. Der Cachename muss eine Zeichenfolge mit 1 bis 63 Zeichen sein, die nur Zahlen, Buchstaben und Bindestriche enthält. Der Name muss mit einer Zahl oder einem Buchstaben beginnen und enden und darf keine aufeinanderfolgenden Bindestriche enthalten. Der Hostname Ihrer Cache-Instanz ist \<DNS name>.redis.cache.windows.net.Location Wählen Sie einen Standort aus. Eine Azure-Region, die sich in der Nähe anderer Dienste befindet, die Ihren Cache verwenden. Cache-SKU Wählen Sie eine SKU aus. Die SKU bestimmt die Parameter für Größe, Leistung und Features, die für den Cache verfügbar sind. Weitere Informationen finden Sie unter Azure Cache for Redis. Cachegröße Wählen Sie eine Cachegröße aus. Weitere Informationen finden Sie unter Azure Cache for Redis. Wählen Sie die Registerkarte Netzwerk, oder wählen Sie Weiter: Netzwerk.
Wählen Sie auf der Registerkarte Netzwerk eine Konnektivitätsmethode für den Cache aus.
Wählen Sie die Registerkarte Erweitert aus, oder wählen Sie Weiter: Erweitert aus.
Überprüfen oder wählen Sie im Bereich Erweitert basierend auf den folgenden Informationen eine Authentifizierungsmethode aus:
- Standardmäßig ist für einen neuen Basic-, Standard- oder Premium-Cache die Microsoft Entra-Authentifizierung aktiviert und die Authentifizierung mit Zugriffsschlüsseln deaktiviert.
- Für Basic- oder Standard-Caches können Sie sich für die Auswahl eines Nicht-TLS-Ports entscheiden.
- Für Standard- und Premium-Caches können Sie Verfügbarkeitszonen aktivieren. Verfügbarkeitszonen können nach der Erstellung des Caches nicht deaktiviert werden.
- Konfigurieren Sie für ein Premium-Cache die Einstellungen für einen Nicht-TLS-Port, das Clustering, die verwaltete Identität und die Datenpersistenz.
Wichtig
Für eine optimale Sicherheit empfehlen wir, Microsoft Entra ID mit verwalteten Identitäten zu verwenden, um Anforderungen nach Möglichkeit für Ihren Cache zu autorisieren. Die Autorisierung mit Microsoft Entra ID und verwalteten Identitäten bietet eine höhere Sicherheit und Benutzerfreundlichkeit als die Autorisierung mit gemeinsam verwendetem Schlüssel. Weitere Informationen zum Verwenden verwalteter Identitäten mit Ihren Caches finden Sie unter Verwenden von Microsoft Entra ID für die Cacheauthentifizierung.
(Optional) Wählen Sie die Registerkarte Tags aus, oder wählen Sie Weiter: Tags aus.
Geben Sie optional auf der Registerkarte Tags den Namen und den Wert ein, wenn Sie die Cacheressource kategorisieren möchten.
Wählen Sie die Schaltfläche Überprüfen + erstellen aus.
Auf der Registerkarte Überprüfen und Erstellen überprüft Azure automatisch Ihre Konfiguration.
Wenn die grüne Meldung Validierung erfolgreich angezeigt wird, wählen Sie Erstellen aus.
Eine neue Cachebereitstellung dauert mehrere Minuten. Sie können den Fortschritt der Bereitstellung im Azure Cache for Redis -Übersichtsbereich überwachen. Wenn der Status Wird ausgeführt anzeigt, kann der Cache verwendet werden.
In diesem Artikel wird das Erstellen, Aktualisieren und Skalieren von Azure Redis-Instanzen beschrieben.
Hinweis
Azure verfügt über zwei verschiedene Bereitstellungsmodelle zum Erstellen und Verwenden von Ressourcen: Azure Resource Manager-Bereitstellung und klassische Bereitstellung. In diesem Artikel wird die Verwendung des Resource Manager-Bereitstellungsmodells beschrieben. Es wird empfohlen, für neue Bereitstellungen anstelle des klassischen Bereitstellungsmodells das Resource Manager-Bereitstellungsmodell zu verwenden.
Weitere Informationen über das klassische Bereitstellungsmodell finden Sie unter Azure Resource Manager-Bereitstellung im Vergleich zur klassischen Bereitstellung: Grundlegendes zu Bereitstellungsmodellen und zum Status von Ressourcen.
Voraussetzungen
Wenn Sie bereits Azure PowerShell installiert haben, benötigen Sie Version 12.4.0 oder höher. Sie können die Azure PowerShell-Version mit diesem Befehl über die Azure PowerShell-Eingabeaufforderung prüfen.
Get-Module Az | format-table version
Zunächst müssen Sie sich mit dem folgenden Befehl bei Azure anmelden.
Connect-AzAccount
Geben Sie die E-Mail-Adresse Ihres Azure-Kontos und Ihr Kennwort in das Anmeldedialogfeld von Microsoft Azure ein.
Wenn Sie über mehrere Azure-Abonnements verfügen, müssen Sie als Nächstes Ihr Azure-Abonnement festlegen. Führen Sie den folgenden Befehl aus, um eine Liste Ihrer aktuellen Abonnements anzuzeigen.
Get-AzSubscription | sort SubscriptionName | Select SubscriptionName
Führen Sie den folgenden Befehl aus, um das Abonnement anzugeben. Im folgenden Beispiel ist der Name des Abonnements ContosoSubscription.
Select-AzSubscription -SubscriptionName ContosoSubscription
Bevor Sie Windows PowerShell mit dem Azure Resource Manager verwenden können, müssen Sie Ihre Einstellungen verifizieren:
- Windows PowerShell, Version 3.0 oder 4.0. Um die Version von Windows PowerShell zu ermitteln, geben Sie
$PSVersionTableein. Vergewissern Sie sich, dass der Wert vonPSVersion3.0 oder 4.0 ist. Informationen zum Installieren einer kompatiblen Version finden Sie unter Windows Management Framework 3.0.
Um detaillierte Hilfe zu einem Cmdlet aus dem Lernprogramm zu erhalten, verwenden Sie das „Get-Help“-Cmdlet.
Get-Help <cmdlet-name> -Detailed
Geben Sie beispielsweise Folgendes ein, um Hilfe zum New-AzRedisEnterpriseCache -Cmdlet zu erhalten:
Get-Help New-AzRedisEnterpriseCache -Detailed
Herstellen von Verbindungen mit anderen Clouds
Standardmäßig ist die Azure-Umgebung AzureCloud (die globale Azure-Cloudinstanz). Verwenden Sie zum Verbinden mit einer anderen Instanz den Connect-AzAccount-Befehl mit dem Befehlszeilenschalter -Environment oder -EnvironmentName mit der gewünschten Umgebung bzw. dem gewünschten Umgebungsnamen.
Führen Sie zum Anzeigen der Liste der verfügbaren Umgebungen das Cmdlet Get-AzEnvironment aus.
Verbinden mit der Azure Government-Cloud
Verwenden Sie zum Verbinden mit der Azure Government-Cloud einen der folgenden Befehle.
Connect-AzAccount -EnvironmentName AzureUSGovernment
oder
Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureUSGovernment)
Verwenden Sie zum Erstellen eines Caches in der Azure Government-Cloud einen der folgenden Standorte.
- US Government, Virginia
- US Government, Iowa
Weitere Informationen zur Azure Government-Cloud finden Sie unter Microsoft Azure Government und im Microsoft Azure Government-Entwicklerhandbuch.
So stellen Sie eine Verbindung her mit der Microsoft Azure-Cloud, betrieben von 21Vianet
Verwenden Sie einen der folgenden Befehle zum Verbinden mit der Azure-Cloud, betrieben von 21Vianet.
Connect-AzAccount -EnvironmentName AzureChinaCloud
Oder
Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureChinaCloud)
Verwenden Sie einen der folgenden Speicherorte zum Erstellen eines Caches in der Azure-Cloud, betrieben von 21Vianet.
- China, Osten
- China, Norden
So stellen Sie eine Verbindung mit Microsoft Azure Deutschland her
Verwenden Sie zum Herstellen einer Verbindung mit Microsoft Azure Deutschland einen der folgenden Befehle.
Connect-AzAccount -EnvironmentName AzureGermanCloud
oder
Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureGermanCloud)
Verwenden Sie einen der folgenden Orte, um einen Cache in Microsoft Azure Deutschland zu erstellen.
- Deutschland, Mitte
- Deutschland, Nordosten
Weitere Informationen zu Microsoft Azure Deutschland finden Sie unter Microsoft Azure Deutschland.
PowerShell-Parameter und -Eigenschaften für Azure Managed Redis
Eine Liste aller PowerShell-Parameter und -Eigenschaften für Azure Managed Redis finden Sie unter New-AzRedisEnterpriseCache.
So erstellen Sie eine Azure Managed Redis-Instanz
Neue Azure Managed Redis-Instanzen werden mit dem Cmdlet New-AzRedisEnterpriseCache erstellt.
Wichtig
Beim ersten Erstellen einer Azure Managed Redis-Instanz in einem Abonnement mithilfe des Azure-Portals registriert das Portal den Microsoft.Cache-Namespace für dieses Abonnement. Wenn Sie die erste Azure Managed Redis-Instanz in einem Abonnement mithilfe von PowerShell registrieren möchten, müssen Sie zunächst diesen Namespace mit dem folgenden Befehl registrieren. Andernfalls tritt beim Ausführen von Cmdlets wie New-AzRedisEnterpriseCache und Get-AzRedisEnterpriseCache ein Fehler auf.
Register-AzResourceProvider -ProviderNamespace "Microsoft.Cache"
Um eine Liste der verfügbaren Parameter und ihrer Beschreibungen für New-AzRedisEnterpriseCacheanzuzeigen, führen Sie den folgenden Befehl aus.
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).
Um einen Cache mit Standardparametern zu erstellen, führen Sie den folgenden Befehl aus.
New-AzRedisEnterpriseCache -ResourceGroupName myGroup -Name mycache -Location "North Central US"
ResourceGroupName, Name und Location sind erforderliche Parameter, aber die übrigen sind optional und haben Standardwerte. Mit dem vorherigen Befehl erstellen Sie eine Azure Managed Redis-Instanz mit dem angegebenen Namen, Speicherort und der angegebenen Ressourcengruppe. Die Instanz hat eine Größe von 1 GB, wobei der Nicht-SSL-Port deaktiviert ist.
Um Clustering zu aktivieren, geben Sie eine Shardanzahl mit dem Parameter ShardCount ein.
Um Werte für die RedisConfiguration-Parameter anzugeben, schließen Sie die Werte als Schlüssel-Wert-Paare in {} ein (Beispiel: @{"maxmemory-policy" = "allkeys-random", "notify-keyspace-events" = "KEA"}). Im folgenden Beispiel wird ein 1-GB-Cache mit der maxmemory-Richtlinie allkeys-random und mit KEA konfigurierten Keyspace-Benachrichtigungen erstellt. Weitere Informationen finden Sie unter Keyspacebenachrichtigungen (Erweiterte Einstellungen) und Arbeitsspeicherrichtlinien.
New-AzRedisEnterpriseCache -ResourceGroupName myGroup -Name mycache -Location "North Central US" -RedisConfiguration @{"maxmemory-policy" = "allkeys-random", "notify-keyspace-events" = "KEA"}
So konfigurieren Sie die Einstellung für Datenbanken während der Erstellung des Caches
Die Einstellung databases kann nur während der Erstellung des Caches konfiguriert werden. Im folgenden Beispiel wird ein Cache mit 48 Datenbanken mit dem Cmdlet New-AzRedisEnterpriseCache erstellt.
New-AzRedisEnterpriseCache -ResourceGroupName myGroup -Name mycache -Location "North Central US" -Sku B1 -RedisConfiguration @{"databases" = "48"}
Weitere Informationen zur Eigenschaft databases finden Sie unter Standardmäßige Azure Managed Redis-Serverkonfiguration. Weitere Informationen zum Erstellen eines Cache mithilfe des Cmdlets New-AzRedisEnterpriseCache finden Sie im vorherigen Abschnitt „So erstellen Sie eine Azure Managed Redis-Instanz“.
So aktualisieren Sie eine Azure Managed Redis-Instanz
Azure Managed Redis-Instanzen werden mit dem Cmdlet [Set-AzRedisEnterpriseCache] aktualisiert.
Um eine Liste der verfügbaren Parameter und ihrer Beschreibungen für Set-AzRedisEnterpriseCacheanzuzeigen, führen Sie den folgenden Befehl aus.
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).
Das Cmdlet Set-AzRedisEnterpriseCache kann verwendet werden, um Eigenschaften wie Sku, EnableNonSslPort und die RedisConfiguration-Werte zu aktualisieren.
Mit dem folgenden Befehl wird die maxmemory-Richtlinie für die Azure Managed Redis-Instanz mit dem Namen „myCache“ aktualisiert.
Set-AzRedisEnterpriseCache -ResourceGroupName "myGroup" -Name "myCache" -RedisConfiguration @{"maxmemory-policy" = "allkeys-random"}
So rufen Sie weitere Informationen zur Azure Managed Redis-Instanz ab
Sie können Informationen zu einem Cache mithilfe des Cmdlets Get-AzRedisEnterpriseCache abrufen.
Um eine Liste der verfügbaren Parameter und ihrer Beschreibungen für Get-AzRedisEnterpriseCacheanzuzeigen, führen Sie den folgenden Befehl aus.
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).
Um Informationen über alle Caches im aktuellen Abonnement zurückzugeben, führen Sie Get-AzRedisEnterpriseCache ohne Parameter aus.
Get-AzRedisEnterpriseCache
Um Informationen über alle Caches in einer bestimmten Ressourcengruppe zurückzugeben, führen Sie Get-AzRedisEnterpriseCache mit dem ResourceGroupName-Parameter aus.
Get-AzRedisEnterpriseCache -ResourceGroupName myGroup
Um Informationen zu einem bestimmten Cache zurückzugeben, führen Sie Get-AzRedisEnterpriseCache mit dem Name-Parameter aus, der den Namen des Caches enthält, und den ResourceGroupName-Parameter mit der Ressourcengruppe, die diesen Cache enthält.
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 :
So rufen Sie die Zugriffsschlüssel für eine Azure Managed Redis-Instanz ab
Um die Zugriffsschlüssel für Ihren Cache abzurufen, können Sie das Cmdlet Get-AzRedisEnterpriseCacheKey verwenden.
Um eine Liste der verfügbaren Parameter und ihrer Beschreibungen für Get-AzRedisEnterpriseCacheKeyanzuzeigen, führen Sie den folgenden Befehl aus.
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).
Um die Schlüssel für Ihren Cache abzurufen, rufen Sie das Get-AzRedisEnterpriseCacheKey -Cmdlet auf und übergeben Sie im Namen Ihres Caches den Namen der Ressourcengruppe, die den Cache enthält.
PS C:\> Get-AzRedisEnterpriseCacheKey -Name myCache -ResourceGroupName myGroup
PrimaryKey : b2wdt43sfetlju4hfbryfnregrd9wgIcc6IA3zAO1lY=
SecondaryKey : ABhfB757JgjIgt785JgKH9865eifmekfnn649303JKL=
So generieren Sie Zugriffsschlüssel für Ihre Azure Managed Redis-Instanz erneut
Um die Zugriffsschlüssel für Ihren Cache erneut zu generieren, können Sie das Cmdlet New-AzRedisEnterpriseCacheKey verwenden.
Um eine Liste der verfügbaren Parameter und ihrer Beschreibungen für New-AzRedisEnterpriseCacheKeyanzuzeigen, führen Sie den folgenden Befehl aus.
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).
Um den primären oder sekundären Schlüssel für Ihren Cache erneut zu generieren, rufen Sie das New-AzRedisEnterpriseCacheKey-Cmdlet auf und übergeben Sie den Namen und die Ressourcengruppe. Geben Sie entweder Primary oder Secondary für den KeyType-Parameter an. Im folgenden Beispiel wird der sekundäre Zugriffsschlüssel für einen Cache erneut generiert.
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=
So löschen Sie eine Azure Managed Redis-Instanz
Um eine Azure Managed Redis-Instanz zu löschen, verwenden Sie das Cmdlet Remove-AzRedisEnterpriseCache.
Um eine Liste der verfügbaren Parameter und ihrer Beschreibungen für Remove-AzRedisEnterpriseCacheanzuzeigen, führen Sie den folgenden Befehl aus.
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).
Im folgenden Beispiel wird der Cache mit dem Namen myCache entfernt.
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
So importieren Sie eine Azure Managed Redis-Instanz
Sie können mit dem Cmdlet Import-AzRedisEnterpriseCache Daten in eine Azure Managed Redis-Instanz importieren.
Um eine Liste der verfügbaren Parameter und ihrer Beschreibungen für Import-AzRedisEnterpriseCacheanzuzeigen, führen Sie den folgenden Befehl aus.
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).
Mit dem folgenden Befehl werden Daten aus dem vom SAS-URI angegebenen Blob in Azure Managed Redis importiert.
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
So exportieren Sie eine Azure Managed Redis-Instanz
Sie können mit dem Cmdlet Export-AzRedisEnterpriseCache Daten aus einer Azure Managed Redis-Instanz exportieren.
Um eine Liste der verfügbaren Parameter und ihrer Beschreibungen für Export-AzRedisEnterpriseCacheanzuzeigen, führen Sie den folgenden Befehl aus.
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).
Mit dem folgenden Befehl werden Daten aus einer Azure Managed Redis-Instanz in den vom SAS-URI angegebenen Container exportiert.
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"
So starten Sie eine Azure Managed Redis-Instanz (Vorschau) neu
Sie können mit dem Cmdlet Reset-AzRedisEnterpriseCache Ihre Azure Managed Redis-Instanz (Vorschau) neu starten.
Um eine Liste der verfügbaren Parameter und ihrer Beschreibungen für Reset-AzRedisEnterpriseCacheanzuzeigen, führen Sie den folgenden Befehl aus.
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).
Der folgende Befehl startet beide Knoten des angegebenen Cache neu.
PS C:\>Reset-AzRedisEnterpriseCache -ResourceGroupName "resourceGroupName" -Name "cacheName" -RebootType "AllNodes"
-Force
Hinweis
Azure verfügt über zwei verschiedene Bereitstellungsmodelle zum Erstellen und Verwenden von Ressourcen: Azure Resource Manager-Bereitstellung und klassische Bereitstellung. In diesem Artikel wird die Verwendung des Resource Manager-Bereitstellungsmodells beschrieben. Es wird empfohlen, für neue Bereitstellungen anstelle des klassischen Bereitstellungsmodells das Resource Manager-Bereitstellungsmodell zu verwenden.
Weitere Informationen über das klassische Bereitstellungsmodell finden Sie unter Azure Resource Manager-Bereitstellung im Vergleich zur klassischen Bereitstellung: Grundlegendes zu Bereitstellungsmodellen und zum Status von Ressourcen.
Voraussetzungen
Wenn Sie bereits Azure PowerShell installiert haben, benötigen Sie Version 1.0.0 oder höher. Sie können die Azure PowerShell-Version mit diesem Befehl über die Azure PowerShell-Eingabeaufforderung prüfen.
Get-Module Az | format-table version
Zunächst müssen Sie sich mit dem folgenden Befehl bei Azure anmelden.
Connect-AzAccount
Geben Sie die E-Mail-Adresse Ihres Azure-Kontos und Ihr Kennwort in das Anmeldedialogfeld von Microsoft Azure ein.
Wenn Sie über mehrere Azure-Abonnements verfügen, müssen Sie als Nächstes Ihr Azure-Abonnement festlegen. Führen Sie den folgenden Befehl aus, um eine Liste Ihrer aktuellen Abonnements anzuzeigen.
Get-AzSubscription | sort SubscriptionName | Select SubscriptionName
Führen Sie den folgenden Befehl aus, um das Abonnement anzugeben. Im folgenden Beispiel ist der Name des Abonnements ContosoSubscription.
Select-AzSubscription -SubscriptionName ContosoSubscription
Bevor Sie Windows PowerShell mit dem Azure Resource Manager verwenden können, müssen Sie Ihre Einstellungen verifizieren:
- Windows PowerShell, Version 3.0 oder 4.0. Um die Version von Windows PowerShell zu ermitteln, geben Sie
$PSVersionTableein. Vergewissern Sie sich, dass der Wert vonPSVersion3.0 oder 4.0 ist. Informationen zum Installieren einer kompatiblen Version finden Sie unter Windows Management Framework 3.0.
Um detaillierte Hilfe zu einem Cmdlet aus dem Lernprogramm zu erhalten, verwenden Sie das „Get-Help“-Cmdlet.
Get-Help <cmdlet-name> -Detailed
Geben Sie beispielsweise Folgendes ein, um Hilfe zum New-AzRedisCache -Cmdlet zu erhalten:
Get-Help New-AzRedisCache -Detailed
Herstellen von Verbindungen mit anderen Clouds
Standardmäßig ist die Azure-Umgebung AzureCloud (die globale Azure-Cloudinstanz). Verwenden Sie zum Verbinden mit einer anderen Instanz den Connect-AzAccount-Befehl mit dem Befehlszeilenschalter -Environment oder -EnvironmentName mit der gewünschten Umgebung bzw. dem gewünschten Umgebungsnamen.
Führen Sie zum Anzeigen der Liste der verfügbaren Umgebungen das Cmdlet Get-AzEnvironment aus.
Verbinden mit der Azure Government-Cloud
Verwenden Sie zum Verbinden mit der Azure Government-Cloud einen der folgenden Befehle.
Connect-AzAccount -EnvironmentName AzureUSGovernment
oder
Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureUSGovernment)
Verwenden Sie zum Erstellen eines Caches in der Azure Government-Cloud einen der folgenden Standorte.
- US Government, Virginia
- US Government, Iowa
Weitere Informationen zur Azure Government-Cloud finden Sie unter Microsoft Azure Government und im Microsoft Azure Government-Entwicklerhandbuch.
So stellen Sie eine Verbindung her mit der Microsoft Azure-Cloud, betrieben von 21Vianet
Verwenden Sie einen der folgenden Befehle zum Verbinden mit der Azure-Cloud, betrieben von 21Vianet.
Connect-AzAccount -EnvironmentName AzureChinaCloud
Oder
Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureChinaCloud)
Verwenden Sie einen der folgenden Speicherorte zum Erstellen eines Caches in der Azure-Cloud, betrieben von 21Vianet.
- China, Osten
- China, Norden
So stellen Sie eine Verbindung mit Microsoft Azure Deutschland her
Verwenden Sie zum Herstellen einer Verbindung mit Microsoft Azure Deutschland einen der folgenden Befehle.
Connect-AzAccount -EnvironmentName AzureGermanCloud
oder
Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureGermanCloud)
Verwenden Sie einen der folgenden Orte, um einen Cache in Microsoft Azure Deutschland zu erstellen.
- Deutschland, Mitte
- Deutschland, Nordosten
Weitere Informationen zu Microsoft Azure Deutschland finden Sie unter Microsoft Azure Deutschland.
Eigenschaften, die für Azure Cache for Redis-PowerShell verwendet werden
Die folgende Tabelle enthält Eigenschaften und Beschreibungen von Azure PowerShell für Parameter, die beim Erstellen und Verwalten Ihrer Azure Cache for Redis-Instanzen häufig verwendet werden.
| Parameter | BESCHREIBUNG | Standard |
|---|---|---|
| Name | Name des Caches | |
| Location | Ort des Caches | |
| ResourceGroupName | Name der Ressourcengruppe, in der der Cache erstellt werden soll | |
| Size | Die Größe des Caches. Gültige Werte sind: 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 | Die Anzahl der zu erstellenden Shards beim Erstellen eines Premium-Caches mit Clusterunterstützung. Gültige Werte sind: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 | |
| SKU | Gibt die SKU des Caches an. Gültige Werte sind: Basic, Standard, Premium | Standard |
| RedisConfiguration | Gibt die Konfigurationseinstellungen für Redis an. Details zu den einzelnen Einstellungen finden Sie in der Tabelle RedisConfiguration-Eigenschaften . | |
| EnableNonSslPort | Gibt an, ob der Nicht-SSL-Port aktiviert ist. | False |
| MaxMemoryPolicy | Dieser Parameter ist veraltet – verwenden Sie stattdessen RedisConfiguration. | |
| StaticIP | Wenn Sie den Cache in einem VNET hosten, geben Sie hiermit eine eindeutige IP-Adresse im Subnetz für den Cache an. Wird keine IP-Adresse angegeben, wird eine für Sie aus dem Subnetz ausgewählt. | |
| Subnet | Wenn Sie den Cache in einem VNET hosten, geben Sie hiermit den Namen des Subnetzes an, in dem der Cache bereitgestellt wird. | |
| VirtualNetwork | Wenn Sie den Cache in einem VNET hosten, geben Sie hiermit die Ressourcen-ID des VNET an, in dem der Cache bereitgestellt wird. | |
| KeyType | Gibt an, welcher Zugriffsschlüssel beim Erneuern der Zugriffsschlüssel neu generiert werden muss. Gültige Werte sind: Primary, Secondary |
RedisConfiguration-Eigenschaften
| Eigenschaft | BESCHREIBUNG | Tarife |
|---|---|---|
| rdb-backup-enabled | Gibt an, ob Redis-Datenpersistenz aktiviert ist | Nur Premium |
| rdb-storage-connection-string | Die Verbindungszeichenfolge für das Speicherkonto für Redis-Datenpersistenz | Nur Premium |
| rdb-backup-frequency | Die Sicherungshäufigkeit für Redis-Datenpersistenz | Nur Premium |
| maxmemory-reserved | Konfiguriert den für andere Prozesse als Cacheprozesse reservierten Speicher | Standard und Premium |
| maxmemory-policy | Konfiguriert die Entfernungsrichtlinie für den Cache | Alle Tarife |
| notify-keyspace-events | Konfiguriert die Keyspace-Benachrichtigungen | Standard und Premium |
| hash-max-ziplist-entries | Konfiguriert die Speicheroptimierung für kleine Aggregatdatentypen | Standard und Premium |
| hash-max-ziplist-value | Konfiguriert die Speicheroptimierung für kleine Aggregatdatentypen | Standard und Premium |
| set-max-intset-entries | Konfiguriert die Speicheroptimierung für kleine Aggregatdatentypen | Standard und Premium |
| zset-max-ziplist-entries | Konfiguriert die Speicheroptimierung für kleine Aggregatdatentypen | Standard und Premium |
| zset-max-ziplist-value | Konfiguriert die Speicheroptimierung für kleine Aggregatdatentypen | Standard und Premium |
| databases | Konfiguriert die Anzahl der Datenbanken. Diese Eigenschaft kann nur bei der Erstellung des Caches konfiguriert werden. | Standard und Premium |
So erstellen Sie einen Azure Cache for Redis
Neue Azure Cache for Redis-Instanzen werden mit dem New-AzRedisCache-Cmdlet erstellt.
Wichtig
Beim ersten Erstellen eines Azure Cache for Redis in einem Abonnement mithilfe des Azure-Portals registriert das Portal den Microsoft.Cache-Namespace für dieses Abonnement. Wenn Sie versuchen, den ersten Azure Cache for Redis in einem Abonnement mithilfe von PowerShell zu erstellen, müssen Sie zunächst diesen Namespace mit dem folgenden Befehl registrieren; andernfalls tritt beim Ausführen von Cmdlets wie New-AzRedisCache und Get-AzRedisCache ein Fehler auf.
Register-AzResourceProvider -ProviderNamespace "Microsoft.Cache"
Um eine Liste der verfügbaren Parameter und ihrer Beschreibungen für New-AzRedisCacheanzuzeigen, führen Sie den folgenden Befehl aus.
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).
Um einen Cache mit Standardparametern zu erstellen, führen Sie den folgenden Befehl aus.
New-AzRedisCache -ResourceGroupName myGroup -Name mycache -Location "North Central US"
ResourceGroupName, Name und Location sind erforderliche Parameter, aber die übrigen sind optional und haben Standardwerte. Mit dem vorherigen Befehl erstellen Sie eine Standard-SKU-Azure Cache for Redis-Instanz mit Name, Speicherort und Ressourcengruppe gemäß der entsprechenden Angaben. Die Instanz hat eine Größe von 1 GB, wobei der Nicht-SSL-Port deaktiviert ist.
Um einen Premium-Cache zu erstellen, geben Sie eine Größe von P1 (6 bis 60 GB), P2 (13 bis 130 GB), P3 (26 bis 260 GB), oder P4 (53 bis 530 GB) ein. Um Clustering zu aktivieren, geben Sie eine Shardanzahl mit dem Parameter ShardCount ein. Das folgende Beispiel erstellt einen P1-Premium-Cache mit drei Shards. Ein P1-Premium-Cache ist 6 GB groß, und da wir drei Shards angegeben haben, beträgt die Gesamtgröße 18 GB (3 x 6 GB).
New-AzRedisCache -ResourceGroupName myGroup -Name mycache -Location "North Central US" -Sku Premium -Size P1 -ShardCount 3
Um Werte für die RedisConfiguration-Parameter anzugeben, schließen Sie die Werte als Schlüssel-Wert-Paare in {} ein (Beispiel: @{"maxmemory-policy" = "allkeys-random", "notify-keyspace-events" = "KEA"}). Im folgenden Beispiel wird ein standardmäßiger 1 GB-Cache mit allkeys-random-maxmemory-Richtlinie und mit KEA konfigurierten Keyspace-Benachrichtigungen erstellt. Weitere Informationen finden Sie unter Keyspacebenachrichtigungen (Erweiterte Einstellungen) und Arbeitsspeicherrichtlinien.
New-AzRedisCache -ResourceGroupName myGroup -Name mycache -Location "North Central US" -RedisConfiguration @{"maxmemory-policy" = "allkeys-random", "notify-keyspace-events" = "KEA"}
So konfigurieren Sie die Einstellung für Datenbanken während der Erstellung des Caches
Die Einstellung databases kann nur während der Erstellung des Caches konfiguriert werden. Mit dem folgenden Beispiel wird ein Premium-P3-Cache (26 GB) mit 48 Datenbanken mit dem New-AzRedisCache-Cmdlet erstellt.
New-AzRedisCache -ResourceGroupName myGroup -Name mycache -Location "North Central US" -Sku Premium -Size P3 -RedisConfiguration @{"databases" = "48"}
Weitere Informationen zur Eigenschaft databases finden Sie unter Standardmäßige Azure Cache for Redis-Serverkonfiguration. Weitere Informationen zum Erstellen eines Caches mithilfe des New-AzRedisCache-Cmdlets finden Sie im vorherigen Abschnitt „So erstellen Sie eine Azure Cache for Redis-Instanz“.
So aktualisieren Sie einen Azure Cache for Redis
Azure Cache for Redis-Instanzen werden mit dem New-AzRedisCache-Cmdlet aktualisiert.
Um eine Liste der verfügbaren Parameter und ihrer Beschreibungen für Set-AzRedisCacheanzuzeigen, führen Sie den folgenden Befehl aus.
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).
Das Cmdlet Set-AzRedisCache kann verwendet werden, um Eigenschaften wie Size, Sku, EnableNonSslPort und die RedisConfiguration-Werte zu aktualisieren.
Der folgende Befehl aktualisiert die maxmemory-Richtlinie für den Azure Cache for Redis mit dem Namen „myCache“.
Set-AzRedisCache -ResourceGroupName "myGroup" -Name "myCache" -RedisConfiguration @{"maxmemory-policy" = "allkeys-random"}
So skalieren Sie einen Azure Cache for Redis
Set-AzRedisCache kann verwendet werden, um eine Azure Cache for Redis-Instanz zu skalieren, wenn die Eigenschaften Size, Sku oder ShardCount geändert werden.
Hinweis
Das Skalieren eines Caches mithilfe von PowerShell unterliegt den gleichen Einschränkungen und Richtlinien wie das Skalieren eines Caches über das Azure-Portal. Sie können mit den folgenden Einschränkungen auf eine andere Preisstufe skalieren.
- Sie können keine Skalierung von einem höheren Tarif auf einen niedrigeren Tarif vornehmen.
- Eine Skalierung von einem Premium-Cache auf einen niedrigeren Standard- oder Basic-Cache ist nicht möglich.
- Ein Standard-Cache kann nicht auf einen niedrigeren Basic-Cache skaliert werden.
- Ein Basic-Cache kann auf einen Standard-Cache skaliert werden, die Größe kann jedoch nicht gleichzeitig geändert werden. Wenn Sie eine andere Größe benötigen, können Sie anschließend einen Skalierungsvorgang auf die gewünschte Größe durchführen.
- Ein Basic-Cache kann nicht direkt auf einen Premium-Cache skaliert werden. Stattdessen müssen Sie in einem ersten Skalierungsvorgang von Basic auf Standard skalieren und dann in einem anschließenden Skalierungsvorgang von Standard auf Premium.
- Von einer größeren Größe kann nicht auf C0 (250 MB) herunterskaliert werden.
Weitere Informationen finden Sie unter Skalieren von Azure Cache for Redis.
Das folgende Beispiel veranschaulicht, wie ein Cache mit Namen myCache zu einem 2,5-GB-Cache skaliert wird. Dieser Befehl kann sowohl für einen Basic- als auch für einen Standard-Cache verwendet werden.
Set-AzRedisCache -ResourceGroupName myGroup -Name myCache -Size 2.5GB
Nach Eingabe dieses Befehls wird der Status des Caches zurückgegeben (ähnlich wie beim Aufruf von Get-AzRedisCache). ProvisioningState wird auf Scaling festgelegt.
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 :
Nach Abschluss des Skalierungsvorgangs ändert sich ProvisioningState in Succeeded. Wenn Sie weitere Skalierungen vornehmen möchten (z. B. einen Wechsel von Basic zu Standard oder eine Änderung der Größe), müssen Sie warten, bis der vorherige Vorgang abgeschlossen ist. Andernfalls wird eine Fehlermeldung wie die folgende angezeigt.
Set-AzRedisCache : Conflict: The resource '...' is not in a stable state, and is currently unable to accept the update request.
So erhalten Sie weitere Informationen zum Azure Cache for Redis
Sie können Informationen zu einem Cache mithilfe des Get-AzRedisCache-Cmdlets abrufen.
Um eine Liste der verfügbaren Parameter und ihrer Beschreibungen für Get-AzRedisCacheanzuzeigen, führen Sie den folgenden Befehl aus.
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).
Um Informationen über alle Caches im aktuellen Abonnement zurückzugeben, führen Sie Get-AzRedisCache ohne Parameter aus.
Get-AzRedisCache
Um Informationen über alle Caches in einer bestimmten Ressourcengruppe zurückzugeben, führen Sie Get-AzRedisCache mit dem ResourceGroupName-Parameter aus.
Get-AzRedisCache -ResourceGroupName myGroup
Um Informationen zu einem bestimmten Cache zurückzugeben, führen Sie Get-AzRedisCache mit dem Name-Parameter aus, der den Namen des Caches enthält, und den ResourceGroupName-Parameter mit der Ressourcengruppe, die diesen Cache enthält.
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 :
So rufen Sie die Zugriffsschlüssel für einen Azure Cache for Redis ab
Um die Zugriffsschlüssel für Ihren Cache abzurufen, können Sie das New-AzRedisCache-Cmdlet verwenden.
Um eine Liste der verfügbaren Parameter und ihrer Beschreibungen für Get-AzRedisCacheKeyanzuzeigen, führen Sie den folgenden Befehl aus.
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).
Um die Schlüssel für Ihren Cache abzurufen, rufen Sie das Get-AzRedisCacheKey -Cmdlet auf und übergeben Sie im Namen Ihres Caches den Namen der Ressourcengruppe, die den Cache enthält.
PS C:\> Get-AzRedisCacheKey -Name myCache -ResourceGroupName myGroup
PrimaryKey : b2wdt43sfetlju4hfbryfnregrd9wgIcc6IA3zAO1lY=
SecondaryKey : ABhfB757JgjIgt785JgKH9865eifmekfnn649303JKL=
So generieren Sie Zugriffsschlüssel für Ihren Azure Cache for Redis neu
Um die Zugriffsschlüssel für Ihren Cache abzurufen, können Sie das New-AzRedisCache-Cmdlet verwenden.
Um eine Liste der verfügbaren Parameter und ihrer Beschreibungen für New-AzRedisCacheKeyanzuzeigen, führen Sie den folgenden Befehl aus.
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).
Um den primären oder sekundären Schlüssel für Ihren Cache erneut zu generieren, rufen Sie das New-AzRedisCacheKey-Cmdlet auf und übergeben Sie den Namen und die Ressourcengruppe. Geben Sie entweder Primary oder Secondary für den KeyType-Parameter an. Im folgenden Beispiel wird der sekundäre Zugriffsschlüssel für einen Cache erneut generiert.
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=
So löschen Sie einen Azure Cache for Redis
Um einen Azure Cache for Redis zu löschen, verwenden Sie das Remove-AzRedisCache-Cmdlet.
Um eine Liste der verfügbaren Parameter und ihrer Beschreibungen für Remove-AzRedisCacheanzuzeigen, führen Sie den folgenden Befehl aus.
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).
Im folgenden Beispiel wird der Cache mit dem Namen myCache entfernt.
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
So importieren Sie einen Azure Cache for Redis
Sie können mit dem Cmdlet Import-AzRedisCache Daten in eine Azure Cache for Redis-Instanz importieren.
Wichtig
Import/Export ist nur für Caches im Premium-Tarif verfügbar. Weitere Informationen zum Importieren/Exportieren finden Sie unter Importieren und Exportieren von Daten in Azure Cache for Redis.
Um eine Liste der verfügbaren Parameter und ihrer Beschreibungen für Import-AzRedisCacheanzuzeigen, führen Sie den folgenden Befehl aus.
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).
Der folgende Befehl importiert Daten aus dem vom SAS-URI angegebenen Blob in Azure Cache for 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
So exportieren Sie einen Azure Cache for Redis
Sie können mit dem Cmdlet Export-AzRedisCache Daten aus einer Azure Cache for Redis-Instanz exportieren.
Wichtig
Import/Export ist nur für Caches im Premium-Tarif verfügbar. Weitere Informationen zum Importieren/Exportieren finden Sie unter Importieren und Exportieren von Daten in Azure Cache for Redis.
Um eine Liste der verfügbaren Parameter und ihrer Beschreibungen für Export-AzRedisCacheanzuzeigen, führen Sie den folgenden Befehl aus.
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).
Der folgende Befehl exportiert Daten aus einer Azure Cache for Redis-Instanz in den vom SAS-URI angegebenen Container.
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"
So starten Sie einen Azure Cache for Redis neu
Sie können mit dem Cmdlet Reset-AzRedisCache Ihre Azure Cache for Redis-Instanz neu starten.
Wichtig
Ein Neustart ist nur für Caches in den Tarifen Basic, Standard und Premium verfügbar. Weitere Informationen zum Neustarten Ihres Cache finden Sie unter Verwalten von Azure Redis Cache – Neustart.
Um eine Liste der verfügbaren Parameter und ihrer Beschreibungen für Reset-AzRedisCacheanzuzeigen, führen Sie den folgenden Befehl aus.
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).
Der folgende Befehl startet beide Knoten des angegebenen Cache neu.
PS C:\>Reset-AzRedisCache -ResourceGroupName "resourceGroupName" -Name "cacheName" -RebootType "AllNodes"
-Force
Nächste Schritte
Weitere Informationen zur Verwendung von Windows PowerShell mit Azure finden Sie in den folgenden Ressourcen:
- Dokumentation zu den Azure Cache for Redis-Cmdlets auf MSDN
- Azure Resource Manager-Cmdlets: Hier erfahren Sie, wie Sie die Cmdlets im Azure Resource Manager-Modul verwenden.
- Verwenden von Ressourcengruppen zum Verwalten von Azure-Ressourcen: Hier erfahren Sie, wie Sie Ressourcengruppen im Azure-Portal erstellen und verwalten.
- Azure-Blog: Informationen zu neuen Funktionen in Azure.
- Windows PowerShell-Blog: Informationen zu neuen Funktionen in Windows PowerShell.
- "Hey, Scripting Guy!"- Blog: Praktische Tipps und Tricks aus der Windows PowerShell-Community.