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>]
[-UpdateChannel <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 уровня "Стандартный" SKU
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 в зонах мутировки.
Пример 4. Создание виртуальная сеть включения кэша
Требования к созданию виртуальная сеть включить кэш.
- Создайте виртуальную сеть в той же группе ресурсов, в которой требуется создать кэш Redis. Вы можете создать виртуальную сеть из команды PowerShell New-AzVirtualNetwork .
- Вам потребуется 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, так как указанное хранилище отличается более высокой пропускной способностью.
После создания учетной записи хранения получите строка подключения учетной записи хранения с помощью этой процедуры.
- Выполните эту команду Get-Az служба хранилища AccountKey -ResourceGroupName $resourceGroupName -Name $storageAccountName в PowerShell.
- Из выходных данных выше скопируйте любой ключ.
- Поместите ключ учетной записи хранения и имя учетной записи хранения в формате ниже, чтобы получить строка подключения учетной записи хранения.
формат строки Подключение ion:- "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=pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=;EndpointSuffix=mySuffix"; "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=mySuffix"}
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
Запрос подтверждения перед выполнением командлета.
Тип: | SwitchParameter |
Aliases: | cf |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure.
Тип: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableNonSslPort
Определяет, включен ли порт без SSL. Значение по умолчанию — $False (порт, отличный от SSL, отключен).
Тип: | Nullable<T>[Boolean] |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-IdentityType
Указывает тип удостоверения, используемого для Кэш Azure для Redis. Допустимые значения: SystemAssigned или UserAssigned или SystemAssignedUserAssigned Или None
Тип: | String |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Location
Указывает расположение, в котором создается кэш Redis. Допустимые значения:
- Центрально-северная часть США
- Центрально-южная часть США
- Центральная часть США
- Западная Европа
- Северная Европа
- западная часть США
- Восточная часть США
- Восточная часть США 2
- Восточная Япония
- Западная Япония
- Южная Бразилия
- Юго-Восточная Азия
- Восточная Азия
- Восточная Австралия
- Юго-Восточная часть Австралии
Тип: | String |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-MinimumTlsVersion
Укажите версию TLS, необходимую клиентами для подключения к кэшу.
Тип: | String |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Указывает имя создаваемого кэша Redis.
Тип: | String |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-RedisVersion
Версия Redis. Это должно быть в форме "major[.minor]" (только "основной" является обязательным) или значение "latest", которое относится к последней стабильной версии Redis, доступной. Поддерживаемые версии: 4.0, 6.0 (последняя версия). Значение по умолчанию — "latest".
Тип: | String |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ResourceGroupName
Указывает имя группы ресурсов, в которой создается кэш Redis.
Тип: | String |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ShardCount
Указывает количество сегментов, создаваемых в кэше кластера Premium. Допустимые значения для этого параметра:
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
Тип: | Nullable<T>[Int32] |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
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.
Тип: | String |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Sku
Указывает номер SKU создаваемого кэша Redis. Допустимые значения:
- Basic
- Standard
- Значение по умолчанию — "Стандартный".
Тип: | String |
допустимые значения: | Basic, Standard, Premium |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-StaticIP
Указывает уникальный IP-адрес в подсети кэша Redis. Если значение этого параметра не указано, этот командлет выбирает IP-адрес из подсети.
Тип: | String |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SubnetId
Полный идентификатор ресурса подсети в виртуальной сети для развертывания Кэш Azure для Redis. Пример формата: /subscriptions/{subid}/resourceGroups/{resourceGroupName}/Microsoft. {Сеть|ClassicNetwork}/VirtualNetworks/{vnetName}/subnets/{subnetName}
Тип: | String |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Tag
Хэш-таблица, представляющая теги.
Тип: | Hashtable |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TenantSettings
Этот параметр устарел.
Тип: | Hashtable |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-UpdateChannel
Необязательно. Указывает канал обновления для ежемесячного обновления Redis, который будет получать кэш Redis. Кэши с помощью канала обновления "Предварительная версия" получают последние обновления Redis по крайней мере через 4 недели перед кэшем каналов "Стабильный". Значение по умолчанию — "Стабильный". Возможные значения: "Стабильный", "Предварительная версия"
Тип: | String |
Position: | Named |
значение по умолчанию: | Stable |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-UserAssignedIdentity
Указывает одно или несколько удостоверений пользователей, разделенных запятыми, которые должны быть связаны с Кэш Azure для Redis. Ссылки на удостоверения пользователя будут идентификаторами ресурсов ARM в форме: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identityes/{identityName}"
Тип: | String[] |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Показывает, что произойдет при запуске командлета. Командлет не выполняется.
Тип: | SwitchParameter |
Aliases: | wi |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Zone
Список регионов Azure с зонами доступности.
Тип: | String[] |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по