Управление Azure Redis с помощью Azure PowerShell

• PowerShell
• Azure CLI

Управляемый Redis в Azure

1. Чтобы создать экземпляр Управляемого Redis (предварительная версия) Azure, войдите в портал Azure и выберите "Создать ресурс".

2. На странице Создание выберите Базы данных, а затем Кэш Azure для Redis.

3. На странице Новый кэш Redis настройте параметры для нового кэша.

   Параметр	Выберите значение	Description
   Подписка	Раскройте список и выберите нужную подписку.	Подписка, в которой создается новый экземпляр Управляемого Redis Azure.
   Группа ресурсов	Раскройте список и выберите группу ресурсов или нажмите Создать и введите имя для новой группы ресурсов.	Имя группы ресурсов, в которой будут созданы кэш и другие ресурсы. Поместив все ресурсы приложения в одну группу ресурсов, вы сможете легко управлять ими и/или удалить их вместе.
   DNS-имя	Введите уникальное в пределах региона имя.	Имя кэша должно быть строкой от 1 до 63 символов при сочетании с именем региона кэша, содержащим только цифры, буквы или дефисы. (Если имя кэша меньше 45 символов, оно должно работать во всех доступных регионах.) Имя должно начинаться и заканчиваться числом или буквой и не может содержать последовательные дефисы. Имя \<DNS name\>.\<Azure region\>.redis.azure.netузла экземпляра кэша .
   Местонахождение	Откройте список и выберите расположение.	Управляемый Redis azure доступен в выбранных регионах Azure.
   Тип кэша	В раскрывающемся списке выберите уровень производительности и размер кэша.	Уровень определяет производительность экземпляра Redis, а размер кэша определяет память, доступную для хранения данных. Рекомендации по выбору правильного уровня производительности см. в разделе Chosing правильного уровня

   

4. Нажмите кнопку "Далее" и выберите общедоступную или частную конечную точку.

5. Нажмите кнопку Далее: Дополнительно. Здесь можно настроить любые модули Redis для добавления в экземпляр.

   Задайте для политики кластеризации значение Enterprise для некластеризованного кэша или в OSS для кластеризованного кэша. Дополнительные сведения о выборе политики кластеризации см. в статье "Политика кластера".

   

   Если вы используете активную георепликацию, ее необходимо настроить во время создания. Инструкции по этой настройке см. в разделе "Настройка активной георепликации для экземпляров Управляемого Redis Azure".

   Внимание

   После создания не удается изменить политику кластеризации экземпляра Управляемого Redis (предварительная версия) Azure. Если вы используете RediSearch, требуется политика кластера Enterprise и NoEviction является единственной поддерживаемой политикой вытеснения.

   Внимание

   Если вы используете этот экземпляр кэша в группе георепликации, политики вытеснения нельзя изменить после создания экземпляра. Перед созданием кэша необходимо знать политики вытеснения основных узлов. Дополнительные сведения о активной георепликации см. в разделе "Предварительные требования для активной георепликации".

   Внимание

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

6. Нажмите кнопку "Далее": теги и пропуск.

7. По завершении выберите Next: Отзыв и создание.

   

8. Проверьте параметры и выберите Создать.

   Создание экземпляра Redis займет несколько минут. Ход выполнения можно отслеживать на странице обзора Управляемого Redis в Azure. Когда Состояние примет значение Running (Выполняется), кэш будет готов к использованию.

Кэш Azure для Redis

1. Чтобы создать кэш, войдите в портал Azure. В меню портала выберите "Создать ресурс".

   

2. В области "Начало работы" введите Кэш Azure для Redis в строке поиска. В результатах поиска найдите Кэш Azure для Redis и нажмите кнопку "Создать".

   

3. На панели "Новый кэш Redis" на вкладке "Основы" настройте следующие параметры для кэша:

   Параметр	Действие	Description
   Подписка	Выберите свою подписку Azure.	Подписка, используемая для создания нового экземпляра Кэш Azure для Redis.
   Группа ресурсов	Выберите группу ресурсов или щелкните Создать и введите новое имя группы ресурсов.	Имя группы ресурсов, в которой создается кэш и другие ресурсы. Поместив все ресурсы приложения в одну группу ресурсов, вы сможете легко управлять ими и/или удалить их вместе.
   DNS-имя	Введите уникальное имя.	Имя кэша должно быть строкой от 1 до 63 символов, содержащих только цифры, буквы и дефисы. Имя должно начинаться и заканчиваться цифрой или буквой и не может содержать более одного дефиса подряд. Имя \<DNS name>.redis.cache.windows.netузла экземпляра кэша .
   Местонахождение	Выберите расположение.	Регион Azure, расположенный рядом с другими службами, используюющими кэш.
   Номер SKU кэша	Выберите номер SKU.	Номер SKU определяет размер, производительность и параметры компонентов, доступные для кэша. Дополнительные сведения см. в статье Общие сведения о Кэше Azure для Redis.
   Объем кэша	Выберите размер кэша.	Дополнительные сведения см. в статье Общие сведения о Кэше Azure для Redis.

4. Перейдите на вкладку "Сеть" или нажмите кнопку "Далее: сеть".

5. На вкладке "Сеть" выберите метод подключения, используемый для кэша.

6. Выберите вкладку "Дополнительно" или нажмите кнопку "Далее".

7. На панели "Дополнительно" проверьте или выберите метод проверки подлинности на основе следующих сведений:

   

   • По умолчанию для нового кэша "Базовый", "Стандартный" или "Премиум" включена проверка подлинности Microsoft Entra Authentication, а проверка подлинности ключей доступа отключена.
   • Для кэшей "Базовый" или "Стандартный" можно выбрать выбранный порт, отличный от TLS.
   • Для кэшей уровня "Стандартный" и "Премиум" можно включить зоны доступности. После создания кэша невозможно отключить зоны доступности.
   • Для кэша Premium настройте параметры для порта, не относяющегося к TLS, кластеризации, управляемому удостоверению и сохраняемости данных.

   Внимание

   Для оптимальной безопасности рекомендуется использовать идентификатор Microsoft Entra с управляемыми удостоверениями для авторизации запросов к кэшу, если это возможно. Авторизация с помощью идентификатора Microsoft Entra и управляемых удостоверений обеспечивает более высокую безопасность и удобство использования при авторизации ключа общего доступа. Дополнительные сведения об использовании управляемых удостоверений с кэшем см. в разделе "Использование идентификатора Microsoft Entra для проверки подлинности кэша".

8. (Необязательно) Выберите вкладку "Теги" или нажмите кнопку "Далее: теги".

9. (Необязательно) На вкладке "Теги" введите имя и значение тега, если вы хотите классифицировать ресурс кэша.

10. Нажмите кнопку Просмотреть и создать.

    На вкладке "Проверка и создание " Azure автоматически проверяет конфигурацию.

11. Когда отобразится сообщение Проверка пройдена зеленого цвета, выберите Создать.

Развертывание нового кэша происходит в течение нескольких минут. Ход развертывания можно отслеживать на панели обзора Кэш Azure для Redis. Когда отображается состояние выполнения, кэш готов к использованию.

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

Примечание.

В 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 версии 12.4.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-AzRedisEnterpriseCache , введите:

    Get-Help New-AzRedisEnterpriseCache -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 для Управляемого redis в Azure

Список всех параметров и свойств PowerShell управляемого redis в Azure см. в статье New-AzRedisEnterpriseCache.

Создание Управляемого Redis в Azure

Новые экземпляры Управляемого Redis azure создаются с помощью командлета New-AzRedisEnterpriseCache .

Внимание

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

Register-AzResourceProvider -ProviderNamespace "Microsoft.Cache"

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

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

    NAME
        New-AzRedisEnterpriseCache

    SYNOPSIS
        Creates a new Azure Managed Redis.


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


    DESCRIPTION
        The New-AzRedisEnterpriseCache cmdlet creates a new Azure Managed Redis.


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

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

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

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

        -Sku <String>
            Sku of Azure Managed Redis.

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

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

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

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

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

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

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

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

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

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

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

Чтобы включить кластеризацию, укажите количество сегментов с помощью параметра ShardCount .

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

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

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

Параметр databases можно настроить только при создании кэша. В следующем примере создается кэш с 48 базами данных с помощью командлета New-AzRedisEnterpriseCache .

    New-AzRedisEnterpriseCache -ResourceGroupName myGroup -Name mycache -Location "North Central US" -Sku B1 -RedisConfiguration @{"databases" = "48"}

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

Обновление Управляемого Redis в Azure

Экземпляры Управляемого Redis azure обновляются с помощью командлета [Set-AzRedisEnterpriseCache].

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

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

    NAME
        Set-AzRedisEnterpriseCache

    SYNOPSIS
        Set Azure Managed Redis updatable parameters.

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

    DESCRIPTION
        The Set-AzRedisEnterpriseCache cmdlet sets Azure Managed Redis parameters.

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

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

        -Sku <String>
            Sku of Azure Managed Redis.

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

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

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

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

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

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

Следующая команда обновляет политику maxmemory-policy для Управляемого Redis Azure с именем myCache.

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

Получение сведений об управляемом Redis в Azure

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

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

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

    NAME
        Get-AzRedisEnterpriseCache

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

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

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

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

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

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

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

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

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

    Get-AzRedisEnterpriseCache

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

    Get-AzRedisEnterpriseCache -ResourceGroupName myGroup

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

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

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

Получение ключей доступа для Управляемого Redis в Azure

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

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

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

    NAME
        Get-AzRedisEnterpriseCacheKey

    SYNOPSIS
        Gets the accesskeys for the specified Azure Managed Redis.


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

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

    PARAMETERS
        -Name <String>
            Name of the Azure Managed Redis.

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

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

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

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

    PrimaryKey   : b2wdt43sfetlju4hfbryfnregrd9wgIcc6IA3zAO1lY=
    SecondaryKey : ABhfB757JgjIgt785JgKH9865eifmekfnn649303JKL=

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

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

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

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

    NAME
        New-AzRedisEnterpriseCacheKey

    SYNOPSIS
        Regenerates the access key of an Azure Managed Redis.

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

    DESCRIPTION
        The New-AzRedisEnterpriseCacheKey cmdlet regenerate the access key of an Azure Managed Redis.

    PARAMETERS
        -Name <String>
            Name of the Azure Managed Redis.

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

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

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

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

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

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

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


    PrimaryKey   : b2wdt43sfetlju4hfbryfnregrd9wgIcc6IA3zAO1lY=
    SecondaryKey : c53hj3kh4jhHjPJk8l0jji785JgKH9865eifmekfnn6=

Удаление Управляемого Redis в Azure

Чтобы удалить Управляемый Redis Azure, используйте командлет Remove-AzRedisEnterpriseCache .

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

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

    NAME
        Remove-AzRedisEnterpriseCache

    SYNOPSIS
        Remove Azure Managed Redis if exists.

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

    DESCRIPTION
        The Remove-AzRedisEnterpriseCache cmdlet removes an Azure Managed Redis if it exists.

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

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

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

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

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

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

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

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

Импорт управляемого Redis в Azure

Вы можете импортировать данные в экземпляр Управляемого Redis в Azure с помощью командлета Import-AzRedisEnterpriseCache .

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

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

    NAME
        Import-AzRedisEnterpriseCache

    SYNOPSIS
        Import data from blobs to Azure Managed Redis.


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


    DESCRIPTION
        The Import-AzRedisEnterpriseCache cmdlet imports data from the specified blobs into Azure Managed Redis.


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

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

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

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

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

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

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

Следующая команда импортирует данные из большого двоичного объекта, указанного URI SAS, в Управляемый Redis Azure.

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

Экспорт управляемого Redis в Azure

Вы можете экспортировать данные из экземпляра Управляемого Redis в Azure с помощью командлета Export-AzRedisEnterpriseCache .

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

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

    NAME
        Export-AzRedisEnterpriseCache

    SYNOPSIS
        Exports data from Azure Managed Redis to a specified container.


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


    DESCRIPTION
        The Export-AzRedisEnterpriseCache cmdlet exports data from Azure Managed Redis to a specified container.


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

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

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

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

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

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

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

Следующая команда экспортирует данные из экземпляра Управляемого Redis Azure в контейнер, указанный URI SAS.

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

Перезагрузка управляемого Redis в Azure (предварительная версия)

Вы можете перезагрузить экземпляр Управляемого Redis (предварительная версия) Azure с помощью командлета Reset-AzRedisEnterpriseCache .

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

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

    NAME
        Reset-AzRedisEnterpriseCache

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


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


    DESCRIPTION
        The Reset-AzRedisEnterpriseCache cmdlet reboots the specified node(s) of an Azure Managed Redis instance.


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

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

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

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

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

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

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

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

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

Примечание.

В 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, 250MB, 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 см. в следующих ресурсах:

• Документация по командлету кэша Azure для Redis на MSDN
• Командлеты диспетчера ресурсов Azure: узнайте, как использовать командлеты в модуле диспетчера ресурсов Azure.
• Развертывание ресурсов с использованием шаблонов Resource Manager и портала Azure: узнайте, как создавать группы ресурсов и управлять ими на портале Azure.
• Блог Azure: узнайте о новых возможностях в Azure.
• Блог Windows PowerShell: узнайте о новых возможностях в Windows PowerShell.
• Блог "Hey, Scripting Блог: реальные советы и рекомендации от сообщества Windows PowerShell.