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>]
   [-SubnetId <String>]
   [-StaticIP <String>]
   [-Tag <Hashtable>]
   [-Zone <String[]>]
   [-RedisVersion <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         : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          SecondaryKey       : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          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 ценовой категории "Стандартный"

New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "North Central US" -Size 250MB -Sku "Standard" -RedisConfiguration @{"maxmemory-policy" = "allkeys-random"}

PrimaryKey         : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          SecondaryKey       : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          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         : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          SecondaryKey       : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          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 в зонах mutliple.

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

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

  1. Создайте виртуальную сеть в той же группе ресурсов, в которой нужно создать кэш Redis. Вы можете создать виртуальную сеть из команды PowerShell New-AzVirtualNetwork .
  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         : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          SecondaryKey       : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          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, так как указанное хранилище отличается более высокой пропускной способностью.

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

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

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

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

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

  • rdb-backup-enabled (set true или false)
  • rdb-storage-connection-string (присвойте строке подключения в приведенном выше формате.)
  • rdb-backup-frequency (задайте интервал резервного копирования в минутах. Вы можете выбрать только 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=pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=;EndpointSuffix=core.windows.net"; "rdb-backup-frequency" = "30"}

PrimaryKey         : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          SecondaryKey       : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          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=pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=;EndpointSuffix=core.windows.net"}

PrimaryKey         : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          SecondaryKey       : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          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

Запрос подтверждения перед выполнением командлета.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-EnableNonSslPort

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

Type:Nullable<T>[Boolean]
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-IdentityType

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

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Location

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

  • Центрально-северная часть США
  • Центрально-южная часть США
  • Центральная часть США
  • Западная Европа
  • Северная Европа
  • западная часть США
  • Восточная часть США
  • восточная часть США 2
  • Восточная Япония
  • Западная Япония
  • Brazil South
  • Юго-Восточная Азия
  • Восточная Азия
  • Восточная Австралия
  • Юго-Восточная часть Австралии
Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-MinimumTlsVersion

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

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-RedisConfiguration

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

  • 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. Настраивает оптимизацию памяти для небольших статистических типов данных. Уровни "Стандартный" и "Премиум".
  • базы данных. Определяет количество баз данных. Это свойство можно настроить только в момент создания кэша. Уровни "Стандартный" и "Премиум". Дополнительные сведения см. в статье "Управление кэшем Redis для Azure" с помощью Azure PowerShellhttp://go.microsoft.com/fwlink/?LinkId=800051 (http://go.microsoft.com/fwlink/?LinkId=800051).
Type:Hashtable
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-RedisVersion

Версия Redis. Допустимые значения: 4, 6

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

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

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-ShardCount

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

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
Type:Nullable<T>[Int32]
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Size

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

  • P1
  • P2
  • P3
  • P4
  • P5
  • C0
  • C1
  • C2
  • C3
  • C4
  • C5
  • C6
  • 250 МБ
  • 1 ГБ
  • 2,5 ГБ
  • 6Gb
  • 13 ГБ
  • 26 ГБ
  • 53 ГБ Значение по умолчанию — 1 ГБ или C1.
Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Sku

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

  • Basic
  • Standard
  • Значение по умолчанию — "Стандартный".
Type:String
Accepted values:Basic, Standard, Premium
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-StaticIP

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

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-SubnetId

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

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Tag

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

Type:Hashtable
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-TenantSettings

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

Type:Hashtable
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-UserAssignedIdentity

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

Type:String[]
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Zone

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

Type:String[]
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters: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