Zarządzanie usługą Azure Cache for Redis przy użyciu programu Azure PowerShell

  • Artykuł

W tym artykule pokazano, jak tworzyć, aktualizować i skalować wystąpienia usługi Azure Cache for Redis. W tym artykule pokazano również, jak ponownie wygenerować klucze dostępu oraz jak wyświetlać informacje o pamięciach podręcznych. Aby uzyskać pełną listę poleceń cmdlet programu PowerShell usługi Azure Cache for Redis, zobacz Polecenia cmdlet usługi Azure Cache for Redis.

Uwaga

Platforma Azure ma dwa różne modele wdrażania, których można użyć do tworzenia zasobów i pracy z nimi: usługi Azure Resource Manager i klasycznej. W tym artykule opisano użycie modelu wdrażania przy użyciu usługi Resource Manager. Zalecamy model wdrażania przy użyciu usługi Resource Manager dla nowych wdrożeń zamiast klasycznego modelu wdrażania.

Aby uzyskać więcej informacji na temat klasycznego modelu wdrażania, zobacz Azure Resource Manager vs. wdrożenie klasyczne: Omówienie modeli wdrażania i stanu zasobów.

Wymagania wstępne

Jeśli masz już zainstalowany program Azure PowerShell, musisz mieć program Azure PowerShell w wersji 1.0.0 lub nowszej. Możesz sprawdzić wersję programu Azure PowerShell za pomocą tego polecenia w wierszu polecenia programu Azure PowerShell.

    Get-Module Az | format-table version

Najpierw musisz zalogować się do platformy Azure za pomocą tego polecenia.

    Connect-AzAccount

Określ adres e-mail konta platformy Azure i hasło w oknie dialogowym logowania platformy Microsoft Azure.

Następnie, jeśli masz wiele subskrypcji platformy Azure, musisz ustawić subskrypcję platformy Azure. Aby wyświetlić listę bieżących subskrypcji, uruchom to polecenie.

    Get-AzSubscription | sort SubscriptionName | Select SubscriptionName

Aby określić subskrypcję, uruchom następujące polecenie. W poniższym przykładzie nazwa subskrypcji to ContosoSubscription.

    Select-AzSubscription -SubscriptionName ContosoSubscription

Przed rozpoczęciem korzystania z programu Windows PowerShell z usługą Azure Resource Manager należy zweryfikować konfigurację:

  • Windows PowerShell, wersja 3.0 lub 4.0. Aby znaleźć wersję programu Windows PowerShell, wpisz:$PSVersionTable i sprawdź, czy wartość PSVersion to 3.0 lub 4.0. Aby zainstalować zgodną wersję, zobacz Windows Management Framework 3.0.

Aby uzyskać szczegółową pomoc dotyczącą dowolnego polecenia cmdlet widocznego w tym samouczku, użyj polecenia cmdlet Get-Help.

    Get-Help <cmdlet-name> -Detailed

Aby na przykład uzyskać pomoc dotyczącą New-AzRedisCache polecenia cmdlet, wpisz:

    Get-Help New-AzRedisCache -Detailed

Jak nawiązać połączenie z innymi chmurami

Domyślnie środowisko platformy Azure to AzureCloud, które reprezentuje globalne wystąpienie chmury platformy Azure. Aby nawiązać połączenie z innym wystąpieniem, użyj Connect-AzAccount polecenia z przełącznikiem -Environment wiersza polecenia lubEnvironmentName z odpowiednią nazwą środowiska lub środowiska.

Aby wyświetlić listę dostępnych środowisk, uruchom Get-AzEnvironment polecenie cmdlet .

Aby nawiązać połączenie z chmurą Azure Government

Aby nawiązać połączenie z chmurą Azure Government Cloud, użyj jednego z następujących poleceń.

    Connect-AzAccount -EnvironmentName AzureUSGovernment

Or

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

Aby utworzyć pamięć podręczną w chmurze Azure Government, użyj jednej z następujących lokalizacji.

  • USGov Wirginia
  • USGov Iowa

Aby uzyskać więcej informacji na temat chmury Azure Government, zobacz Microsoft Azure Government i Microsoft Azure Government Developer Guide (Przewodnik dla deweloperów platformy Microsoft Azure Government).

Aby nawiązać połączenie z platformą Microsoft Azure obsługiwaną przez firmę 21Vianet Cloud

Aby nawiązać połączenie z platformą Azure obsługiwaną przez chmurę 21Vianet, użyj jednego z następujących poleceń.

    Connect-AzAccount -EnvironmentName AzureChinaCloud

Or

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

Aby utworzyć pamięć podręczną na platformie Azure obsługiwanej przez usługę 21Vianet Cloud, użyj jednej z następujących lokalizacji.

  • Chiny Wschodnie
  • Chiny Północne

Aby nawiązać połączenie z platformą Microsoft Azure (Niemcy)

Aby nawiązać połączenie z platformą Microsoft Azure (Niemcy), użyj jednego z następujących poleceń.

    Connect-AzAccount -EnvironmentName AzureGermanCloud

Or

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

Aby utworzyć pamięć podręczną na platformie Microsoft Azure (Niemcy), użyj jednej z następujących lokalizacji.

  • Niemcy Środkowe
  • Niemcy Północno-Wschodnie

Aby uzyskać więcej informacji na temat platformy Microsoft Azure (Niemcy), zobacz Microsoft Azure (Niemcy).

Właściwości używane w usłudze Azure Cache for Redis PowerShell

Poniższa tabela zawiera właściwości i opisy programu Azure PowerShell dla typowych parametrów podczas tworzenia wystąpień usługi Azure Cache for Redis i zarządzania nimi.

Parametr Opis Wartość domyślna
Nazwisko Nazwa pamięci podręcznej
Lokalizacja Lokalizacja pamięci podręcznej
ResourceGroupName Nazwa grupy zasobów, w której ma zostać utworzona pamięć podręczna
Rozmiar Rozmiar pamięci podręcznej. Prawidłowe wartości to: P1, P2, P3, P4, P5, C0, C1, C2, C3, C4, C5, 6, 250 MB, 1 GB, 2,5 GB, 6 GB, 13 GB, 26 GB, 53 GB 1 GB
ShardCount Liczba fragmentów do utworzenia podczas tworzenia pamięci podręcznej w warstwie Premium z włączonym klastrowaniem. Prawidłowe wartości to: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10
SKU Określa jednostkę SKU pamięci podręcznej. Prawidłowe wartości to: Podstawowa, Standardowa, Premium Standardowa
RedisConfiguration Określa ustawienia konfiguracji usługi Redis. Aby uzyskać szczegółowe informacje na temat każdego ustawienia, zobacz następującą tabelę właściwości RedisConfiguration.
EnableNonSslPort Wskazuje, czy port inny niż SSL jest włączony. Fałsz
MaxMemoryPolicy Ten parametr został przestarzały — zamiast tego użyj polecenia RedisConfiguration.
StaticIP Podczas hostowania pamięci podręcznej w sieci wirtualnej określa unikatowy adres IP w podsieci pamięci podręcznej. Jeśli nie zostanie podana, zostanie wybrana jedna z podsieci.
Podsieć Podczas hostowania pamięci podręcznej w sieci wirtualnej określa nazwę podsieci, w której ma zostać wdrożona pamięć podręczna.
VirtualNetwork Podczas hostowania pamięci podręcznej w sieci wirtualnej określa identyfikator zasobu sieci wirtualnej, w której ma zostać wdrożona pamięć podręczna.
Keytype Określa, który klucz dostępu ma być ponownie wygenerowany podczas odnawiania kluczy dostępu. Prawidłowe wartości to: Podstawowa, Pomocnicza

Właściwości redisConfiguration

Właściwości opis Warstwy cenowe
Obsługa kopii zapasowej bazy danych rdb Czy włączono trwałość danych usługi Redis Tylko wersja Premium
rdb-storage-connection-string Parametry połączenia do konta magazynu dla trwałości danych usługi Redis Tylko wersja Premium
rdb-backup-frequency Częstotliwość tworzenia kopii zapasowych dla trwałości danych usługi Redis Tylko wersja Premium
maxmemory-reserved Konfiguruje pamięć zarezerwowaną dla procesów innych niż pamięć podręczna Standardowa i Premium
maxmemory-policy Konfiguruje zasady eksmisji dla pamięci podręcznej Wszystkie warstwy cenowe
notify-keyspace-events Konfiguruje powiadomienia dotyczące przestrzeni kluczy Standardowa i Premium
hash-max-ziplist-entries Konfiguruje optymalizację pamięci dla małych zagregowanych typów danych Standardowa i Premium
hash-max-ziplist-value Konfiguruje optymalizację pamięci dla małych zagregowanych typów danych Standardowa i Premium
set-max-intset-entries Konfiguruje optymalizację pamięci dla małych zagregowanych typów danych Standardowa i Premium
zset-max-ziplist-entries Konfiguruje optymalizację pamięci dla małych zagregowanych typów danych Standardowa i Premium
zset-max-ziplist-value Konfiguruje optymalizację pamięci dla małych zagregowanych typów danych Standardowa i Premium
bazy danych Konfiguruje liczbę baz danych. Tę właściwość można skonfigurować tylko podczas tworzenia pamięci podręcznej. Standardowa i Premium

Aby utworzyć usługę Azure Cache for Redis

Nowe wystąpienia usługi Azure Cache for Redis są tworzone przy użyciu polecenia cmdlet New-AzRedisCache .

Ważne

Przy pierwszym utworzeniu usługi Azure Cache for Redis w subskrypcji przy użyciu witryny Azure Portal portal rejestruje Microsoft.Cache przestrzeń nazw dla tej subskrypcji. Jeśli spróbujesz utworzyć pierwszą usługę Azure Cache for Redis w subskrypcji przy użyciu programu PowerShell, musisz najpierw zarejestrować tę przestrzeń nazw przy użyciu następującego polecenia; w przeciwnym razie polecenia cmdlet, takie jak New-AzRedisCache i Get-AzRedisCache niepowodzenie.

Register-AzResourceProvider -ProviderNamespace "Microsoft.Cache"

Aby wyświetlić listę dostępnych parametrów i ich opisy dla New-AzRedisCacheprogramu , uruchom następujące polecenie.

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

Aby utworzyć pamięć podręczną z domyślnymi parametrami, uruchom następujące polecenie.

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

ResourceGroupName, Namei Location są wymaganymi parametrami, ale pozostałe są opcjonalne i mają wartości domyślne. Uruchomienie poprzedniego polecenia powoduje utworzenie wystąpienia usługi Azure Cache for Redis w warstwie Standardowa z określoną nazwą, lokalizacją i grupą zasobów. Wystąpienie ma rozmiar 1 GB z wyłączonym portem bez protokołu SSL.

Aby utworzyć pamięć podręczną w warstwie Premium, określ rozmiar P1 (6 GB – 60 GB), P2 (13 GB – 130 GB), P3 (26 GB – 260 GB) lub P4 (53 GB – 530 GB– 530 GB). Aby włączyć klastrowanie, określ liczbę fragmentów przy użyciu parametru ShardCount . W poniższym przykładzie zostanie utworzona pamięć podręczna P1 w warstwie Premium z trzema fragmentami. Pamięć podręczna P1 Premium ma rozmiar 6 GB, a ponieważ określono trzy fragmenty, całkowity rozmiar to 18 GB (3 x 6 GB).

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

Aby określić wartości parametru RedisConfiguration , należy ująć wartości wewnątrz {} jako pary klucz/wartość, takie jak @{"maxmemory-policy" = "allkeys-random", "notify-keyspace-events" = "KEA"}. Poniższy przykład tworzy standardową pamięć podręczną o rozmiarze 1 GB z zasadami allkeys-random maxmemory i powiadomieniami o przestrzeni kluczy skonfigurowanymi przy użyciu polecenia KEA. Aby uzyskać więcej informacji, zobacz Powiadomienia dotyczące przestrzeni kluczy (ustawienia zaawansowane) i Zasady pamięci.

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

Aby skonfigurować ustawienie baz danych podczas tworzenia pamięci podręcznej

Ustawienie databases można skonfigurować tylko podczas tworzenia pamięci podręcznej. W poniższym przykładzie jest tworzona pamięć podręczna premium P3 (26 GB) z 48 bazami danych przy użyciu polecenia cmdlet New-AzRedisCache .

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

Aby uzyskać więcej informacji na temat właściwości, zobacz Domyślna databases konfiguracja serwera usługi Azure Cache for Redis. Aby uzyskać więcej informacji na temat tworzenia pamięci podręcznej przy użyciu polecenia cmdlet New-AzRedisCache , zobacz poprzednią sekcję Aby utworzyć pamięć podręczną Azure Cache for Redis.

Aby zaktualizować usługę Azure Cache for Redis

Wystąpienia usługi Azure Cache for Redis są aktualizowane przy użyciu polecenia cmdlet Set-AzRedisCache .

Aby wyświetlić listę dostępnych parametrów i ich opisy dla Set-AzRedisCacheprogramu , uruchom następujące polecenie.

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

Polecenie Set-AzRedisCache cmdlet może służyć do aktualizowania właściwości, takich jak Size, Sku, EnableNonSslPorti RedisConfiguration wartości.

Następujące polecenie aktualizuje zasady maxmemory-policy dla usługi Azure Cache for Redis o nazwie myCache.

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

Skalowanie usługi Azure Cache for Redis

Set-AzRedisCache Można użyć do skalowania wystąpienia usługi Azure Cache for Redis w przypadku Sizemodyfikacji właściwości , Skulub ShardCount .

Uwaga

Skalowanie pamięci podręcznej przy użyciu programu PowerShell podlega tym samym limitom i wytycznymi co skalowanie pamięci podręcznej z witryny Azure Portal. Możesz skalować do innej warstwy cenowej z następującymi ograniczeniami.

  • Nie można skalować z wyższej warstwy cenowej do niższej warstwy cenowej.
  • Nie można skalować z pamięci podręcznej Premium w dół do pamięci podręcznej w warstwie Standardowa lub Podstawowa.
  • Nie można skalować z pamięci podręcznej w warstwie Standardowa do pamięci podręcznej w warstwie Podstawowa.
  • Można skalować z pamięci podręcznej w warstwie Podstawowa do pamięci podręcznej w warstwie Standardowa, ale nie można jednocześnie zmieniać rozmiaru. Jeśli potrzebujesz innego rozmiaru, możesz wykonać kolejną operację skalowania do żądanego rozmiaru.
  • Nie można skalować z pamięci podręcznej w warstwie Podstawowa bezpośrednio do pamięci podręcznej Premium. Należy skalować z warstwy Podstawowa do Standardowa w ramach jednej operacji skalowania, a następnie z warstwy Standardowa do Warstwy Premium w kolejnej operacji skalowania.
  • Nie można skalować z większego rozmiaru do rozmiaru C0 (250 MB).

Aby uzyskać więcej informacji, zobacz Jak skalować usługę Azure Cache for Redis.

W poniższym przykładzie pokazano, jak skalować pamięć podręczną o nazwie myCache do pamięci podręcznej o rozmiarze 2,5 GB. To polecenie działa zarówno dla pamięci podręcznej w warstwie Podstawowa, jak i Standardowa.

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

Po wydaniu tego polecenia zostanie zwrócony stan pamięci podręcznej---similar do wywołania metody Get-AzRedisCache. Właściwość jest ustawiona ProvisioningState na Scalingwartość .

    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         :

Po zakończeniu operacji skalowania zmienia się ProvisioningState wartość Succeeded. Jeśli musisz wykonać inną operację skalowania--- na przykład zmiana z warstwy Podstawowa na Standardowa, a następnie zmiana rozmiaru--- musisz poczekać, aż poprzednia operacja zostanie ukończona lub zostanie wyświetlony błąd podobny do poniższego.

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

Aby uzyskać informacje o usłudze Azure Cache for Redis

Informacje o pamięci podręcznej można pobrać przy użyciu polecenia cmdlet Get-AzRedisCache .

Aby wyświetlić listę dostępnych parametrów i ich opisy dla Get-AzRedisCacheprogramu , uruchom następujące polecenie.

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

Aby zwrócić informacje o wszystkich pamięciach podręcznych w bieżącej subskrypcji, uruchom polecenie Get-AzRedisCache bez żadnych parametrów.

    Get-AzRedisCache

Aby zwrócić informacje o wszystkich pamięciach podręcznych w określonej grupie zasobów, uruchom polecenie Get-AzRedisCache z parametrem ResourceGroupName .

    Get-AzRedisCache -ResourceGroupName myGroup

Aby zwrócić informacje o określonej pamięci podręcznej, uruchom polecenie Get-AzRedisCache z Name parametrem zawierającym nazwę pamięci podręcznej i ResourceGroupName parametr z grupą zasobów zawierającą tę pamięć podręczną.

    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         :

Aby pobrać klucze dostępu dla usługi Azure Cache for Redis

Aby pobrać klucze dostępu do pamięci podręcznej, możesz użyć polecenia cmdlet Get-AzRedisCacheKey .

Aby wyświetlić listę dostępnych parametrów i ich opisy dla Get-AzRedisCacheKeyprogramu , uruchom następujące polecenie.

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

Aby pobrać klucze pamięci podręcznej, wywołaj Get-AzRedisCacheKey polecenie cmdlet i przekaż nazwę pamięci podręcznej nazwę grupy zasobów zawierającej pamięć podręczną.

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

    PrimaryKey   : b2wdt43sfetlju4hfbryfnregrd9wgIcc6IA3zAO1lY=
    SecondaryKey : ABhfB757JgjIgt785JgKH9865eifmekfnn649303JKL=

Aby ponownie wygenerować klucze dostępu dla usługi Azure Cache for Redis

Aby ponownie wygenerować klucze dostępu dla pamięci podręcznej, możesz użyć polecenia cmdlet New-AzRedisCacheKey .

Aby wyświetlić listę dostępnych parametrów i ich opisy dla New-AzRedisCacheKeyprogramu , uruchom następujące polecenie.

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

Aby ponownie wygenerować podstawowy lub pomocniczy klucz pamięci podręcznej, wywołaj New-AzRedisCacheKey polecenie cmdlet i przekaż nazwę, grupę zasobów i określ Primary parametr lub Secondary .KeyType W poniższym przykładzie pomocniczy klucz dostępu dla pamięci podręcznej jest ponownie wygenerowany.

    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=

Aby usunąć usługę Azure Cache for Redis

Aby usunąć usługę Azure Cache for Redis, użyj polecenia cmdlet Remove-AzRedisCache .

Aby wyświetlić listę dostępnych parametrów i ich opisy dla Remove-AzRedisCacheprogramu , uruchom następujące polecenie.

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

W poniższym przykładzie pamięć podręczna o nazwie myCache zostanie usunięta.

    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

Aby zaimportować usługę Azure Cache for Redis

Dane można zaimportować do wystąpienia usługi Azure Cache for Redis przy użyciu Import-AzRedisCache polecenia cmdlet .

Ważne

Importowanie/eksportowanie jest dostępne tylko dla pamięci podręcznych w warstwie Premium. Aby uzyskać więcej informacji na temat importowania/eksportowania, zobacz Importowanie i eksportowanie danych w usłudze Azure Cache for Redis.

Aby wyświetlić listę dostępnych parametrów i ich opisy dla Import-AzRedisCacheprogramu , uruchom następujące polecenie.

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

Następujące polecenie importuje dane z obiektu blob określonego przez identyfikator URI sygnatury dostępu współdzielonego do usługi 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

Aby wyeksportować usługę Azure Cache for Redis

Dane można wyeksportować z wystąpienia usługi Azure Cache for Redis przy użyciu Export-AzRedisCache polecenia cmdlet .

Ważne

Importowanie/eksportowanie jest dostępne tylko dla pamięci podręcznych w warstwie Premium. Aby uzyskać więcej informacji na temat importowania/eksportowania, zobacz Importowanie i eksportowanie danych w usłudze Azure Cache for Redis.

Aby wyświetlić listę dostępnych parametrów i ich opisy dla Export-AzRedisCacheprogramu , uruchom następujące polecenie.

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

Następujące polecenie eksportuje dane z wystąpienia usługi Azure Cache for Redis do kontenera określonego przez identyfikator URI sygnatury dostępu współdzielonego.

    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"

Aby ponownie uruchomić usługę Azure Cache for Redis

Możesz ponownie uruchomić wystąpienie usługi Azure Cache for Redis przy użyciu Reset-AzRedisCache polecenia cmdlet .

Ważne

Ponowny rozruch jest dostępny tylko dla pamięci podręcznych w warstwie Podstawowa, Standardowa i Premium. Aby uzyskać więcej informacji na temat ponownego uruchamiania pamięci podręcznej, zobacz Administracja pamięcią podręczną — ponowny rozruch.

Aby wyświetlić listę dostępnych parametrów i ich opisy dla Reset-AzRedisCacheprogramu , uruchom następujące polecenie.

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

Następujące polecenie uruchamia ponownie oba węzły określonej pamięci podręcznej.

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

Następne kroki

Aby dowiedzieć się więcej na temat korzystania z programu Windows PowerShell z platformą Azure, zobacz następujące zasoby: