Freigeben über

Verwalten von Azure Redis mit Azure PowerShell

  • Gilt für:: ✅ Azure Cache for Redis, ✅ Azure Managed Redis

In diesem Artikel erfahren Sie, wie Sie Ihre Azure Redis-Instanzen mithilfe von Azure PowerShell erstellen, verwalten und löschen.

Voraussetzungen

  • Stellen Sie sicher, dass Sie mit dem Abonnement, unter dem Sie Ihren Cache erstellen möchten, bei Azure angemeldet sind. Um ein anderes Abonnement als das, mit dem Sie angemeldet sind, zu verwenden, führen Sie Select-AzSubscription -SubscriptionName <SubscriptionName> aus.

Hinweis

Azure Managed Redis verwendet die Azure PowerShell Az.RedisEnterpriseCache-Befehle .

Azure Cache for Redis verwendet die Az.RedisEnterpriseCache Befehle für Enterprise-Ebenen und die Azure PowerShell Az.RedisCache-Befehle für die Ebenen "Basic", "Standard" und "Premium". Sie können die folgenden Skripts verwenden, um Azure Managed Redis oder Azure Cache für Redis Enterprise zu erstellen und zu verwalten. Verwenden Sie für Azure Cache für Redis Basic, Standard und Premium den Azure-Cache für Redis-Skripts .

Erstellen eines Azure Managed Redis-Caches

Sie erstellen neue Azure Managed Redis-Instanzen mit dem Cmdlet New-AzRedisEnterpriseCache . ResourceGroupName, Name, Locationund Sku sind erforderliche Parameter. Die anderen Parameter sind optional und weisen Standardwerte auf.

Die Microsoft Entra-Authentifizierung ist standardmäßig für alle neuen Caches aktiviert und wird für die Sicherheit empfohlen.

Von Bedeutung

Verwenden Sie nach Möglichkeit Microsoft Entra ID mit verwalteten Identitäten, um Anforderungen für Ihren Cache zu autorisieren. Die Autorisierung mithilfe der Microsoft Entra-ID und der verwalteten Identität bietet eine bessere Sicherheit und ist einfacher zu verwenden als die Autorisierung gemeinsam genutzter Zugriffstasten. Weitere Informationen zur Verwendung von verwalteten Identitäten mit Ihrem Cache finden Sie unter Verwenden von Microsoft Entra für die Cacheauthentifizierung mit Azure Managed Redis.

Alle Azure Managed Redis PowerShell-Parameter und -Eigenschaften finden Sie unter New-AzRedisEnterpriseCacheNew-AzRedisEnterpriseCache. Führen Sie den folgenden Befehl aus, um eine Liste der verfügbaren Parameter und deren Beschreibungen auszugeben.

Get-Help New-AzRedisEnterpriseCache -detailed

Hinweis

Wenn Sie zum ersten Mal einen Azure Managed Redis-Cache in einem Abonnement erstellen, registriert Azure den Microsoft.Cache Namespace für Sie. Wenn Sie dazu aufgefordert werden, können Sie den Azure PowerShell-Befehl Register-AzResourceProvider -ProviderNamespace "Microsoft.Cache" verwenden, um den Namespace zu registrieren.

Mit dem folgenden Beispielbefehl wird eine Azure Managed Redis-Instanz mit dem angegebenen Namen, dem angegebenen Speicherort, der Ressourcengruppe und der SKU mithilfe von Standardparametern erstellt. Die Instanz hat eine Größe von 1 GB, wobei der Nicht-SSL-Port deaktiviert ist.

New-AzRedisEnterpriseCache -ResourceGroupName myGroup -Name mycache -Location "North Central US" -Sku Balanced_B1

Erstellen und Konfigurieren von Datenbanken

Sie können das Cmdlet New-AzRedisEnterpriseCacheDatabase verwenden, um Datenbanken für Ihren Azure Managed Redis-Cache zu erstellen und zu konfigurieren. Um eine Liste der verfügbaren Parameter und ihrer Beschreibungen für New-AzRedisEnterpriseCacheDatabaseanzuzeigen, führen Sie den folgenden Befehl aus.

Get-Help New-AzRedisEnterpriseCacheDatabase -detailed

Wenn Sie Datenbanken während der Cacheerstellung nicht konfigurieren, erstellt New-AzRedisEnterpriseCache standardmäßig eine Datenbank im Cache mit dem Namen default , und alle Cachedaten werden in diese DB 0 Datenbank eingefügt.

Aktualisieren eines Azure Managed Redis-Caches

Sie können Azure Managed Redis-Instanzen mithilfe des Cmdlets Update-AzRedisEnterpriseCache aktualisieren. Um eine Liste der verfügbaren Parameter und ihrer Beschreibungen für Update-AzRedisEnterpriseCacheanzuzeigen, führen Sie den folgenden Befehl aus.

Get-Help Update-AzRedisEnterpriseCache -detailed

Sie können das Update-AzRedisEnterpriseCache Cmdlet verwenden, um Eigenschaften wie Sku, Tag und MinimumTlsVersion zu aktualisieren. Mit dem folgenden Befehl wird die minimale TLS-Version (Transport Layer Security) aktualisiert und dem Azure Managed Redis-Cache ein Tag hinzugefügt myCache.

Update-AzRedisEnterpriseCache -Name "myCache" -ResourceGroupName "myGroup" -MinimumTlsVersion "1.2" -Tag @{"tag1" = "value1"}

Abrufen von Informationen zu einem Azure Managed Redis-Cache

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.

Get-Help Get-AzRedisEnterpriseCache -detailed

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 abzurufen, führen Sie Get-AzRedisEnterpriseCache mit den Kennungen Name und ResourceGroupName des Caches aus.

Get-AzRedisEnterpriseCache -Name myCache -ResourceGroupName myGroup

Zugriffsschlüssel für einen verwalteten Azure Redis-Cache abrufen

Verwenden Sie das Cmdlet Get-AzRedisEnterpriseCacheKey , um die Zugriffstasten für Ihren Cache abzurufen. Um eine Liste der verfügbaren Parameter und ihrer Beschreibungen für Get-AzRedisEnterpriseCacheKeyanzuzeigen, führen Sie den folgenden Befehl aus.

Get-Help Get-AzRedisEnterpriseCacheKey -detailed

Rufen Sie zum Abrufen der Schlüssel für Ihren Cache das Get-AzRedisEnterpriseCacheKey-Cmdlet mit dem Name und ResourceGroupName des Caches auf.

Get-AzRedisEnterpriseCacheKey -Name myCache -ResourceGroupName myGroup

Von Bedeutung

Der ListKeys Vorgang funktioniert nur, wenn Zugriffstasten für den Cache aktiviert sind. Die Ausgabe dieses Befehls kann die Sicherheit gefährden, indem geheime Schlüssel angezeigt werden und möglicherweise eine Warnung zu vertraulichen Informationen ausgelöst wird.

Neugenerierung von Zugriffsschlüsseln für einen Azure Managed Redis-Cache

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.

Get-Help New-AzRedisEnterpriseCacheKey -detailed

Um den primären oder sekundären Schlüssel für Ihren Cache neu zu generieren, rufen Sie das New-AzRedisEnterpriseCacheKey-Cmdlet mit dem Cache Name und ResourceGroupName auf und 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 neu generiert.

New-AzRedisEnterpriseCacheKey -Name myCache -ResourceGroupName myGroup -KeyType Secondary

Löschen eines Azure Managed Redis-Cache

Verwenden Sie das Cmdlet Remove-AzRedisEnterpriseCache , um einen Azure Managed Redis-Cache zu löschen. Um eine Liste der verfügbaren Parameter und ihrer Beschreibungen für Remove-AzRedisEnterpriseCacheanzuzeigen, führen Sie den folgenden Befehl aus.

Get-Help Remove-AzRedisEnterpriseCache -detailed

Im folgenden Beispiel wird der Cache mit dem Namen entfernt myCache.

Remove-AzRedisEnterpriseCache -Name myCache -ResourceGroupName myGroup

Importieren von Azure Managed Redis-Cachedaten

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.

Get-Help Import-AzRedisEnterpriseCache -detailed

Der Cache Name, ResourceGroupName und der SasUri des zu importierenden Blob sind erforderlich. Mit dem folgenden Befehl werden Daten aus dem durch den SAS-URI angegebenen BLOB importiert.

Import-AzRedisEnterpriseCache -ClusterName "myCache" -ResourceGroupName "myGroup" -SasUri @("<sas-uri>")

Exportieren von Azure Managed Redis-Cachedaten

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.

Get-Help Export-AzRedisEnterpriseCache -detailed

Der Cache Name und ResourceGroupName sowie das SasUri des zu exportierenden Containers sind erforderlich. Im folgenden Beispielbefehl werden Daten aus dem container exportiert, der durch den SAS-URI angegeben wird.

Export-AzRedisEnterpriseCache -Name "myCache" -ResourceGroupName "myGroup" -SasUri "https://mystorageaccount.blob.core.windows.net/mycontainer?sp=signedPermissions&se=signedExpiry&sv=signedVersion&sr=signedResource&sig=signature;mystoragekey"

Von Bedeutung

Azure Cache for Redis verwendet die Azure PowerShell Az.RedisCache-Befehle für die Ebenen "Basic", "Standard" und "Premium" sowie die Azure PowerShell Az.RedisEnterpriseCache-Befehle für Enterprise-Ebenen.

Sie können die folgenden Skripts verwenden, um Azure Cache für Redis Basic, Standard und Premium zu erstellen und zu verwalten. Verwenden Sie für Azure Cache für Redis Enterprise oder Azure Managed Redis die Azure Managed Redis-Befehle.

Azure Cache für Redis PowerShell-Eigenschaften und -Parameter

Die folgenden Tabellen zeigen Azure PowerShell-Eigenschaften und -Beschreibungen für allgemeine Azure Cache für Redis-Parameter. Alle Azure PowerShell-Parameter und -Eigenschaften können Sie unter Az.RedisCacheAzRedisCache sehen.

Parameter BESCHREIBUNG Standard
Name Name des Caches.
Standort Speicherort des Caches.
Ressourcengruppenname Ressourcengruppenname, in dem der Cache erstellt werden soll.
Größe 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
Anzahl der Shards 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.
Artikelnummer (SKU) Die SKU des Caches. Gültige Werte sind: Basic, Standard, Premium. Norm
RedisConfiguration Redis-Konfigurationseinstellungen. Details zu den einzelnen Einstellungen finden Sie in der Tabelle RedisConfiguration-Eigenschaften .
Nicht-SSL-Port aktivieren Gibt an, ob der nicht-SSL-Port aktiviert ist. Falsch
MaxMemoryPolicy Dieser Parameter ist veraltet. Verwenden Sie stattdessen RedisConfiguration.
StaticIP Wenn Sie Ihren Cache in einem virtuellen Netzwerk hosten, wird eine eindeutige IP-Adresse im Subnetz für den Cache verwendet. Wird keine IP-Adresse angegeben, wird eine für Sie aus dem Subnetz ausgewählt.
Subnetz Wenn Sie Ihren Cache in einem virtuellen Netzwerk hosten, wird der Name des Subnetzes, in dem der Cache bereitgestellt werden soll, angegeben.
VirtualNetwork Wenn Sie Ihren Cache in einem virtuellen Netzwerk hosten, benötigen Sie die Ressourcen-ID des virtuellen Netzwerks, in dem der Cache bereitgestellt werden soll.
Schlüsseltyp Welcher Zugriffsschlüssel beim Erneuern der Zugriffsschlüssel neu generiert werden muss. Gültige Werte sind: Primär, sekundär.

Eigenschaften für den Parameter „RedisConfiguration”

Eigentum 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 Speicher, der für Nichtcacheprozesse reserviert ist. Standard und Premium
Maximalspeicher-Richtlinie [Entfernungsrichtlinie]/azure-cache-for-redis/cache-configure.md#memory-policies) für den Cache. Alle Tarife
notify-keyspace-events [Keyspacebenachrichtigungen]/azure-cache-for-redis/cache-configure.md#keyspace-notifications-advanced-settings). Standard und Premium
hash-max-ziplist-einträge Speicheroptimierung für kleine aggregierte Datentypen. Standard und Premium
hash-max-ziplist-value Speicheroptimierung für kleine aggregierte Datentypen. Standard und Premium
set-max-intset-entries Speicheroptimierung für kleine aggregierte Datentypen. Standard und Premium
zset-max-ziplist-einträge Speicheroptimierung für kleine aggregierte Datentypen. Standard und Premium
zset-max-ziplist-value Speicheroptimierung für kleine aggregierte Datentypen. Standard und Premium
Datenbanken Anzahl der Datenbanken. Diese Eigenschaft kann nur bei der Cacheerstellung konfiguriert werden. Standard und Premium

Erstellen eines Azure-Caches für Redis-Cache

Sie erstellen neuen Azure-Cache für Redis-Instanzen mithilfe des Cmdlets New-AzRedisCache . ResourceGroupName, Nameund Location sind erforderliche Parameter. Die anderen Parameter sind optional und weisen Standardwerte auf.

Von Bedeutung

Die Microsoft Entra-Authentifizierung wird für die Sicherheit empfohlen. Sie können die Microsoft Entra-Authentifizierung während oder nach der Cacheerstellung aktivieren.

Verwenden Sie nach Möglichkeit Microsoft Entra ID mit verwalteten Identitäten, um Anforderungen für Ihren Cache zu autorisieren. Die Autorisierung mithilfe der Microsoft Entra-ID und der verwalteten Identität bietet eine bessere Sicherheit und ist einfacher zu verwenden als die Autorisierung gemeinsam genutzter Zugriffstasten. Weitere Informationen zum Verwenden verwalteter Identitäten mit Ihren Caches finden Sie unter Verwenden von Microsoft Entra ID für die Cacheauthentifizierung.

Führen Sie den folgenden Befehl aus, um eine Liste der verfügbaren Parameter und deren Beschreibungen für New-AzRedisCache anzuzeigen:

Get-Help New-AzRedisCache -detailed>

Hinweis

Wenn Sie zum ersten Mal einen Azure-Cache für Redis-Cache in einem Abonnement erstellen, registriert Azure den Microsoft.Cache Namespace für Sie. Wenn Sie dazu aufgefordert werden, können Sie den Azure PowerShell-Befehl Register-AzResourceProvider -ProviderNamespace "Microsoft.Cache" verwenden, um den Namespace zu registrieren.

Mit dem folgenden Beispielbefehl wird ein Azure Cache für Redis-Instanz mit dem angegebenen Namen, dem angegebenen Speicherort und der Ressourcengruppe mithilfe von Standardparametern erstellt. Die Instanz ist ein Standard-1-GB-Cache mit deaktiviertem Nicht-SSL-Port.

New-AzRedisCache -ResourceGroupName myGroup -Name mycache -Location "North Central US"

Um Werte für den RedisConfiguration Parameter anzugeben, schließen Sie die Schlüsselwertpaare in geschweifte Klammern {}ein. Das folgende Beispiel erstellt einen 1-GB-Cache mit @{"maxmemory-policy" = "allkeys-random", "notify-keyspace-events" = "KEA"}. 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"}

Erstellen eines Premium-Caches

Um einen Azure-Cache für Redis Premium-Ebenen zu erstellen, geben Sie eine Größe von P1 (6-60 GB), P2 (13-130 GB), P3 (26-260 GB) oder P4 (53-530 GB) an. Um Clustering zu aktivieren, geben Sie eine Shardanzahl mit dem Parameter ShardCount ein.

Im folgenden Beispiel wird ein P1 Premium-Cache mit drei Shards erstellt. Ein P1 Premium-Cache ist 6 GB groß, und mit drei Shards 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

Konfigurieren der Datenbankeinstellung

Die databases Einstellung im Cmdlet New-AzRedisCache konfiguriert die Anzahl der Datenbanken im Cache. Sie können databases nur für die Standard- und Premium-Tarife konfigurieren und nur während der Cache-Erstellung mithilfe von PowerShell oder anderen Verwaltungsclients.

Wenn Sie während der Cacheerstellung keine Einstellung angeben databases , erstellt New-AzRedisCache eine Datenbank mit dem Namen default, und alle Cachedaten werden in diese DB 0 Datenbank eingefügt. Der Datenbankgrenzwert hängt von Cacheebene und -größe ab, die Standardeinstellung ist jedoch 16.

Im folgenden Beispiel wird ein Premium-P3-Cache (26 GB) mit 48 Datenbanken 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.

Aktualisieren eines Azure-Caches für Redis-Cache

Sie aktualisieren Den Azure-Cache für Redis-Instanzen mithilfe des Cmdlets "Set-AzRedisCache ". Um eine Liste der verfügbaren Parameter und ihrer Beschreibungen für Set-AzRedisCacheanzuzeigen, führen Sie den folgenden Befehl aus.

Get-Help Set-AzRedisCache -detailed

Sie können das Set-AzRedisCache Cmdlet verwenden, um Eigenschaften wie Size, Sku, , EnableNonSslPortund die RedisConfiguration Werte zu aktualisieren. Der folgende Beispielbefehl aktualisiert den maxmemory-policy Azure Cache für Redis-Instanz mit dem Namen myCache.

Set-AzRedisCache -ResourceGroupName "myGroup" -Name "myCache" -RedisConfiguration @{"maxmemory-policy" = "allkeys-random"}

Skalieren eines Azure Cache for Redis-Cache

Sie können Set-AzRedisCache verwenden, um eine Azure Cache for Redis-Instanz zu skalieren, wenn Sie die Eigenschaften Size, Sku oder ShardCount ändern.

Hinweis

Das Skalieren eines Caches mit PowerShell hat dieselben Grenzwerte und Richtlinien wie das Skalieren eines Caches mithilfe des Azure-Portals. Sie können mit den folgenden Einschränkungen zu einem anderen Tarif wechseln:

  • Sie können nicht von einer höheren Preisstufe auf eine niedrigere Preisebene skalieren, z. B. von einem Premium-Cache zu einem Standard- oder Basic-Cache oder von einem Standard zu einem Basic-Cache.
  • Sie können von einem Basiscache auf einen Standardcache skalieren, aber Sie können die Größe dabei nicht ändern. Wenn Sie eine andere Größe benötigen, können Sie einen weiteren Skalierungsvorgang auf die gewünschte Größe ausführen.
  • Sie können nicht direkt von einem Basic-Cache auf einen Premium-Cache skalieren. Sie müssen in einem Skalierungsvorgang von "Basic" auf "Standard" und dann in einem anderen Vorgang von "Standard" auf "Premium" skalieren.
  • Sie können nicht von einer größeren Größe bis zur C0-Größe (250 MB) skalieren.

Weitere Informationen finden Sie unter Skalieren des Azure-Caches für Redis.

Das folgende Beispiel zeigt, wie Sie einen Cache myCache mit einer Größe von 2,5 GB skalieren. Dieser Befehl funktioniert für einen Basis- oder Standardcache.

Set-AzRedisCache -ResourceGroupName myGroup -Name myCache -Size 2.5GB

Nachdem Sie diesen Befehl ausgelöst haben, wird der Status des Caches zurückgegeben, ähnlich dem Aufrufen Get-AzRedisCache. ProvisioningState wird auf Scaling festgelegt.

Nach Abschluss des Skalierungsvorgangs ändert sich ProvisioningState in Succeeded. Wenn Sie einen anderen Skalierungsvorgang ausführen müssen, z. B. das Ändern der Größe nach dem Ändern von "Basic" in "Standard", müssen Sie warten, bis der vorherige Vorgang abgeschlossen ist. Andernfalls wird eine Fehlermeldung angezeigt, die der folgenden Meldung ähnelt.

Set-AzRedisCache : Conflict: The resource '...' is not in a stable state, and is currently unable to accept the update request.

Erhalten weiterer Informationen zum Azure Cache for Redis-Cache

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.

Get-Help Get-AzRedisCache -detailed

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 über einen bestimmten Cache abzurufen, führen Sie Get-AzRedisCache mit dem Cache Name und ResourceGroupName aus.

Get-AzRedisCache -Name myCache -ResourceGroupName myGroup

Abrufen der Zugriffsschlüssel für einen Azure Cache for Redis-Cache

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.

Get-Help Get-AzRedisCacheKey -detailed

Rufen Sie das Cmdlet mit dem Cache Get-AzRedisCacheKey, Name und ResourceGroupName auf, um die Schlüssel für Ihren Cache abzurufen.

Get-AzRedisCacheKey -Name myCache -ResourceGroupName myGroup

Von Bedeutung

Der ListKeys Vorgang funktioniert nur, wenn Zugriffstasten für den Cache aktiviert sind. Die Ausgabe dieses Befehls kann die Sicherheit gefährden, indem geheime Schlüssel angezeigt werden und möglicherweise eine Warnung zu vertraulichen Informationen ausgelöst wird.

Generieren der Zugriffsschlüssel für einen Azure Cache for Redis-Cache

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.

Get-Help New-AzRedisCacheKey -detailed

Um den primären oder sekundären Schlüssel für Ihren Cache neu zu generieren, rufen Sie das New-AzRedisCacheKey-Cmdlet mit dem Cache Name und ResourceGroupName auf und 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 neu generiert.

New-AzRedisCacheKey -Name myCache -ResourceGroupName myGroup -KeyType Secondary

Löschen eines Azure-Caches für Redis-Cache

Verwenden Sie das Cmdlet Remove-AzRedisCache , um einen Azure-Cache für Redis zu löschen. Um eine Liste der verfügbaren Parameter und ihrer Beschreibungen für Remove-AzRedisCacheanzuzeigen, führen Sie den folgenden Befehl aus.

Get-Help Remove-AzRedisCache -detailed

Im folgenden Beispiel wird der Cache mit dem Namen entfernt myCache.

Remove-AzRedisCache -Name myCache -ResourceGroupName myGroup

Importieren von Daten in einen Azure Cache for Redis-Cache

Sie können mit dem Cmdlet Import-AzRedisCache Daten in eine Azure Cache for Redis-Instanz importieren.

Von Bedeutung

Der Import ist nur für Premium-Caches verfügbar. Weitere Informationen finden Sie unter Importieren und Exportieren von Daten im Azure Cache für Redis.

Um eine Liste der verfügbaren Parameter und ihrer Beschreibungen für Import-AzRedisCacheanzuzeigen, führen Sie den folgenden Befehl aus.

Get-Help Import-AzRedisCache -detailed

Der folgende Befehl importiert Daten aus dem durch den Files Parameter angegebenen Blob in Azure Cache für Redis.

Import-AzRedisCache -ResourceGroupName "resourceGroupName" -Name "cacheName" -Files @("https://mystorageaccount.blob.core.windows.net/mycontainername/blobname?sv=signedVersion&sr=signedResource&sig=signature&st=signTime&se=signedExpiry&sp=signedPermissions") -Force

Exportieren der Azure Cache for Redis-Cachedaten

Sie können mit dem Cmdlet Export-AzRedisCache Daten aus einer Azure Cache for Redis-Instanz exportieren.

Von Bedeutung

Der Export ist nur für Premium-Caches verfügbar. Weitere Informationen finden Sie unter Importieren und Exportieren von Daten im Azure Cache für Redis.

Um eine Liste der verfügbaren Parameter und ihrer Beschreibungen für Export-AzRedisCacheanzuzeigen, führen Sie den folgenden Befehl aus.

Get-Help Export-AzRedisCache -detailed

Mit dem folgenden Befehl werden Daten aus einem Azure Cache für Redis-Instanz in den durch den Container Parameter angegebenen Container exportiert.

Export-AzRedisCache -ResourceGroupName "resourceGroupName" -Name "cacheName" -Prefix "blobprefix" -Container "https://mystorageaccount.blob.core.windows.net/mycontainer?sv=signedResource&sig=signature&st=signTime&se=signedExpiry&sp=signedPermissions"

Neustart eines Azure Cache for Redis-Cache

Sie können mit dem Cmdlet Reset-AzRedisCache Ihre Azure Cache for Redis-Instanz neu starten.

Von Bedeutung

Neustarts sind nur für Azure Cache for Redis-Caches der Dienstebenen Basic, Standard und Premium verfügbar. Weitere Informationen finden Sie unter Cacheverwaltung – Neustart.

Um eine Liste der verfügbaren Parameter und ihrer Beschreibungen für Reset-AzRedisCacheanzuzeigen, führen Sie den folgenden Befehl aus.

Get-Help Reset-AzRedisCache -detailed

Der folgende Befehl startet beide Knoten des angegebenen Cache neu.

Reset-AzRedisCache -ResourceGroupName "resourceGroupName" -Name "cacheName" -RebootType "AllNodes" -Force

Allgemeine Azure PowerShell-Befehle

Führen Sie diese Befehle an der Azure PowerShell-Eingabeaufforderung aus.

Überprüfen Sie die Azure PowerShell-Version:

Get-Module Az | format-table version

Melden Sie sich bei Azure an:

Connect-AzAccount

Eine Liste Ihrer aktuellen Abonnements anzeigen:

Get-AzSubscription | sort SubscriptionName | Select SubscriptionName

Geben Sie ein azure-Abonnement an, das verwendet werden soll:

Select-AzSubscription -SubscriptionName ContosoSubscription

Erhalten Sie detaillierte Hilfe zu jedem Cmdlet:

Get-Help <cmdlet-name> -Detailed

Herstellen von Verbindungen mit anderen Clouds

Standardmäßig ist AzureClouddie Azure-Umgebung , die die globale Azure-Cloud darstellt. Verwenden Sie zum Verbinden mit einer anderen Cloudinstanz den Connect-AzAccount-Befehl mit dem Befehlszeilenschalter -Environment oder -EnvironmentName mit der gewünschten Umgebung bzw. dem gewünschten Umgebungsnamen.

Um die Liste der verfügbaren Umgebungen anzuzeigen, führen Sie Get-AzEnvironment aus.

Azure Government Cloud

Verwenden Sie zum Verbinden mit der Azure Government-Cloud
Connect-AzAccount -EnvironmentName AzureUSGovernment
Oder
Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureUSGovernment)

Um einen Cache in der Azure Government Cloud zu erstellen, verwenden Sie die Speicherorte USGov Virginia oder USGov Iowa.

Weitere Informationen zur Azure Government-Cloud finden Sie unter Microsoft Azure Government und im Microsoft Azure Government-Entwicklerhandbuch.

Azure, betrieben von 21Vianet

Um eine Verbindung mit der von 21Vianet (China)-Cloud betriebenen Azure herzustellen, verwenden Sie
Connect-AzAccount -EnvironmentName AzureChinaCloud
Oder
Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureChinaCloud)

Um einen Cache in Azure zu erstellen, die von 21Vianet betrieben wird, verwenden Sie die China East oder China North Speicherorte.

Microsoft Azure Deutschland

Verwenden Sie zum Verbinden mit Microsoft Azure Deutschland
Connect-AzAccount -EnvironmentName AzureGermanCloud
Oder
Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureGermanCloud)

Verwenden Sie zum Erstellen eines Caches in Microsoft Azure Deutschland die Speicherorte Germany Central oder Germany Northeast.

Weitere Informationen zu Microsoft Azure Deutschland finden Sie unter Microsoft Azure Deutschland.

Verwandte Inhalte