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. Создание кэша включения виртуальной сети
Требования к созданию кэша для виртуальной сети.
- Создайте виртуальную сеть в той же группе ресурсов, в которой требуется создать кэш Redis. Вы можете создать виртуальную сеть из команды New-AzVirtualNetwork powershell.
- Вам потребуется 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 имеет более высокую пропускную способность.
После создания учетной записи хранения получите строку подключения учетной записи хранения с помощью этой процедуры.
- Выполните эту команду Get-AzStorageAccountKey -ResourceGroupName $resourceGroupName -Name $storageAccountName в PowerShell.
- Из выходных данных выше скопируйте любой ключ.
- Поместите ключ учетной записи хранения и имя учетной записи хранения в формате ниже, чтобы получить строку подключения учетной записи хранения.
Формат строки подключения:- 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 |
Входные данные
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
Связанные ссылки
Azure PowerShell