Поделиться через


Set-AzRedisCache

Изменяет Кэш Azure для Redis.

Синтаксис

Default (по умолчанию)

Set-AzRedisCache
    [-ResourceGroupName <String>]
    -Name <String>
    [-Size <String>]
    [-Sku <String>]
    [-RedisConfiguration <Hashtable>]
    [-EnableNonSslPort <Boolean>]
    [-TenantSettings <Hashtable>]
    [-ShardCount <Int32>]
    [-MinimumTlsVersion <String>]
    [-DisableAccessKeyAuthentication <Boolean>]
    [-RedisVersion <String>]
    [-UpdateChannel <String>]
    [-ZonalAllocationPolicy <String>]
    [-Tag <Hashtable>]
    [-IdentityType <String>]
    [-UserAssignedIdentity <String[]>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Описание

Командлет Set-AzRedisCache изменяет кэш Azure для Redis.

Примеры

Пример 1. Изменение кэша Azure для Redis

Set-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -RedisConfiguration @{"maxmemory-policy" = "allkeys-random"}
PrimaryKey         : ******
          SecondaryKey       : ******
          ResourceGroupName  : mygroup
          Id                 : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/myCache
          Location           : North Central US
          Name               : MyCache
          Type               : Microsoft.Cache/Redis
          HostName           : mycache.redis.cache.windows.net
          Port               : 6379
          ProvisioningState  : creating
          SslPort            : 6380
          RedisConfiguration : {[maxmemory-policy, allkeys-random]}
          EnableNonSslPort   : False
          RedisVersion       : 2.8
          Size               : 250MB
          Sku                : Standard
          Tag                : {}
          Zone               : []

Эта команда обновляет политику maxmemory-policy для кэша Azure fo Redis с именем MyCache.

Пример 2. Изменение кэша Azure для Redis — если вы хотите отключить RDB или сохраняемость данных AOF.

Set-AzRedisCache -Name "MyCache"  -RedisConfiguration @{"rdb-backup-enabled" = "false"}
PrimaryKey         : ******
          SecondaryKey       : ******
          ResourceGroupName  : MyGroup
          Id                 : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/MyCache
          Location           : Central US
          Name               : mycache
          Type               : Microsoft.Cache/Redis
          HostName           : mycache.redis.cache.windows.net
          Port               : 6379
          ProvisioningState  : Succeeded
          SslPort            : 6380
          RedisConfiguration : {[maxmemory-policy, allkeys-random], [maxclients, 7500], [maxmemory-reserved, 200],
                                [maxfragmentationmemory-reserved, 300], [rdb-backup-enabled, false]...}
          EnableNonSslPort   : False
          RedisVersion       : 4.0.14
          Size               : 6GB
          Sku                : Premium
          Tag                : {}
          Zone               : []

Этот командлет отключает сохраняемость данных резервного копирования RDB для кэша Azure для Redis. Вы также можете отключить постоянный кэш резервного копирования AOF.

Пример 3. Изменение кэша Azure для Redis. Если вы хотите добавить сохраняемость данных после создания кэша Redis azure.

Set-AzRedisCache -Name "MyCache" -RedisConfiguration @{"rdb-backup-enabled" = "true"; "rdb-storage-connection-string" = "DefaultEndpointsProtocol=https;AccountName=mystorageaccount;AccountKey=******;EndpointSuffix=mySuffix"; "rdb-backup-frequency" = "30"}
PrimaryKey         : ******
          SecondaryKey       : ******
          ResourceGroupName  : MyGroup
          Id                 : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/MyCache
          Location           : Central US
          Name               : mycache
          Type               : Microsoft.Cache/Redis
          HostName           : mycache.redis.cache.windows.net
          Port               : 6379
          ProvisioningState  : Succeeded
          SslPort            : 6380
          RedisConfiguration : {[maxmemory-policy, allkeys-random], [maxclients, 7500], [maxmemory-reserved, 200],
                                [maxfragmentationmemory-reserved, 300], [rdb-backup-enabled, true]....}
          EnableNonSslPort   : False
          RedisVersion       : 4.0.14
          Size               : 6GB
          Sku                : Premium
          Tag                : {}
          Zone               : []

Этот командлет включает сохраняемость rdb-backup в уже существующем кэше. Вы также можете включить сохраняемость aof-backup.

Пример 4. Изменение кэша Azure для Redis. Если вы хотите изменить частоту резервного копирования rdb.

Например, в настоящее время вы принимаете моментальный снимок RDB каждые 30 минут, но вы хотите изменить моментальный снимок 15 минут.

Set-AzRedisCache -Name "MyCache" -RedisConfiguration @{"rdb-backup-frequency" = "15"}
PrimaryKey         : ******
          SecondaryKey       : ******
          ResourceGroupName  : MyGroup
          Id                 : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/MyCache
          Location           : Central US
          Name               : mycache
          Type               : Microsoft.Cache/Redis
          HostName           : mycache.redis.cache.windows.net
          Port               : 6379
          ProvisioningState  : Succeeded
          SslPort            : 6380
          RedisConfiguration : {[maxmemory-policy, allkeys-random], [maxclients, 7500], [maxmemory-reserved, 200],
                                [maxfragmentationmemory-reserved, 300], [rdb-backup-enabled, true]....}
          EnableNonSslPort   : False
          RedisVersion       : 4.0.14
          Size               : 6GB
          Sku                : Premium
          Tag                : {}
          Zone               : []

Пример 5. Изменение кэша Azure для Redis . Если вы хотите изменить сохраняемость данных AOF на резервную копию RDB.

Set-AzRedisCache -Name "MyCache"  -RedisConfiguration @{"aof-backup-enabled"= "false"; "rdb-backup-enabled" = "true"; "rdb-storage-connection-string" = "DefaultEndpointsProtocol=https;AccountName=mystorageaccount;AccountKey=******;EndpointSuffix=mySuffix"; "rdb-backup-frequency" = "30"}
PrimaryKey         : ******
          SecondaryKey       : ******
          ResourceGroupName  : MyGroup
          Id                 : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/MyCache
          Location           : Central US
          Name               : mycache
          Type               : Microsoft.Cache/Redis
          HostName           : mycache.redis.cache.windows.net
          Port               : 6379
          ProvisioningState  : Succeeded
          SslPort            : 6380
          RedisConfiguration : {[maxmemory-policy, allkeys-random], [maxclients, 7500], [maxmemory-reserved, 200],
                                [maxfragmentationmemory-reserved, 300], [rdb-backup-enabled, true]....}
          EnableNonSslPort   : False
          RedisVersion       : 4.0.14
          Size               : 6GB
          Sku                : Premium
          Tag                : {}
          Zone               : []

Этот командлет помогает изменить метод сохраняемости.

Пример 6. Масштабирование экземпляра кэша Azure для Redis— обновление до другого размера.

Set-AzRedisCache -Name "MyCache" -Size "P2" -Sku "Premium"
PrimaryKey         : ******
          SecondaryKey       : ******
          ResourceGroupName  : MyGroup
          Id                 : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/MyCache
          Location           : Central US
          Name               : mycache
          Type               : Microsoft.Cache/Redis
          HostName           : mycache.redis.cache.windows.net
          Port               : 6379
          ProvisioningState  : Scaling
          SslPort            : 6380
          RedisConfiguration : {[maxmemory-policy, allkeys-random], [maxclients, 7500], [maxmemory-reserved, 200],
                                [maxfragmentationmemory-reserved, 300]....}
          EnableNonSslPort   : False
          RedisVersion       : 4.0.14
          Size               : 6GB
          Sku                : Premium
          Tag                : {}
          Zone               : []

Эта команда увеличивает или уменьшает размер памяти экземпляра.

Пример 7. Масштабирование экземпляра кэша Azure для Redis— обновление до другого уровня.

Set-AzRedisCache -Name "MyCache" -Size "P1" -Sku "Premium"
PrimaryKey         : ******
          SecondaryKey       : ******
          ResourceGroupName  : MyGroup
          Id                 : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/MyCache
          Location           : Central US
          Name               : mycache
          Type               : Microsoft.Cache/Redis
          HostName           : mycache.redis.cache.windows.net
          Port               : 6379
          ProvisioningState  : Scaling
          SslPort            : 6380
          RedisConfiguration : {[maxmemory-policy, allkeys-random], [maxclients, 7500], [maxmemory-reserved, 200],
                                [maxfragmentationmemory-reserved, 300]....}
          EnableNonSslPort   : False
          RedisVersion       : 4.0.14
          Size               : 1GB
          Sku                : Standard
          Tag                : {}
          Zone               : []

Эта команда помогает изменить уровень кэша. Вы можете переходить с уровня "Базовый" на "Стандартный" или "Стандартный" на "Премиум".

Пример 8. Масштабирование экземпляра кэша Azure для Redis— включение кластеризации Redis.

Set-AzRedisCache -Name "MyCache" -ShardCount 1
PrimaryKey         : ******
          SecondaryKey       : ******
          ResourceGroupName  : MyGroup
          Id                 : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/MyCache
          Location           : Central US
          Name               : mycache
          Type               : Microsoft.Cache/Redis
          HostName           : mycache.redis.cache.windows.net
          Port               : 6379
          ProvisioningState  : Scaling
          SslPort            : 6380
          RedisConfiguration : {[maxmemory-policy, allkeys-random], [maxclients, 7500], [maxmemory-reserved, 200],
                                [maxfragmentationmemory-reserved, 300]....}
          EnableNonSslPort   : False
          RedisVersion       : 4.0.14
          Size               : 6GB
          Sku                : Premium
          ShardCount         :
          Tag                : {}
          Zone               : []

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

Пример 9. Масштабирование экземпляра кэша Azure для Redis. Использование кластера Redis для масштабирования и увеличения масштаба.

Set-AzRedisCache -Name "MyCache" -ShardCount 2
PrimaryKey         : ******
          SecondaryKey       : ******
          ResourceGroupName  : MyGroup
          Id                 : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/MyCache
          Location           : Central US
          Name               : mycache
          Type               : Microsoft.Cache/Redis
          HostName           : mycache.redis.cache.windows.net
          Port               : 6379
          ProvisioningState  : Scaling
          SslPort            : 6380
          RedisConfiguration : {[maxmemory-policy, allkeys-random], [maxclients, 7500], [maxmemory-reserved, 200],
                                [maxfragmentationmemory-reserved, 300]....}
          EnableNonSslPort   : False
          RedisVersion       : 4.0.14
          Size               : 6GB
          Sku                : Premium
          ShardCount         : 1
          Tag                : {}
          Zone               : []

Эта команда увеличивает или уменьшает размер кластера.

Параметры

-Confirm

Запрашивает подтверждение перед запуском cmdlet.

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

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:cf

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure.

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

Тип:IAzureContextContainer
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DisableAccessKeyAuthentication

Необязательно. Проверка подлинности в Redis с помощью ключей доступа отключена, если задано значение true. По умолчанию используется значение false.

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

Тип:String
Default value:false
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-EnableNonSslPort

Указывает, включен ли порт, отличный от SSL. Значение по умолчанию — $False (порт, отличный от SSL, отключен).

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

Тип:

Nullable<T>[Boolean]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-IdentityType

Указывает тип удостоверения, используемого для кэша Azure для Redis. Допустимые значения: SystemAssigned или UserAssigned или SystemAssignedUserAssigned Или None

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

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-MinimumTlsVersion

Укажите версию TLS, необходимую клиентами для подключения к кэшу.

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

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Name

Указывает имя кэша Azure для Redis для обновления.

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

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-RedisConfiguration

Задает параметры конфигурации Redis. Допустимые значения для этого параметра:

  • функция rdb-backup с поддержкой резервного копирования. Указывает, что сохраняемость данных Redis включена. Только уровень "Премиум".
  • rdb-хранилище-строка подключения. Указывает строку подключения к учетной записи хранения для сохраняемости данных Redis. Только уровень "Премиум".
  • частота резервного копирования rdb. Указывает частоту резервного копирования для сохраняемости данных Redis. Только уровень "Премиум".
  • maxmemory-reserved. Настраивает память, зарезервированную для процессов, не относящихся к кэшу. Уровни "Стандартный" и "Премиум".
  • maxmemory-policy. Настраивает политику вытеснения для кэша. Все ценовые категории.
  • notify-keyspace-events. Настраивает уведомления пространства ключей. Категории "Стандартный" и "Премиум".
  • hash-max-ziplist-entryries. Настраивает оптимизацию памяти для небольших типов статистических данных. Уровни "Стандартный" и "Премиум".
  • hash-max-ziplist-value. Настраивает оптимизацию памяти для небольших типов статистических данных. Уровни "Стандартный" и "Премиум".
  • set-max-intset-entryries. Настраивает оптимизацию памяти для небольших типов статистических данных. Уровни "Стандартный" и "Премиум".
  • zset-max-ziplist-entryries. Настраивает оптимизацию памяти для небольших типов статистических данных. Уровни "Стандартный" и "Премиум".
  • zset-max-ziplist-value. Настраивает оптимизацию памяти для небольших типов статистических данных. Уровни "Стандартный" и "Премиум".
  • Баз данных. Настраивает количество баз данных. Это свойство можно настроить только при создании кэша. Уровни "Стандартный" и "Премиум". Дополнительные сведения см. в статье "Управление кэшем Redis Azure" с помощью Azure PowerShell.
  • Предпочтительный метод проверки подлинности с данными-archive-auth-method , используемый для обмена данными с учетной записью хранения, используемой для архива данных, укажите SAS или ManagedIdentity, значение по умолчанию — SAS
  • Предпочтительный метод проверки подлинности с данными-сохраняемостью и методом предпочтительным методом проверки подлинности для обмена данными, используемым для сохраняемости данных, указание SAS или ManagedIdentity, значением по умолчанию является SAS

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

Тип:Hashtable
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-RedisVersion

Версия Redis. Это должно быть в форме "major[.minor]" (только "основной" является обязательным) или значение "latest", которое относится к последней стабильной версии Redis, доступной. Поддерживаемые версии: 4.0, 6.0 (последняя версия). Значение по умолчанию — "latest".

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

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-ResourceGroupName

Указывает имя группы ресурсов, содержащей кэш Redis.

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

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-ShardCount

Указывает количество сегментов, создаваемых в кэше кластера Premium.

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

Тип:

Nullable<T>[Int32]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Size

Указывает размер кэша Redis. Допустимые значения:

  • П1
  • P2
  • П3
  • P4
  • P5
  • С0
  • С1
  • С2
  • С3
  • С4
  • С5
  • С6
  • 250 МБ
  • 1 ГБ
  • 2,5 ГБ
  • 6GB
  • 13 ГБ
  • 26 ГБ
  • 53 ГБ
  • 120 ГБ Значение по умолчанию — 1 ГБ или C1.

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

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Sku

Указывает номер SKU создаваемого кэша Redis. Допустимые значения:

  • Базовый
  • Стандарт
  • Значение по умолчанию — "Стандартный".

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

Тип:String
Default value:None
Допустимые значения:Basic, Standard, Premium
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Tag

Хэш-таблица, представляющая теги.

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

Тип:Hashtable
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-TenantSettings

Этот параметр устарел.

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

Тип:Hashtable
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-UpdateChannel

Необязательно. Указывает канал обновления для ежемесячного обновления Redis, который будет получать кэш Redis. Кэши с помощью канала обновления "Предварительная версия" получают последние обновления Redis по крайней мере через 4 недели перед кэшем каналов "Стабильный". Значение по умолчанию — "Стабильный". Возможные значения: "Стабильный", "Предварительная версия"

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

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-UserAssignedIdentity

Указывает одно или несколько удостоверений пользователей, разделенных запятыми, которые должны быть связаны с кэшем Azure для Redis. Ссылки на удостоверения пользователя будут идентификаторами ресурсов ARM в форме: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identityes/{identityName}"

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

Тип:

String[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-WhatIf

Показывает, что произойдет, если командлет будет запущен. Командлет не запускается.

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

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:wi

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ZonalAllocationPolicy

Необязательный. Необязательный. Указывает, как зоны доступности выделяются в кэш Redis. Функция "Автоматически" обеспечивает избыточность зон, а Azure автоматически выбирает зоны на основе региональной доступности и емкости. UserDefined выбирает зоны доступности, переданные вами с помощью параметра "зоны". NoZones создаст незональный кэш. Если зональныйAllocationPolicy не передается, оно будет иметь значение UserDefined, если зоны передаются, в противном случае оно будет иметь значение "Automatic" в регионах, где поддерживаются зоны и "NoZones" в регионах, где зоны не поддерживаются.

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

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Входные данные

String

Hashtable

Nullable<T>

Nullable<T>

Выходные данные

RedisCacheAttributesWithAccessKeys