Управление кэшем Azure для Redis с использованием Azure PowerShell

  • Статья

В этой статье показано, как создавать, обновлять и масштабировать экземпляры кэша Azure для Redis. В этой статье также показано, как повторно создавать ключи доступа и просматривать сведения о кэшах. Ознакомьтесь с полным списком командлетов PowerShell для работы с кэшем Azure для Redis.

Примечание.

В Azure доступны две модели развертывания для создания ресурсов и работы с ними: модель Azure Resource Manager и классическая модель. В этой статье описывается модель развертывания с помощью Resource Manager. Мы рекомендуем использовать для новых развертываний модель развертывания с помощью Resource Manager вместо классической модели развертывания.

Дополнительные сведения о классической модели развертывания см. в статье Azure Resource Manager vs. classic deployment: Understand deployment models and the state of your resources (Развертывание с помощью Azure Resource Manager и классическое развертывание: сведения о моделях развертывания и состоянии ресурсов).

Необходимые компоненты

Если вы уже установили Azure PowerShell, необходимо использовать Azure PowerShell 1.0.0 или более поздней версии. Версию Azure PowerShell можно узнать в командной строке Azure PowerShell с помощью следующей команды.

    Get-Module Az | format-table version

Сначала необходимо войти в Azure с помощью следующей команды.

    Connect-AzAccount

Укажите адрес электронной почты и пароль своей учетной записи Azure в диалоговом окне входа в Microsoft Azure.

Далее, если у вас есть несколько подписок Azure, необходимо задать лишь одну из них. Чтобы просмотреть список текущих подписок, выполните следующую команду.

    Get-AzSubscription | sort SubscriptionName | Select SubscriptionName

Чтобы указать подписку, выполните указанную ниже команду. В приведенном ниже примере имя подписки — ContosoSubscription.

    Select-AzSubscription -SubscriptionName ContosoSubscription

Чтобы использовать Windows PowerShell с диспетчером ресурсов Azure, необходимо проверить конфигурацию.

  • Windows PowerShell версии 3.0 или 4.0. Чтобы найти версию Windows PowerShell, введите $PSVersionTable и убедитесь, что для PSVersion указано значение 3.0 или 4.0. Чтобы установить совместимую версию, см. Windows Management Framework 3.0.

Чтобы получить подробную справку для любого командлета, встречающегося в этом учебнике, используйте командлет Get-Help.

    Get-Help <cmdlet-name> -Detailed

Например, чтобы получить справку для командлета New-AzRedisCache , введите:

    Get-Help New-AzRedisCache -Detailed

Подключение к другим облакам

Среда Azure по умолчанию — это AzureCloud, представляющая экземпляр глобального облака Azure. Чтобы подключиться к другому экземпляру, используйте команду Connect-AzAccount, заменив параметр -Environment или -EnvironmentName на нужную вам среду или имя среды.

Чтобы просмотреть список доступных сред, выполните командлет Get-AzEnvironment .

Подключение к облаку Azure Government

Чтобы подключиться к облаку Azure Government, используйте одну из следующих команд.

    Connect-AzAccount -EnvironmentName AzureUSGovernment

Or

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

Чтобы создать кэш в облаке Azure Government, используйте одно из следующих расположений.

  • USGov Вирджиния
  • USGov Iowa

Дополнительные сведения об облаке Azure для государственных организаций см. на странице Microsoft Azure для государственных организаций и в руководстве для разработчиков Microsoft Azure для государственных организаций.

Подключение к Microsoft Azure под управлением 21Vianet Cloud

Чтобы подключиться к Azure, управляемому облаком 21Vianet, используйте одну из следующих команд.

    Connect-AzAccount -EnvironmentName AzureChinaCloud

Or

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

Чтобы создать кэш в Azure под управлением 21Vianet Cloud, используйте одно из следующих расположений.

  • Восточный Китай
  • Северный Китай

Подключение к Microsoft Azure для Германии

Чтобы подключиться к Microsoft Azure для Германии, используйте одну из следующих команд.

    Connect-AzAccount -EnvironmentName AzureGermanCloud

Or

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

Чтобы создать кэш в Microsoft Azure для Германии, используйте одно из следующих расположений.

  • Центральная Германия
  • Северо-Восточная Германия

Дополнительные сведения о Microsoft Azure для Германии см. здесь.

Свойства, используемые в командлетах PowerShell кэша Azure для Redis

Приведенная ниже таблица содержит свойства Azure PowerShell и описания параметров, часто используемых при создании экземпляров Кэша Azure для Redis и управлении ими.

Параметр Описание По умолч.
Имя. Имя кэша
Местонахождение Расположение кэша
ResourceGroupName Имя группы ресурсов, в которой необходимо создать кэш
Размер Размер кэша. Допустимые значения: P1, P2, P3, P4, P5, C1, C2, C2, C3, C4, C5, C6, 250 МБ, 1 ГБ, 2,5 ГБ, 6 ГБ, 13 ГБ, 26 ГБ, 53 ГБ 1 ГБ
ShardCount Число сегментов, которые будут созданы при создании кэша уровня Premium с включенной кластеризацией. Допустимые значения: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10
номер SKU Определяет SKU кэша. Допустимые значения: Basic, Standard, Premium Стандартные
RedisConfiguration Задает параметры конфигурации кластера Redis. Подробные сведения о каждом параметре представлены в таблице Свойства RedisConfiguration .
EnableNonSslPort. Определяет, включен ли порт без SSL. False
MaxMemoryPolicy Этот параметр устарел, вместо него используется параметр RedisConfiguration.
StaticIP При размещении кэша в виртуальной сети определяет уникальный IP-адрес подсети для кэша. Если IP-адрес не указан, он автоматически выбирается из подсети.
Подсеть При размещении кэша в виртуальной сети определяет имя подсети, в которой будет развернут кэш.
Виртуальная сеть При размещении кэша в виртуальной сети определяет идентификатор ресурса виртуальной сети, в которой будет развернут кэш.
KeyType Определяет, какой ключ доступа будет создаваться повторно при обновлении ключей доступа. Допустимые значения: Primary, Secondary

Свойства RedisConfiguration

Свойство Description Ценовые категории
rdb-backup-enabled Указывает на то, включен ли параметр Сохраняемость данных Redis . Только "Премиум"
rdb-storage-connection-string Строка подключения к учетной записи хранения для параметра Сохраняемость данных Redis Только "Премиум"
rdb-backup-frequency Указывает частоту резервного копирования для параметра Сохраняемость данных Redis Только "Премиум"
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 Настраивает оптимизацию памяти для небольших сводных данных. "Стандартный" и "Премиум"
базы данных Определяет количество баз данных. Это свойство можно настроить только в момент создания кэша. "Стандартный" и "Премиум"

Создание экземпляра кэша Azure для Redis

Новые экземпляры кэша Azure для Redis создаются с помощью командлета New-AzRedisCache.

Важно!

Когда кэш Azure для Redis создается в подписке с использованием портала Azure впервые, портал регистрирует пространство имен Microsoft.Cache для этой подписки. Если первый кэш Azure для Redis создается в подписке с использованием PowerShell, необходимо зарегистрировать пространство имен с помощью представленной ниже команды, иначе командлеты New-AzRedisCache и Get-AzRedisCache завершатся ошибкой.

Register-AzResourceProvider -ProviderNamespace "Microsoft.Cache"

Чтобы увидеть список доступных параметров свойства New-AzRedisCacheи их описания, выполните следующую команду:

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

Чтобы создать кэш с параметрами по умолчанию, выполните следующую команду:

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

ResourceGroupName, Name и Location — обязательные параметры; остальные указываются по желанию и имеют значения по умолчанию. При выполнении предыдущей команды создается экземпляр Кэша Azure для Redis SKU "Стандартный" с заданным именем, расположением и группой ресурсов. Размер этого экземпляра составляет 1 ГБ, порт без SSL отключен.

Для создания кэша уровня Premium укажите размер P1 (6-60 ГБ), P2 (13-130 ГБ), (26-260 ГБ), P3 и P4 (53-530 ГБ). Чтобы включить кластеризацию, укажите количество сегментов с помощью параметра ShardCount . В следующем примере создается кэш P1 уровня "Премиум" с тремя сегментами. Размер кэша P1 уровня Premium — 6 ГБ, и, поскольку мы указали три сегмента, общий размер составляет 18 ГБ (3 x 6 ГБ).

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

Чтобы указать значения для параметра RedisConfiguration, включите их в фигурные скобки ({}) как пары "ключ-значение" типа @{"maxmemory-policy" = "allkeys-random", "notify-keyspace-events" = "KEA"}. В следующем примере создается кэш уровня "Стандартный" размером 1 ГБ с политикой максимальной памяти allkeys-random и уведомлениями пространства ключей, настроенными с помощью KEA. Дополнительные сведения см. в разделах Уведомления пространства ключей (дополнительные параметры) и Политики памяти.

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

Настройка параметров баз данных в процессе создания кэша

Параметр databases можно настроить только при создании кэша. В следующем примере создается кэш P3 (26 ГБ) уровня Premium на 48 базах данных с использованием командлета New-AzRedisCache.

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

Дополнительные сведения о свойстве databases см. в разделе о конфигурации сервера кэша Azure для Redis по умолчанию. Дополнительные сведения о создании кэша с помощью командлета New-AzRedisCache см. в предыдущем разделе "Создание экземпляра кэша Azure для Redis".

Обновление экземпляра кэша Azure для Redis

Экземпляры кэша Azure для Redis обновляются с помощью командлета Set-AzRedisCache.

Чтобы увидеть список доступных параметров свойства Set-AzRedisCacheи их описания, выполните следующую команду:

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

Командлет Set-AzRedisCache можно использовать для обновления таких свойств, как значения Size, Sku, EnableNonSslPort и RedisConfiguration.

Следующая команда обновляет политику максимального объема памяти (maxmemory-policy) кэша Azure для Redis с именем myCache.

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

Масштабирование кэша Azure для Redis

Set-AzRedisCache можно использовать для масштабирования экземпляров кэша Azure для Redis при изменении свойств Size, Sku или ShardCount.

Примечание.

Масштабирование кэша с помощью PowerShell подчиняется тем же ограничениям и правилам, что и масштабирование кэша на портале Azure. Вы можете выполнить масштабирование до другой ценовой категории со следующими ограничениями.

  • Перейти с более высокой ценовой категории на более низкую нельзя.
  • Ценовую категорию кэша Премиум нельзя изменить на категорию Стандартный или Базовый.
  • Ценовую категорию кэша Стандартный нельзя изменить на категорию Базовый.
  • Вы можете выполнить масштабирование кэша с уровня Базовый до уровня Стандартный, но вам не удастся одновременно с этим изменить размер кэша. Если требуется изменить размер, можно выполнить последующую операцию масштабирования до нужного размера.
  • Ценовую категорию кэша Базовый нельзя изменить сразу на уровень Премиум. Необходимо сначала перейти с категории Базовый на категорию Стандартный, а затем — с категории Стандартный на категорию Премиум.
  • Вам не удастся выполнить масштабирование с большего размера до размера C0 (250 МБ) .

Дополнительные сведения см. в статье How to Scale Azure Cache for Redis (Как масштабировать кэш Azure для Redis).

В следующем примере демонстрируется масштабирование кэша с именем myCache в кэш размером 2,5 ГБ. Эта команда работает в кэше уровня "Базовый" или "Стандартный".

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

После запуска этой команды будет возвращено состояние кэша, аналогично вызову Get-AzRedisCache. Для ProvisioningState задано значение Scaling.

    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         :

По завершении операции масштабирования значение параметра ProvisioningState изменяется на Succeeded. Если необходимо выполнить другую операцию масштабирования, например изменить уровень кэша с уровня "Базовый" на уровень "Стандартный", а затем скорректировать его размер, нужно дождаться завершения предыдущей операции. В противном случае возникнет ошибка следующего вида.

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

Получение сведений об использовании кэша Azure для Redis

Вы можете получить сведения об использовании кэша с помощью командлета Get-AzRedisCache.

Чтобы увидеть список доступных параметров свойства Get-AzRedisCacheи их описания, выполните следующую команду:

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

Чтобы получить сведения обо всех кэшах в текущей подписке, выполните командлет Get-AzRedisCache без параметров.

    Get-AzRedisCache

Чтобы получить сведения обо всех кэшах в определенной группе ресурсов, выполните командлет Get-AzRedisCache с параметром ResourceGroupName.

    Get-AzRedisCache -ResourceGroupName myGroup

Чтобы получить сведения о конкретном кэше, выполните командлет Get-AzRedisCache с параметром Name, содержащим имя кэша, и параметром ResourceGroupName с группой ресурсов, содержащей этот кэш.

    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         :

Получение ключей доступа к кэшу Azure для Redis

С помощью командлета Get-AzRedisCacheKey получите ключи доступа к кэшу.

Чтобы увидеть список доступных параметров свойства Get-AzRedisCacheKeyи их описания, выполните следующую команду:

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

Чтобы получить ключи к кэшу, вызовите командлет Get-AzRedisCacheKey и передайте имя кэша и имя группы ресурсов, содержащей этот кэш.

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

    PrimaryKey   : b2wdt43sfetlju4hfbryfnregrd9wgIcc6IA3zAO1lY=
    SecondaryKey : ABhfB757JgjIgt785JgKH9865eifmekfnn649303JKL=

Повторное создание ключей доступа к кэшу Azure для Redis

С помощью командлета New-AzRedisCacheKey повторно создайте ключи доступа к кэшу.

Чтобы увидеть список доступных параметров свойства New-AzRedisCacheKeyи их описания, выполните следующую команду:

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

Чтобы повторно создать первичный или вторичный ключ кэша, вызовите командлет New-AzRedisCacheKey, передайте имя и группу ресурсов и укажите значение Primary или Secondary для параметра KeyType. В приведенном ниже примере создается вторичный ключ доступа для кэша.

    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=

Удаление кэша Azure для Redis

С помощью командлета Remove-AzRedisCache удалите кэш Azure для Redis.

Чтобы увидеть список доступных параметров свойства Remove-AzRedisCacheи их описания, выполните следующую команду:

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

В приведенном ниже примере удаляется кэш с именем myCache .

    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

Импорт экземпляра кэша Azure для Redis

Импортировать данные в кэш Azure для Redis можно с помощью командлета Import-AzRedisCache.

Важно!

Импорт/экспорт доступен только для кэша уровня "Премиум". Дополнительные сведения об импорте и экспорте см. в статье Импорт и экспорт данных кэша Azure для Redis.

Чтобы увидеть список доступных параметров свойства Import-AzRedisCacheи их описания, выполните следующую команду:

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

Приведенная ниже команда импортирует данные из большого двоичного объекта, указанного в универсальном коде ресурса (URI) SAS, в кэш Azure для 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

Экспорт кэша Azure для Redis

Экспортировать данные из кэша Azure для Redis можно с помощью командлета Export-AzRedisCache.

Важно!

Импорт/экспорт доступен только для кэша уровня "Премиум". Дополнительные сведения об импорте и экспорте см. в статье Импорт и экспорт данных кэша Azure для Redis.

Чтобы увидеть список доступных параметров свойства Export-AzRedisCacheи их описания, выполните следующую команду:

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

Приведенная ниже команда экспортирует данные из экземпляра кэша Azure для Redis в контейнер, указанный универсальным кодом ресурса SAS.

    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"

Перезапуск кэша Azure для Redis

Перезапустить экземпляр кэша Azure для Redis можно с помощью командлета Reset-AzRedisCache.

Важно!

Функция перезагрузки доступна только для кэша уровня "Базовый", "Стандартный" и "Премиум". Дополнительные сведения о перезапуске кэша см. в разделе Reboot статьи "Администрирование кэша Redis для Azure".

Чтобы увидеть список доступных параметров свойства Reset-AzRedisCacheи их описания, выполните следующую команду:

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

Перезапустить оба узла указанного кэша можно с помощью такой команды:

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

Следующие шаги

Дополнительные сведения об использовании Windows PowerShell с Azure см. в следующих ресурсах: