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


New-AzRedisCache

Создает кэш Redis.

Синтаксис

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

Описание

Командлет New-AzRedisCache создает кэш Redis Для Azure.

Примеры

Пример 1. Создание кэша Redis

New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "North Central US"

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 : {}
          EnableNonSslPort   : False
          RedisVersion       : 2.8
          Size               : 1GB
          Sku                : Standard
          Tag                : {}
          Zone               : []

Эта команда создает кэш Redis.

Пример 2. Создание кэша Redis уровня "Стандартный" SKU

New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "North Central US" -Size 250MB -Sku "Standard" -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               : []

Этот командлет создает кэш с помощью кэша Azure для Redis.

Пример 3. Создание кэша избыточности между зонами

New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "Central US" -Size P1 -Sku "Premium" -Zone @("1","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  : creating
          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               : {1, 2}

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

Пример 4. Создание кэша включения виртуальной сети

Требования к созданию кэша для виртуальной сети.

  1. Создайте виртуальную сеть в той же группе ресурсов, в которой требуется создать кэш Redis. Вы можете создать виртуальную сеть из команды New-AzVirtualNetwork powershell.
  2. Вам потребуется subnetID для включения кэша виртуальной сети. Синтаксис SubnetID приведен ниже.

Формат SubnetID: /subscriptions/{subid}/resourceGroups/{resourceGroupName}/providers/Microsoft.ClassicNetwork/VirtualNetworks/{vnetName}/subnets/{subnetName}

New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "Central US" -Size P1 -Sku "Premium" -SubnetId "/subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Network/virtualNetworks/MyNet/subnets/MySubnet"

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  : creating
          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
          SubnetId           : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Network/virtualNetworks/MyNet/subnets/MySubnet
          StaticIP           : 10.0.0.4
          Tag                : {}
          Zone               : []

Пример 5. Настройка сохраняемости данных для кэша Azure уровня "Премиум" для Redis

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

После создания учетной записи хранения получите строку подключения учетной записи хранения с помощью этой процедуры.

  1. Выполните эту команду Get-AzStorageAccountKey -ResourceGroupName $resourceGroupName -Name $storageAccountName в PowerShell.
  2. Из выходных данных выше скопируйте любой ключ.
  3. Поместите ключ учетной записи хранения и имя учетной записи хранения в формате ниже, чтобы получить строку подключения учетной записи хранения.

Формат строки подключения:- DefaultEndpointsProtocol=https; AccountName={storageAccountName}; AccountKey={storageAccountKey}; EndpointSuffix=mySuffix"

Для обеспечения сохраняемости данных необходимо иметь определенные параметры конфигурации Redis.

Включение резервного копирования RDB

  • rdb-backup-enabled (set true или false)
  • rdb-storage-connection-string (укажите строку подключения в приведенном выше формате.)
  • частота резервного копирования rdb (задайте интервал резервного копирования в минутах. Вы можете выбрать только от - 15, 30, 60, 360, 720 и 1440 минут.)
New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "Central US" -Size P1 -Sku "Premium" -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  : creating
          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 — включена резервная копия AOF

Для резервного копирования AOF включено.

  • aof-backup-enabled (set true или false),
  • aof-storage-connection-string-0 (укажите строку подключения в приведенном выше формате.)
  • aof-storage-connection-string-1 (при необходимости можно настроить другую учетную запись хранения. Если настроена вторая учетная запись хранения, записи в кэш реплик записываются в эту вторую учетную запись хранения.)
New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "Central US" -Size P1 -Sku "Premium" -RedisConfiguration @{"aof-backup-enabled" = "true"; "aof-storage-connection-string-0" = "DefaultEndpointsProtocol=https;AccountName=mystorageaccount;AccountKey=******;EndpointSuffix=mySuffix"}

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  : creating
          SslPort            : 6380
          RedisConfiguration : {[maxmemory-policy, allkeys-random], [maxclients, 7500], [maxmemory-reserved, 200],
                                [maxfragmentationmemory-reserved, 300], [aof-backup-enabled, true]...}
          EnableNonSslPort   : False
          RedisVersion       : 4.0.14
          Size               : 6GB
          Sku                : Premium
          Tag                : {}
          Zone               : []

Параметры

-Confirm

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

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DefaultProfile

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

Тип:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DisableAccessKeyAuthentication

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

Тип:String
Position:Named
Default value:false
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-EnableNonSslPort

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

Тип:Nullable<T>[Boolean]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-IdentityType

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

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Location

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

  • Северная часть США
  • Южная часть США
  • Центральная часть США
  • Западная Европа
  • Северная Европа
  • Западная часть США
  • Восточная часть США
  • Восточная часть США 2
  • Восточная Япония
  • Западная Япония
  • Южная Бразилия
  • Юго-Восточная Азия
  • Восточная Азия
  • Восточная Австралия
  • Юго-Восточная Австралия
Тип:String
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-MinimumTlsVersion

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

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Name

Указывает имя создаваемого кэша Redis.

Тип:String
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-RedisConfiguration

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

  • функция rdb-backup с поддержкой резервного копирования. Указывает, что сохраняемость данных Redis включена. Только уровень "Премиум".
  • rdb-storage-connection-string. Указывает строку подключения к учетной записи хранения для сохраняемости данных Redis. Только уровень "Премиум".
  • частота резервного копирования rdb. Указывает частоту резервного копирования для сохраняемости данных 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. Настраивает оптимизацию памяти для небольших типов статистических данных. Уровни "Стандартный" и "Премиум".
  • Баз данных. Настраивает количество баз данных. Это свойство можно настроить только при создании кэша. Уровни "Стандартный" и "Премиум". Дополнительные сведения см. в статье "Управление кэшем Redis Azure" с помощью Azure PowerShellhttp://go.microsoft.com/fwlink/?LinkId=800051 (http://go.microsoft.com/fwlink/?LinkId=800051).
  • Предпочтительный метод проверки подлинности с данными-archive-auth-method , используемый для обмена данными с учетной записью хранения, используемой для архива данных, укажите SAS или ManagedIdentity, значение по умолчанию — SAS
  • Предпочтительный метод проверки подлинности с данными-сохраняемостью и методом предпочтительным методом проверки подлинности для обмена данными, используемым для сохраняемости данных, указание SAS или ManagedIdentity, значением по умолчанию является SAS
Тип:Hashtable
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-RedisVersion

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

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-ResourceGroupName

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

Тип:String
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-ShardCount

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

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
Тип:Nullable<T>[Int32]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Size

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

  • P1
  • P2
  • P3
  • P4
  • P5
  • C0
  • C1
  • C2
  • C3
  • C4
  • C5
  • C6
  • 250 МБ
  • 1 ГБ
  • 2,5 ГБ
  • 6 ГБ
  • 13 ГБ
  • 26 ГБ
  • 53 ГБ Значение по умолчанию — 1 ГБ или C1.
Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Sku

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

  • Основной
  • Стандарт
  • Значение по умолчанию — "Стандартный".
Тип:String
Допустимые значения:Basic, Standard, Premium
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-StaticIP

Указывает уникальный IP-адрес в подсети кэша Redis. Если значение этого параметра не указано, этот командлет выбирает IP-адрес из подсети.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-SubnetId

Полный идентификатор ресурса подсети в виртуальной сети для развертывания кэша Azure для Redis. Пример формата: /subscriptions/{subid}/resourceGroups/{resourceGroupName}/Microsoft. {Сеть|ClassicNetwork}/VirtualNetworks/{vnetName}/subnets/{subnetName}

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Tag

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

Тип:Hashtable
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-TenantSettings

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

Тип:Hashtable
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-UpdateChannel

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

Тип:String
Position:Named
Default value:Stable
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-UserAssignedIdentity

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

Тип:String[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-WhatIf

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

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ZonalAllocationPolicy

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

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Zone

Список регионов Azure с зонами доступности .

Тип:String[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

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

String

Hashtable

Nullable<T>[[System.Boolean, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

Nullable<T>[[System.Int32, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

String[]

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

RedisCacheAttributesWithAccessKeys