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

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

Вы создаете новые управляемые экземпляры Azure Redis с помощью командлета New-AzRedisEnterpriseCache. ResourceGroupName, , NameLocationи Sku являются обязательными параметрами. Другие параметры являются необязательными и имеют значения по умолчанию.

Проверка подлинности Microsoft Entra включена по умолчанию для всех новых кэшей и рекомендуется для обеспечения безопасности.

Для всех параметров и свойств управляемого Redis для Azure в PowerShell см. New-AzRedisEnterpriseCache. Чтобы вывести список доступных параметров и их описания, выполните следующую команду.

Get-Help New-AzRedisEnterpriseCache -detailed

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

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

Создание и настройка баз данных

Командлет New-AzRedisEnterpriseCacheDatabase можно использовать для создания и настройки баз данных для кэша Redis в Azure. Чтобы увидеть список доступных параметров свойства New-AzRedisEnterpriseCacheDatabaseи их описания, выполните следующую команду:

Get-Help New-AzRedisEnterpriseCacheDatabase -detailed

Если во время создания кэша не настроены базы данных, New-AzRedisEnterpriseCache создает одну базу данных в кэше с именем default по умолчанию, а все данные кэша попадают в эту DB 0 базу данных.

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

Для обновления экземпляров Azure Managed Redis используйте командлет Update-AzRedisEnterpriseCache. Чтобы увидеть список доступных параметров свойства Update-AzRedisEnterpriseCacheи их описания, выполните следующую команду:

Get-Help Update-AzRedisEnterpriseCache -detailed

Командлет можно использовать Update-AzRedisEnterpriseCache для обновления таких свойств, как Sku, Tag и MinimumTlsVersion. Следующая команда обновляет минимальную версию TLS и добавляет тег в кэш управляемого Azure Redis myCache.

Update-AzRedisEnterpriseCache -Name "myCache" -ResourceGroupName "myGroup" -MinimumTlsVersion "1.2" -Tag @{"tag1" = "value1"}

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

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

Get-Help Get-AzRedisEnterpriseCache -detailed

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

Get-AzRedisEnterpriseCache

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

Get-AzRedisEnterpriseCache -ResourceGroupName myGroup

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

Get-AzRedisEnterpriseCache -Name myCache -ResourceGroupName myGroup

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

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

Get-Help Get-AzRedisEnterpriseCacheKey -detailed

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

Get-AzRedisEnterpriseCacheKey -Name myCache -ResourceGroupName myGroup

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

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

Get-Help New-AzRedisEnterpriseCacheKey -detailed

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

New-AzRedisEnterpriseCacheKey -Name myCache -ResourceGroupName myGroup -KeyType Secondary

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

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

Get-Help Remove-AzRedisEnterpriseCache -detailed

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

Remove-AzRedisEnterpriseCache -Name myCache -ResourceGroupName myGroup

Импорт данных управляемого кэша Redis в Azure.

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

Get-Help Import-AzRedisEnterpriseCache -detailed

Требуются Name, ResourceGroupName и SasUri для импорта BLOB-объекта. Следующая команда импортирует данные из BLOB по указанному SAS URI.

Import-AzRedisEnterpriseCache -ClusterName "myCache" -ResourceGroupName "myGroup" -SasUri @("<sas-uri>")

Экспорт данных управляемого кэша Redis в Azure

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

Get-Help Export-AzRedisEnterpriseCache -detailed

Требуются кэш Name, ResourceGroupName и SasUri контейнера для экспорта. В следующем примере команда экспортирует данные из контейнера, указанного URI SAS.

Export-AzRedisEnterpriseCache -Name "myCache" -ResourceGroupName "myGroup" -SasUri "https://mystorageaccount.blob.core.windows.net/mycontainer?sp=signedPermissions&se=signedExpiry&sv=signedVersion&sr=signedResource&sig=signature;mystoragekey"

Свойства и параметры Azure Cache для Redis в PowerShell

В следующих таблицах показаны свойства и описания Azure PowerShell для общих параметров кэша Azure для Redis. Сведения обо всех параметрах и свойствах Az.RedisCacheAzure PowerShell см. в статье AzRedisCache.

Свойства параметра RedisConfiguration

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

Вы создаете новые экземпляры Azure Cache для Redis с помощью командлета New-AzRedisCache. ResourceGroupName, Nameи Location являются обязательными параметрами. Другие параметры являются необязательными и имеют значения по умолчанию.

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

Get-Help New-AzRedisCache -detailed>

Следующая команда создает экземпляр кэша Azure для Redis с указанным именем, расположением и группой ресурсов, используя параметры по умолчанию. Экземпляр — это стандартный кэш объемом 1 ГБ с отключенным не-SSL портом.

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

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

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

Создание кэша класса Premium

Чтобы создать кэш Azure для Redis уровня Premium, укажите размер P1 (6–60 ГБ), P2 (13–130 ГБ), P3 (26–260 ГБ) или P4 (53–530 ГБ). Чтобы включить кластеризацию, укажите количество сегментов с помощью параметра ShardCount .

В следующем примере создается кэш P1 Premium с тремя сегментами. Кэш уровня "Премиум" P1 составляет 6 ГБ, а общий размер трех сегментов составляет 18 ГБ (3 x 6 ГБ).

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

Настройка параметра баз данных

Параметр databases в командлете New-AzRedisCache настраивает количество баз данных в кэше. Можно настроить databases только для уровней "Стандартный" и "Премиум" и только во время создания кэша с помощью PowerShell или других клиентов управления.

Если вы не указываете databases параметр во время создания кэша, New-AzRedisCache создает одну базу данных с именем default, и все данные кэша попадают в эту DB 0 базу данных. Ограничение базы данных зависит от уровня кэша и размера, но значение по умолчанию — 16.

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

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

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

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

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

Get-Help Set-AzRedisCache -detailed

Командлет Set-AzRedisCache можно использовать для обновления свойств, таких как Size, Sku, EnableNonSslPort, и значений RedisConfiguration. В следующем примере команда обновляет maxmemory-policy для инстанса Azure Cache for Redis с именем myCache.

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

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

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

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

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

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

По завершении операции масштабирования значение параметра 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и их описания, выполните следующую команду:

Get-Help Get-AzRedisCache -detailed

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

Get-AzRedisCache

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

Get-AzRedisCache -ResourceGroupName myGroup

Для получения информации о конкретном кэше запустите Get-AzRedisCache с кэшем Name и ResourceGroupName.

Get-AzRedisCache -Name myCache -ResourceGroupName myGroup

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

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

Get-Help Get-AzRedisCacheKey -detailed

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

Get-AzRedisCacheKey -Name myCache -ResourceGroupName myGroup

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

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

Get-Help New-AzRedisCacheKey -detailed

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

New-AzRedisCacheKey -Name myCache -ResourceGroupName myGroup -KeyType Secondary

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

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

Get-Help Remove-AzRedisCache -detailed

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

Remove-AzRedisCache -Name myCache -ResourceGroupName myGroup

Импорт данных в кэш Azure для Redis

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

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

Get-Help Import-AzRedisCache -detailed

Следующая команда импортирует данные из blob, указанного параметром Files, в Azure Cache для Redis.

Import-AzRedisCache -ResourceGroupName "resourceGroupName" -Name "cacheName" -Files @("https://mystorageaccount.blob.core.windows.net/mycontainername/blobname?sv=signedVersion&sr=signedResource&sig=signature&st=signTime&se=signedExpiry&sp=signedPermissions") -Force

Экспорт данных из Azure Cache for Redis

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

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

Get-Help Export-AzRedisCache -detailed

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

Export-AzRedisCache -ResourceGroupName "resourceGroupName" -Name "cacheName" -Prefix "blobprefix" -Container "https://mystorageaccount.blob.core.windows.net/mycontainer?sv=signedResource&sig=signature&st=signTime&se=signedExpiry&sp=signedPermissions"

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

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

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

Get-Help Reset-AzRedisCache -detailed

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

Reset-AzRedisCache -ResourceGroupName "resourceGroupName" -Name "cacheName" -RebootType "AllNodes" -Force