Freigeben über

Verwalten von Azure Cache for Redis mit Azure PowerShell

  • Artikel

In diesem Artikel wird das Erstellen, Aktualisieren und Skalieren von Azure Cache for Redis-Instanzen beschrieben. Außerdem erhalten Sie Informationen darüber, wie Sie Zugriffsschlüssel neu generieren und Informationen zu Ihren Caches anzeigen können. Eine vollständige Liste der Azure Cache for Redis-PowerShell-Cmdlets finden Sie unter Azure Cache for Redis-Cmdlets.

Hinweis

Azure verfügt über zwei verschiedene Bereitstellungsmodelle zum Erstellen und Verwenden von Ressourcen: Azure Resource Manager-Bereitstellung und klassische Bereitstellung. In diesem Artikel wird die Verwendung des Resource Manager-Bereitstellungsmodells beschrieben. Es wird empfohlen, für neue Bereitstellungen anstelle des klassischen Bereitstellungsmodells das Resource Manager-Bereitstellungsmodell zu verwenden.

Weitere Informationen über das klassische Bereitstellungsmodell finden Sie unter Azure Resource Manager-Bereitstellung im Vergleich zur klassischen Bereitstellung: Grundlegendes zu Bereitstellungsmodellen und zum Status von Ressourcen.

Voraussetzungen

Wenn Sie bereits Azure PowerShell installiert haben, benötigen Sie Version 1.0.0 oder höher. Sie können die Azure PowerShell-Version mit diesem Befehl über die Azure PowerShell-Eingabeaufforderung prüfen.

    Get-Module Az | format-table version

Zunächst müssen Sie sich mit dem folgenden Befehl bei Azure anmelden.

    Connect-AzAccount

Geben Sie die E-Mail-Adresse Ihres Azure-Kontos und Ihr Kennwort in das Anmeldedialogfeld von Microsoft Azure ein.

Wenn Sie über mehrere Azure-Abonnements verfügen, müssen Sie als Nächstes Ihr Azure-Abonnement festlegen. Führen Sie den folgenden Befehl aus, um eine Liste Ihrer aktuellen Abonnements anzuzeigen.

    Get-AzSubscription | sort SubscriptionName | Select SubscriptionName

Führen Sie den folgenden Befehl aus, um das Abonnement anzugeben. Im folgenden Beispiel ist der Name des Abonnements ContosoSubscription.

    Select-AzSubscription -SubscriptionName ContosoSubscription

Bevor Sie Windows PowerShell mit dem Azure Resource Manager verwenden können, müssen Sie Ihre Einstellungen verifizieren:

  • Windows PowerShell, Version 3.0 oder 4.0. Um die Version von Windows PowerShell zu ermitteln, geben Sie $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

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

Führen Sie zum Anzeigen der Liste der verfügbaren Umgebungen das Cmdlet Get-AzEnvironment aus.

Verbinden mit der Azure Government-Cloud

Verwenden Sie zum Verbinden mit der Azure Government-Cloud einen der folgenden Befehle.

    Connect-AzAccount -EnvironmentName AzureUSGovernment

oder

    Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureUSGovernment)

Verwenden Sie zum Erstellen eines Caches in der Azure Government-Cloud einen der folgenden Standorte.

  • US Government, Virginia
  • US Government, Iowa

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

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

Verwenden Sie einen der folgenden Befehle zum Verbinden mit der Azure-Cloud, betrieben von 21Vianet.

    Connect-AzAccount -EnvironmentName AzureChinaCloud

Oder

    Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureChinaCloud)

Verwenden Sie einen der folgenden Speicherorte zum Erstellen eines Caches in der Azure-Cloud, betrieben von 21Vianet.

  • China, Osten
  • China, Norden

So stellen Sie eine Verbindung mit Microsoft Azure Deutschland her

Verwenden Sie zum Herstellen einer Verbindung mit Microsoft Azure Deutschland einen der folgenden Befehle.

    Connect-AzAccount -EnvironmentName AzureGermanCloud

oder

    Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureGermanCloud)

Verwenden Sie einen der folgenden Orte, um einen Cache in Microsoft Azure Deutschland zu erstellen.

  • Deutschland, Mitte
  • Deutschland, Nordosten

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

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

Die folgende Tabelle enthält Eigenschaften und Beschreibungen von Azure PowerShell für Parameter, die beim Erstellen und Verwalten Ihrer Azure Cache for Redis-Instanzen häufig verwendet werden.

Parameter BESCHREIBUNG Standard
Name Name des Caches
Location Ort des Caches
ResourceGroupName Name der Ressourcengruppe, in der der Cache erstellt werden soll
Size Die Größe des Caches. Gültige Werte sind: P1, P2, P3, P4, P5, C0, C1, C2, C3, C4, C5, C6, 250 MB, 1 GB, 2,5 GB, 6 GB, 13 GB, 26 GB, 53 GB 1 GB
ShardCount Die Anzahl der zu erstellenden Shards beim Erstellen eines Premium-Caches mit Clusterunterstützung. Gültige Werte sind: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10
SKU Gibt die SKU des Caches an. Gültige Werte sind: Basic, Standard, Premium Standard
RedisConfiguration Gibt die Konfigurationseinstellungen für Redis an. Details zu den einzelnen Einstellungen finden Sie in der Tabelle RedisConfiguration-Eigenschaften .
EnableNonSslPort Gibt an, ob der Nicht-SSL-Port aktiviert ist. False
MaxMemoryPolicy Dieser Parameter ist veraltet – verwenden Sie stattdessen RedisConfiguration.
StaticIP Wenn Sie den Cache in einem VNET hosten, geben Sie hiermit eine eindeutige IP-Adresse im Subnetz für den Cache an. Wird keine IP-Adresse angegeben, wird eine für Sie aus dem Subnetz ausgewählt.
Subnet Wenn Sie den Cache in einem VNET hosten, geben Sie hiermit den Namen des Subnetzes an, in dem der Cache bereitgestellt wird.
VirtualNetwork Wenn Sie den Cache in einem VNET hosten, geben Sie hiermit die Ressourcen-ID des VNET an, in dem der Cache bereitgestellt wird.
KeyType Gibt an, welcher Zugriffsschlüssel beim Erneuern der Zugriffsschlüssel neu generiert werden muss. Gültige Werte sind: Primary, Secondary

RedisConfiguration-Eigenschaften

Eigenschaft BESCHREIBUNG Tarife
rdb-backup-enabled Gibt an, ob Redis-Datenpersistenz aktiviert ist Nur Premium
rdb-storage-connection-string Die Verbindungszeichenfolge für das Speicherkonto für Redis-Datenpersistenz Nur Premium
rdb-backup-frequency Die Sicherungshäufigkeit für Redis-Datenpersistenz Nur Premium
maxmemory-reserved Konfiguriert den für andere Prozesse als Cacheprozesse reservierten Speicher Standard und Premium
maxmemory-policy Konfiguriert die Entfernungsrichtlinie für den Cache Alle Tarife
notify-keyspace-events Konfiguriert die Keyspace-Benachrichtigungen Standard und Premium
hash-max-ziplist-entries Konfiguriert die Speicheroptimierung für kleine Aggregatdatentypen Standard und Premium
hash-max-ziplist-value Konfiguriert die Speicheroptimierung für kleine Aggregatdatentypen Standard und Premium
set-max-intset-entries Konfiguriert die Speicheroptimierung für kleine Aggregatdatentypen Standard und Premium
zset-max-ziplist-entries Konfiguriert die Speicheroptimierung für kleine Aggregatdatentypen Standard und Premium
zset-max-ziplist-value Konfiguriert die Speicheroptimierung für kleine Aggregatdatentypen Standard und Premium
databases Konfiguriert die Anzahl der Datenbanken. Diese Eigenschaft kann nur bei der Erstellung des Caches konfiguriert werden. Standard und Premium

So erstellen Sie einen Azure Cache for Redis

Neue Azure Cache for Redis-Instanzen werden mit dem New-AzRedisCache-Cmdlet erstellt.

Wichtig

Beim ersten Erstellen eines Azure Cache for Redis in einem Abonnement mithilfe des Azure-Portals registriert das Portal den Microsoft.Cache-Namespace für dieses Abonnement. Wenn Sie versuchen, den ersten Azure Cache for Redis in einem Abonnement mithilfe von PowerShell zu erstellen, müssen Sie zunächst diesen Namespace mit dem folgenden Befehl registrieren; andernfalls tritt beim Ausführen von Cmdlets wie New-AzRedisCache und Get-AzRedisCache ein Fehler auf.

Register-AzResourceProvider -ProviderNamespace "Microsoft.Cache"

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

    PS C:\> Get-Help New-AzRedisCache -detailed

    NAME
        New-AzRedisCache

    SYNOPSIS
        Creates a new Azure Cache for Redis.


    SYNTAX
        New-AzRedisCache -Name <String> -ResourceGroupName <String> -Location <String> [-RedisVersion <String>]
        [-Size <String>] [-Sku <String>] [-MaxMemoryPolicy <String>] [-RedisConfiguration <Hashtable>] [-EnableNonSslPort
        <Boolean>] [-ShardCount <Integer>] [-VirtualNetwork <String>] [-Subnet <String>] [-StaticIP <String>]
        [<CommonParameters>]


    DESCRIPTION
        The New-AzRedisCache cmdlet creates a new Azure Cache for Redis.


    PARAMETERS
        -Name <String>
            Name of the Azure Cache for Redis to create.

        -ResourceGroupName <String>
            Name of resource group in which to create the Azure Cache for Redis.

        -Location <String>
            Location in which to create the Azure Cache for Redis.

        -RedisVersion <String>
            RedisVersion is deprecated and will be removed in future release.

        -Size <String>
            Size of the Azure Cache for Redis. The default value is 1GB or C1. Possible values are P1, P2, P3, P4, C0, C1, C2, C3,
            C4, C5, C6, 250MB, 1GB, 2.5GB, 6GB, 13GB, 26GB, 53GB.

        -Sku <String>
            Sku of Azure Cache for Redis. The default value is Standard. Possible values are Basic, Standard and Premium.

        -MaxMemoryPolicy <String>
            The 'MaxMemoryPolicy' setting has been deprecated. Please use 'RedisConfiguration' setting to set
            MaxMemoryPolicy. e.g. -RedisConfiguration @{"maxmemory-policy" = "allkeys-lru"}

        -RedisConfiguration <Hashtable>
            All Redis Configuration Settings. Few possible keys: rdb-backup-enabled, rdb-storage-connection-string,
            rdb-backup-frequency, maxmemory-reserved, maxmemory-policy, notify-keyspace-events, hash-max-ziplist-entries,
            hash-max-ziplist-value, set-max-intset-entries, zset-max-ziplist-entries, zset-max-ziplist-value, databases.

        -EnableNonSslPort <Boolean>
            EnableNonSslPort is used by Azure Cache for Redis. If no value is provided, the default value is false and the
            non-SSL port will be disabled. Possible values are true and false.

        -ShardCount <Integer>
            The number of shards to create on a Premium Cluster Cache.

        -VirtualNetwork <String>
            The exact ARM resource ID of the virtual network to deploy the Azure Cache for Redis in. Example format: /subscriptions/{
            subid}/resourceGroups/{resourceGroupName}/providers/Microsoft.ClassicNetwork/VirtualNetworks/{vnetName}

        -Subnet <String>
            Required when deploying an Azure Cache for Redis inside an existing Azure Virtual Network.

        -StaticIP <String>
            Required when deploying an Azure Cache for Redis inside an existing Azure Virtual Network.

        <CommonParameters>
            This cmdlet supports the common parameters: Verbose, Debug,
            ErrorAction, ErrorVariable, WarningAction, WarningVariable,
            OutBuffer, PipelineVariable, and OutVariable. For more information, see
            about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Um einen Cache mit Standardparametern zu erstellen, führen Sie den folgenden Befehl aus.

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

ResourceGroupName, Name und Location sind erforderliche Parameter, aber die übrigen sind optional und haben Standardwerte. Mit dem vorherigen Befehl erstellen Sie eine Standard-SKU-Azure Cache for Redis-Instanz mit Name, Speicherort und Ressourcengruppe gemäß der entsprechenden Angaben. Die Instanz hat eine Größe von 1 GB, wobei der Nicht-SSL-Port deaktiviert ist.

Um einen Premium-Cache zu erstellen, geben Sie eine Größe von P1 (6 bis 60 GB), P2 (13 bis 130 GB), P3 (26 bis 260 GB), oder P4 (53 bis 530 GB) ein. Um Clustering zu aktivieren, geben Sie eine Shardanzahl mit dem Parameter ShardCount ein. Das folgende Beispiel erstellt einen P1-Premium-Cache mit drei Shards. Ein P1-Premium-Cache ist 6 GB groß, und da wir drei Shards angegeben haben, beträgt die Gesamtgröße 18 GB (3 x 6 GB).

    New-AzRedisCache -ResourceGroupName myGroup -Name mycache -Location "North Central US" -Sku Premium -Size P1 -ShardCount 3

Um Werte für die RedisConfiguration-Parameter anzugeben, schließen Sie die Werte als Schlüssel-Wert-Paare in {} ein (Beispiel: @{"maxmemory-policy" = "allkeys-random", "notify-keyspace-events" = "KEA"}). Im folgenden Beispiel wird ein standardmäßiger 1 GB-Cache mit allkeys-random-maxmemory-Richtlinie und mit KEA konfigurierten Keyspace-Benachrichtigungen erstellt. Weitere Informationen finden Sie unter Keyspacebenachrichtigungen (Erweiterte Einstellungen) und Arbeitsspeicherrichtlinien.

    New-AzRedisCache -ResourceGroupName myGroup -Name mycache -Location "North Central US" -RedisConfiguration @{"maxmemory-policy" = "allkeys-random", "notify-keyspace-events" = "KEA"}

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

Die Einstellung databases kann nur während der Erstellung des Caches konfiguriert werden. Mit dem folgenden Beispiel wird ein Premium-P3-Cache (26 GB) mit 48 Datenbanken mit dem New-AzRedisCache-Cmdlet erstellt.

    New-AzRedisCache -ResourceGroupName myGroup -Name mycache -Location "North Central US" -Sku Premium -Size P3 -RedisConfiguration @{"databases" = "48"}

Weitere Informationen zur Eigenschaft databases finden Sie unter Standardmäßige Azure Cache for Redis-Serverkonfiguration. Weitere Informationen zum Erstellen eines Caches mithilfe des New-AzRedisCache-Cmdlets finden Sie im vorherigen Abschnitt „So erstellen Sie eine Azure Cache for Redis-Instanz“.

So aktualisieren Sie einen Azure Cache for Redis

Azure Cache for Redis-Instanzen werden mit dem New-AzRedisCache-Cmdlet aktualisiert.

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

    PS C:\> Get-Help Set-AzRedisCache -detailed

    NAME
        Set-AzRedisCache

    SYNOPSIS
        Set Azure Cache for Redis updatable parameters.

    SYNTAX
        Set-AzRedisCache -Name <String> -ResourceGroupName <String> [-Size <String>] [-Sku <String>]
        [-MaxMemoryPolicy <String>] [-RedisConfiguration <Hashtable>] [-EnableNonSslPort <Boolean>] [-ShardCount
        <Integer>] [<CommonParameters>]

    DESCRIPTION
        The Set-AzRedisCache cmdlet sets Azure Cache for Redis parameters.

    PARAMETERS
        -Name <String>
            Name of the Azure Cache for Redis to update.

        -ResourceGroupName <String>
            Name of the resource group for the cache.

        -Size <String>
            Size of the Azure Cache for Redis. The default value is 1GB or C1. Possible values are P1, P2, P3, P4, C0, C1, C2, C3,
            C4, C5, C6, 250MB, 1GB, 2.5GB, 6GB, 13GB, 26GB, 53GB.

        -Sku <String>
            Sku of Azure Cache for Redis. The default value is Standard. Possible values are Basic, Standard and Premium.

        -MaxMemoryPolicy <String>
            The 'MaxMemoryPolicy' setting has been deprecated. Please use 'RedisConfiguration' setting to set
            MaxMemoryPolicy. e.g. -RedisConfiguration @{"maxmemory-policy" = "allkeys-lru"}

        -RedisConfiguration <Hashtable>
            All Redis Configuration Settings. Few possible keys: rdb-backup-enabled, rdb-storage-connection-string,
            rdb-backup-frequency, maxmemory-reserved, maxmemory-policy, notify-keyspace-events, hash-max-ziplist-entries,
            hash-max-ziplist-value, set-max-intset-entries, zset-max-ziplist-entries, zset-max-ziplist-value.

        -EnableNonSslPort <Boolean>
            EnableNonSslPort is used by Azure Cache for Redis. The default value is null and no change will be made to the
            currently configured value. Possible values are true and false.

        -ShardCount <Integer>
            The number of shards to create on a Premium Cluster Cache.

        <CommonParameters>
            This cmdlet supports the common parameters: Verbose, Debug,
            ErrorAction, ErrorVariable, WarningAction, WarningVariable,
            OutBuffer, PipelineVariable, and OutVariable. For more information, see
            about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Das Cmdlet Set-AzRedisCache kann verwendet werden, um Eigenschaften wie Size, Sku, EnableNonSslPort und die RedisConfiguration-Werte zu aktualisieren.

Der folgende Befehl aktualisiert die maxmemory-Richtlinie für den Azure Cache for Redis mit dem Namen „myCache“.

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

So skalieren Sie einen Azure Cache for Redis

Set-AzRedisCache kann verwendet werden, um eine Azure Cache for Redis-Instanz zu skalieren, wenn die Eigenschaften Size, Sku oder ShardCount geändert werden.

Hinweis

Das Skalieren eines Caches mithilfe von PowerShell unterliegt den gleichen Einschränkungen und Richtlinien wie das Skalieren eines Caches über das Azure-Portal. Sie können mit den folgenden Einschränkungen auf eine andere Preisstufe skalieren.

  • Sie können keine Skalierung von einem höheren Tarif auf einen niedrigeren Tarif vornehmen.
  • Eine Skalierung von einem Premium-Cache auf einen niedrigeren Standard- oder Basic-Cache ist nicht möglich.
  • Ein Standard-Cache kann nicht auf einen niedrigeren Basic-Cache skaliert werden.
  • Ein Basic-Cache kann auf einen Standard-Cache skaliert werden, die Größe kann jedoch nicht gleichzeitig geändert werden. Wenn Sie eine andere Größe benötigen, können Sie anschließend einen Skalierungsvorgang auf die gewünschte Größe durchführen.
  • Ein Basic-Cache kann nicht direkt auf einen Premium-Cache skaliert werden. Stattdessen müssen Sie in einem ersten Skalierungsvorgang von Basic auf Standard skalieren und dann in einem anschließenden Skalierungsvorgang von Standard auf Premium.
  • Von einer größeren Größe kann nicht auf C0 (250 MB) herunterskaliert werden.

Weitere Informationen finden Sie unter Skalieren von Azure Cache for Redis.

Das folgende Beispiel veranschaulicht, wie ein Cache mit Namen myCache zu einem 2,5-GB-Cache skaliert wird. Dieser Befehl kann sowohl für einen Basic- als auch für einen Standard-Cache verwendet werden.

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

Nach Eingabe dieses Befehls wird der Status des Caches zurückgegeben (ähnlich wie beim Aufruf von Get-AzRedisCache). ProvisioningState wird auf Scaling festgelegt.

    PS C:\> Set-AzRedisCache -Name myCache -ResourceGroupName myGroup -Size 2.5GB


    Name               : mycache
    Id                 : /subscriptions/12ad12bd-abdc-2231-a2ed-a2b8b246bbad4/resourceGroups/mygroup/providers/Mi
                         crosoft.Cache/Redis/mycache
    Location           : South Central US
    Type               : Microsoft.Cache/Redis
    HostName           : mycache.redis.cache.windows.net
    Port               : 6379
    ProvisioningState  : Scaling
    SslPort            : 6380
    RedisConfiguration : {[maxmemory-policy, volatile-lru], [maxmemory-reserved, 150], [notify-keyspace-events, KEA],
                         [maxmemory-delta, 150]...}
    EnableNonSslPort   : False
    RedisVersion       : 3.0
    Size               : 1GB
    Sku                : Standard
    ResourceGroupName  : mygroup
    PrimaryKey         : ....
    SecondaryKey       : ....
    VirtualNetwork     :
    Subnet             :
    StaticIP           :
    TenantSettings     : {}
    ShardCount         :

Nach Abschluss des Skalierungsvorgangs ändert sich ProvisioningState in Succeeded. Wenn Sie weitere Skalierungen vornehmen möchten (z. B. einen Wechsel von Basic zu Standard oder eine Änderung der Größe), müssen Sie warten, bis der vorherige Vorgang abgeschlossen ist. Andernfalls wird eine Fehlermeldung wie die folgende angezeigt.

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

So erhalten Sie weitere Informationen zum Azure Cache for Redis

Sie können Informationen zu einem Cache mithilfe des Get-AzRedisCache-Cmdlets abrufen.

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

    PS C:\> Get-Help Get-AzRedisCache -detailed

    NAME
        Get-AzRedisCache

    SYNOPSIS
        Gets details about a single cache or all caches in the specified resource group or all caches in the current
        subscription.

    SYNTAX
        Get-AzRedisCache [-Name <String>] [-ResourceGroupName <String>] [<CommonParameters>]

    DESCRIPTION
        The Get-AzRedisCache cmdlet gets the details about a cache or caches depending on input parameters. If both
        ResourceGroupName and Name parameters are provided then Get-AzRedisCache will return details about the
        specific cache name provided.

        If only ResourceGroupName is provided than it will return details about all caches in the specified resource group.

        If no parameters are given than it will return details about all caches the current subscription.

    PARAMETERS
        -Name <String>
            The name of the cache. When this parameter is provided along with ResourceGroupName, Get-AzRedisCache
            returns the details for the cache.

        -ResourceGroupName <String>
            The name of the resource group that contains the cache or caches. If ResourceGroupName is provided with Name
            then Get-AzRedisCache returns the details of the cache specified by Name. If only the ResourceGroup
            parameter is provided, then details for all caches in the resource group are returned.

        <CommonParameters>
            This cmdlet supports the common parameters: Verbose, Debug,
            ErrorAction, ErrorVariable, WarningAction, WarningVariable,
            OutBuffer, PipelineVariable, and OutVariable. For more information, see
            about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Um Informationen über alle Caches im aktuellen Abonnement zurückzugeben, führen Sie Get-AzRedisCache ohne Parameter aus.

    Get-AzRedisCache

Um Informationen über alle Caches in einer bestimmten Ressourcengruppe zurückzugeben, führen Sie Get-AzRedisCache mit dem ResourceGroupName-Parameter aus.

    Get-AzRedisCache -ResourceGroupName myGroup

Um Informationen zu einem bestimmten Cache zurückzugeben, führen Sie Get-AzRedisCache mit dem Name-Parameter aus, der den Namen des Caches enthält, und den ResourceGroupName-Parameter mit der Ressourcengruppe, die diesen Cache enthält.

    PS C:\> Get-AzRedisCache -Name myCache -ResourceGroupName myGroup

    Name               : mycache
    Id                 : /subscriptions/12ad12bd-abdc-2231-a2ed-a2b8b246bbad4/resourceGroups/myGroup/providers/Mi
                         crosoft.Cache/Redis/mycache
    Location           : South Central US
    Type               : Microsoft.Cache/Redis
    HostName           : mycache.redis.cache.windows.net
    Port               : 6379
    ProvisioningState  : Succeeded
    SslPort            : 6380
    RedisConfiguration : {[maxmemory-policy, volatile-lru], [maxmemory-reserved, 62], [notify-keyspace-events, KEA],
                         [maxclients, 1000]...}
    EnableNonSslPort   : False
    RedisVersion       : 3.0
    Size               : 1GB
    Sku                : Standard
    ResourceGroupName  : myGroup
    VirtualNetwork     :
    Subnet             :
    StaticIP           :
    TenantSettings     : {}
    ShardCount         :

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

Um die Zugriffsschlüssel für Ihren Cache abzurufen, können Sie das New-AzRedisCache-Cmdlet verwenden.

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

    PS C:\> Get-Help Get-AzRedisCacheKey -detailed

    NAME
        Get-AzRedisCacheKey

    SYNOPSIS
        Gets the accesskeys for the specified Azure Cache for Redis.


    SYNTAX
        Get-AzRedisCacheKey -Name <String> -ResourceGroupName <String> [<CommonParameters>]

    DESCRIPTION
        The Get-AzRedisCacheKey cmdlet gets the access keys for the specified cache.

    PARAMETERS
        -Name <String>
            Name of the Azure Cache for Redis.

        -ResourceGroupName <String>
            Name of the resource group for the cache.

        <CommonParameters>
            This cmdlet supports the common parameters: Verbose, Debug,
            ErrorAction, ErrorVariable, WarningAction, WarningVariable,
            OutBuffer, PipelineVariable, and OutVariable. For more information, see
            about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Um die Schlüssel für Ihren Cache abzurufen, rufen Sie das Get-AzRedisCacheKey -Cmdlet auf und übergeben Sie im Namen Ihres Caches den Namen der Ressourcengruppe, die den Cache enthält.

    PS C:\> Get-AzRedisCacheKey -Name myCache -ResourceGroupName myGroup

    PrimaryKey   : b2wdt43sfetlju4hfbryfnregrd9wgIcc6IA3zAO1lY=
    SecondaryKey : ABhfB757JgjIgt785JgKH9865eifmekfnn649303JKL=

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

Um die Zugriffsschlüssel für Ihren Cache abzurufen, können Sie das New-AzRedisCache-Cmdlet verwenden.

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

    PS C:\> Get-Help New-AzRedisCacheKey -detailed

    NAME
        New-AzRedisCacheKey

    SYNOPSIS
        Regenerates the access key of an Azure Cache for Redis.

    SYNTAX
        New-AzRedisCacheKey -Name <String> -ResourceGroupName <String> -KeyType <String> [-Force] [<CommonParameters>]

    DESCRIPTION
        The New-AzRedisCacheKey cmdlet regenerate the access key of an Azure Cache for Redis.

    PARAMETERS
        -Name <String>
            Name of the Azure Cache for Redis.

        -ResourceGroupName <String>
            Name of the resource group for the cache.

        -KeyType <String>
            Specifies whether to regenerate the primary or secondary access key. Possible values are Primary or Secondary.

        -Force
            When the Force parameter is provided, the specified access key is regenerated without any confirmation prompts.

        <CommonParameters>
            This cmdlet supports the common parameters: Verbose, Debug,
            ErrorAction, ErrorVariable, WarningAction, WarningVariable,
            OutBuffer, PipelineVariable, and OutVariable. For more information, see
            about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Um den primären oder sekundären Schlüssel für Ihren Cache erneut zu generieren, rufen Sie das New-AzRedisCacheKey-Cmdlet auf und übergeben Sie den Namen und die Ressourcengruppe. Geben Sie entweder Primary oder Secondary für den KeyType-Parameter an. Im folgenden Beispiel wird der sekundäre Zugriffsschlüssel für einen Cache erneut generiert.

    PS C:\> New-AzRedisCacheKey -Name myCache -ResourceGroupName myGroup -KeyType Secondary

    Confirm
    Are you sure you want to regenerate Secondary key for Azure Cache for Redis 'myCache'?
    [Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"): Y


    PrimaryKey   : b2wdt43sfetlju4hfbryfnregrd9wgIcc6IA3zAO1lY=
    SecondaryKey : c53hj3kh4jhHjPJk8l0jji785JgKH9865eifmekfnn6=

So löschen Sie einen Azure Cache for Redis

Um einen Azure Cache for Redis zu löschen, verwenden Sie das Remove-AzRedisCache-Cmdlet.

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

    PS C:\> Get-Help Remove-AzRedisCache -detailed

    NAME
        Remove-AzRedisCache

    SYNOPSIS
        Remove Azure Cache for Redis if exists.

    SYNTAX
        Remove-AzRedisCache -Name <String> -ResourceGroupName <String> [-Force] [-PassThru] [<CommonParameters>

    DESCRIPTION
        The Remove-AzRedisCache cmdlet removes an Azure Cache for Redis if it exists.

    PARAMETERS
        -Name <String>
            Name of the Azure Cache for Redis to remove.

        -ResourceGroupName <String>
            Name of the resource group of the cache to remove.

        -Force
            When the Force parameter is provided, the cache is removed without any confirmation prompts.

        -PassThru
            By default Remove-AzRedisCache removes the cache and does not return any value. If the PassThru par
            is provided then Remove-AzRedisCache returns a boolean value indicating the success of the operatio

        <CommonParameters>
            This cmdlet supports the common parameters: Verbose, Debug,
            ErrorAction, ErrorVariable, WarningAction, WarningVariable,
            OutBuffer, PipelineVariable, and OutVariable. For more information, see
            about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

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

    PS C:\> Remove-AzRedisCache -Name myCache -ResourceGroupName myGroup

    Confirm
    Are you sure you want to remove Azure Cache for Redis 'myCache'?
    [Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"): Y

So importieren Sie einen Azure Cache for Redis

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

Wichtig

Import/Export ist nur für Caches im Premium-Tarif verfügbar. Weitere Informationen zum Importieren/Exportieren finden Sie unter Importieren und Exportieren von Daten in Azure Cache for Redis.

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

    PS C:\> Get-Help Import-AzRedisCache -detailed

    NAME
        Import-AzRedisCache

    SYNOPSIS
        Import data from blobs to Azure Cache for Redis.


    SYNTAX
        Import-AzRedisCache -Name <String> -ResourceGroupName <String> -Files <String[]> [-Format <String>] [-Force]
        [-PassThru] [<CommonParameters>]


    DESCRIPTION
        The Import-AzRedisCache cmdlet imports data from the specified blobs into Azure Cache for Redis.


    PARAMETERS
        -Name <String>
            The name of the cache.

        -ResourceGroupName <String>
            The name of the resource group that contains the cache.

        -Files <String[]>
            SAS urls of blobs whose content should be imported into the cache.

        -Format <String>
            Format for the blob.  Currently "rdb" is the only supported, with other formats expected in the future.

        -Force
            When the Force parameter is provided, import will be performed without any confirmation prompts.

        -PassThru
            By default Import-AzRedisCache imports data in cache and does not return any value. If the PassThru
            parameter is provided then Import-AzRedisCache returns a boolean value indicating the success of the
            operation.

        <CommonParameters>
            This cmdlet supports the common parameters: Verbose, Debug,
            ErrorAction, ErrorVariable, WarningAction, WarningVariable,
            OutBuffer, PipelineVariable, and OutVariable. For more information, see
            about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Der folgende Befehl importiert Daten aus dem vom SAS-URI angegebenen Blob in Azure Cache for Redis.

    PS C:\>Import-AzRedisCache -ResourceGroupName "resourceGroupName" -Name "cacheName" -Files @("https://mystorageaccount.blob.core.windows.net/mycontainername/blobname?sv=2015-04-05&sr=b&sig=caIwutG2uDa0NZ8mjdNJdgOY8%2F8mhwRuGNdICU%2B0pI4%3D&st=2016-05-27T00%3A00%3A00Z&se=2016-05-28T00%3A00%3A00Z&sp=rwd") -Force

So exportieren Sie einen Azure Cache for Redis

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

Wichtig

Import/Export ist nur für Caches im Premium-Tarif verfügbar. Weitere Informationen zum Importieren/Exportieren finden Sie unter Importieren und Exportieren von Daten in Azure Cache for Redis.

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

    PS C:\> Get-Help Export-AzRedisCache -detailed

    NAME
        Export-AzRedisCache

    SYNOPSIS
        Exports data from Azure Cache for Redis to a specified container.


    SYNTAX
        Export-AzRedisCache -Name <String> -ResourceGroupName <String> -Prefix <String> -Container <String> [-Format
        <String>] [-PassThru] [<CommonParameters>]


    DESCRIPTION
        The Export-AzRedisCache cmdlet exports data from Azure Cache for Redis to a specified container.


    PARAMETERS
        -Name <String>
            The name of the cache.

        -ResourceGroupName <String>
            The name of the resource group that contains the cache.

        -Prefix <String>
            Prefix to use for blob names.

        -Container <String>
            SAS url of container where data should be exported.

        -Format <String>
            Format for the blob.  Currently "rdb" is the only supported, with other formats expected in the future.

        -PassThru
            By default Export-AzRedisCache does not return any value. If the PassThru parameter is provided
            then Export-AzRedisCache returns a boolean value indicating the success of the operation.

        <CommonParameters>
            This cmdlet supports the common parameters: Verbose, Debug,
            ErrorAction, ErrorVariable, WarningAction, WarningVariable,
            OutBuffer, PipelineVariable, and OutVariable. For more information, see
            about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Der folgende Befehl exportiert Daten aus einer Azure Cache for Redis-Instanz in den vom SAS-URI angegebenen Container.

    PS C:\>Export-AzRedisCache -ResourceGroupName "resourceGroupName" -Name "cacheName" -Prefix "blobprefix"
    -Container "https://mystorageaccount.blob.core.windows.net/mycontainer?sv=2015-04-05&sr=c&sig=HezZtBZ3DURmEGDduauE7
    pvETY4kqlPI8JCNa8ATmaw%3D&st=2016-05-27T00%3A00%3A00Z&se=2016-05-28T00%3A00%3A00Z&sp=rwdl"

So starten Sie einen Azure Cache for Redis neu

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

Wichtig

Ein Neustart ist nur für Caches in den Tarifen Basic, Standard und Premium verfügbar. Weitere Informationen zum Neustarten Ihres Cache finden Sie unter Verwalten von Azure Redis Cache – Neustart.

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

    PS C:\> Get-Help Reset-AzRedisCache -detailed

    NAME
        Reset-AzRedisCache

    SYNOPSIS
        Reboot specified node(s) of an Azure Cache for Redis instance.


    SYNTAX
        Reset-AzRedisCache -Name <String> -ResourceGroupName <String> -RebootType <String> [-ShardId <Integer>]
        [-Force] [-PassThru] [<CommonParameters>]


    DESCRIPTION
        The Reset-AzRedisCache cmdlet reboots the specified node(s) of an Azure Cache for Redis instance.


    PARAMETERS
        -Name <String>
            The name of the cache.

        -ResourceGroupName <String>
            The name of the resource group that contains the cache.

        -RebootType <String>
            Which node to reboot. Possible values are "PrimaryNode", "SecondaryNode", "AllNodes".

        -ShardId <Integer>
            Which shard to reboot when rebooting a premium cache with clustering enabled.

        -Force
            When the Force parameter is provided, reset will be performed without any confirmation prompts.

        -PassThru
            By default Reset-AzRedisCache does not return any value. If the PassThru parameter is provided
            then Reset-AzRedisCache returns a boolean value indicating the success of the operation.

        <CommonParameters>
            This cmdlet supports the common parameters: Verbose, Debug,
            ErrorAction, ErrorVariable, WarningAction, WarningVariable,
            OutBuffer, PipelineVariable, and OutVariable. For more information, see
            about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Der folgende Befehl startet beide Knoten des angegebenen Cache neu.

    PS C:\>Reset-AzRedisCache -ResourceGroupName "resourceGroupName" -Name "cacheName" -RebootType "AllNodes"
    -Force

Nächste Schritte

Weitere Informationen zur Verwendung von Windows PowerShell mit Azure finden Sie in den folgenden Ressourcen: