Verwalten von Azure Redis mit Azure PowerShell

Artikel
11/19/2024

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.
Wählen Sie auf der Seite Neu die Option Datenbanken und dann Azure Cache for Redis aus.

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 Ebene.

Screenshot: Registerkarte „Grundlagen“ in Azure Managed Redis

Wählen Sie Weiter: Netzwerk aus, um einen öffentlichen oder privaten Endpunkt auszuwählen.
Klicken Sie auf Weiter: Erweitert. Hier können Sie ein beliebiges Redis-Modul konfigurieren, das der Instanz hinzugefügt werden soll.

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 von Aktive Georeplikation muss sie während der Erstellung konfiguriert werden. Anweisungen hierzu 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 NoEviction wird 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 $PSVersionTable ein. Vergewissern Sie sich, dass der Wert von PSVersion 3.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

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.

    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 $PSVersionTable ein. Vergewissern Sie sich, dass der Wert von PSVersion 3.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

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.

Freigeben über

Verwalten von Azure Redis mit Azure PowerShell

Azure Managed Redis

Azure Cache for Redis

Voraussetzungen

Herstellen von Verbindungen mit anderen Clouds

Verbinden mit der Azure Government-Cloud

So stellen Sie eine Verbindung her mit der Microsoft Azure-Cloud, betrieben von 21Vianet

So stellen Sie eine Verbindung mit Microsoft Azure Deutschland her

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

So erstellen Sie eine Azure Managed Redis-Instanz

So konfigurieren Sie die Einstellung für Datenbanken während der Erstellung des Caches

So aktualisieren Sie eine Azure Managed Redis-Instanz

So rufen Sie weitere Informationen zur Azure Managed Redis-Instanz ab

So rufen Sie die Zugriffsschlüssel für eine Azure Managed Redis-Instanz ab

So generieren Sie Zugriffsschlüssel für Ihre Azure Managed Redis-Instanz erneut

So löschen Sie eine Azure Managed Redis-Instanz

So importieren Sie eine Azure Managed Redis-Instanz

So exportieren Sie eine Azure Managed Redis-Instanz

So starten Sie eine Azure Managed Redis-Instanz (Vorschau) neu

Voraussetzungen

Herstellen von Verbindungen mit anderen Clouds

Verbinden mit der Azure Government-Cloud

So stellen Sie eine Verbindung her mit der Microsoft Azure-Cloud, betrieben von 21Vianet

So stellen Sie eine Verbindung mit Microsoft Azure Deutschland her

Eigenschaften, die für Azure Cache for Redis-PowerShell verwendet werden

RedisConfiguration-Eigenschaften

So erstellen Sie einen Azure Cache for Redis

So konfigurieren Sie die Einstellung für Datenbanken während der Erstellung des Caches

So aktualisieren Sie einen Azure Cache for Redis

So skalieren Sie einen Azure Cache for Redis

So erhalten Sie weitere Informationen zum Azure Cache for Redis

So rufen Sie die Zugriffsschlüssel für einen Azure Cache for Redis ab

So generieren Sie Zugriffsschlüssel für Ihren Azure Cache for Redis neu

So löschen Sie einen Azure Cache for Redis

So importieren Sie einen Azure Cache for Redis

So exportieren Sie einen Azure Cache for Redis

So starten Sie einen Azure Cache for Redis neu

Nächste Schritte

Feedback

Zusätzliche Ressourcen