New-AzRedisEnterpriseCache
Создает кэш Redis Enterprise.
Синтаксис
CreateClusterWithDatabase (по умолчанию)
New-AzRedisEnterpriseCache
-ClusterName <String>
-ResourceGroupName <String>
-Location <String>
-Sku <SkuName>
[-SubscriptionId <String>]
[-Capacity <Int32>]
[-MinimumTlsVersion <TlsVersion>]
[-Zone <String[]>]
[-Tag <Hashtable>]
[-Module <IModule[]>]
[-ClientProtocol <Protocol>]
[-Port <Int32>]
[-EvictionPolicy <EvictionPolicy>]
[-GroupNickname <String>]
[-LinkedDatabase <ILinkedDatabase[]>]
[-ClusteringPolicy <ClusteringPolicy>]
[-AccessKeysAuthentication <AccessKeysAuthentication>]
[-CustomerManagedKeyEncryptionKeyUrl <String>]
[-HighAvailability <HighAvailability>]
[-IdentityType <ManagedServiceIdentityType>]
[-IdentityUserAssignedIdentity <Hashtable>]
[-KeyEncryptionKeyIdentityType <CmkIdentityType>]
[-KeyEncryptionKeyIdentityUserAssignedIdentityResourceId <String>]
[-AofPersistenceEnabled]
[-AofPersistenceFrequency <AofFrequency>]
[-RdbPersistenceEnabled]
[-RdbPersistenceFrequency <RdbFrequency>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
CreateClusterOnly
New-AzRedisEnterpriseCache
-ClusterName <String>
-ResourceGroupName <String>
-Location <String>
-Sku <SkuName>
[-SubscriptionId <String>]
[-Capacity <Int32>]
[-MinimumTlsVersion <TlsVersion>]
[-Zone <String[]>]
[-Tag <Hashtable>]
[-CustomerManagedKeyEncryptionKeyUrl <String>]
[-HighAvailability <HighAvailability>]
[-IdentityType <ManagedServiceIdentityType>]
[-IdentityUserAssignedIdentity <Hashtable>]
[-KeyEncryptionKeyIdentityType <CmkIdentityType>]
[-KeyEncryptionKeyIdentityUserAssignedIdentityResourceId <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-NoDatabase]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Создает или обновляет существующий кластер кэша кэша (перезапись или повторное создание с потенциальным временем простоя) с связанной базой данных.
Примеры
Пример 1. Создание кэша Redis Enterprise
New-AzRedisEnterpriseCache -Name "MyCache" -ResourceGroupName "MyGroup" -Location "West US" -Sku "Enterprise_E10"
Location Name Type Zone Database
-------- ---- ---- ---- --------
West US MyCache Microsoft.Cache/redisEnterprise {default}
Эта команда создает кэш Redis Enterprise с именем MyCache с связанной базой данных по умолчанию.
Пример 2. Создание кэша Redis Enterprise с помощью некоторых необязательных параметров
New-AzRedisEnterpriseCache -Name "MyCache" -ResourceGroupName "MyGroup" -Location "East US" -Sku "Enterprise_E20" -Capacity 4 -MinimumTlsVersion "1.2" -Zone "1","2","3" -Tag @{"tag1" = "value1"} -Module "{name:RedisBloom, args:`"ERROR_RATE 0.00 INITIAL_SIZE 400`"}","{name:RedisTimeSeries, args:`"RETENTION_POLICY 20`"}","{name:RediSearch}" -ClientProtocol "Plaintext" -EvictionPolicy "NoEviction" -ClusteringPolicy "EnterpriseCluster" -AofPersistenceEnabled -AofPersistenceFrequency "1s"
Location Name Type Zone Database
-------- ---- ---- ---- --------
East US MyCache Microsoft.Cache/redisEnterprise {1, 2, 3} {default}
Эта команда создает кэш Redis Enterprise с именем MyCache с связанной базой данных по умолчанию, используя некоторые необязательные параметры.
Пример 3. Дополнительно. Создание кластера кэша Redis Enterprise без связанной базы данных
New-AzRedisEnterpriseCache -Name "MyCache" -ResourceGroupName "MyGroup" -Location "East US" -Sku "EnterpriseFlash_F300" -NoDatabase
Location Name Type Zone Database
-------- ---- ---- ---- --------
East US MyCache Microsoft.Cache/redisEnterprise {}
Предупреждение. Эта команда создает кластер кэша Redis Enterprise с именем MyCache без связанной базы данных для хранения данных.
Пример 4. Создание кэша Redis Enterprise с геореплицированной базой данных
New-AzRedisEnterpriseCache -Name "MyCache" -ResourceGroupName "MyGroup" -Location "West US" -Sku "Enterprise_E10" -ClientProtocol "Encrypted" -EvictionPolicy "NoEviction" -ClusteringPolicy "EnterpriseCluster" -GroupNickname "GroupNickname" -LinkedDatabase '{id:"/subscriptions/6b9ac7d2-7f6d-4de4-962c-43fda44bc3f2/resourceGroups/MyGroup/providers/Microsoft.Cache/redisEnterprise/MyCache/databases/default"}'
Location Name Type Zone Database
-------- ---- ---- ---- --------
West US MyCache Microsoft.Cache/redisEnterprise {default}
Эта команда создает имя кэша MyCache с геореплицированной базой данных с именем по умолчанию
Параметры
-AccessKeysAuthentication
Это свойство можно включить или отключить, чтобы разрешить или запретить доступ с помощью текущих ключей доступа.
Можно обновлять даже после создания базы данных.
Свойства параметра
Наборы параметров
CreateClusterWithDatabase
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-AofPersistenceEnabled
[предварительная версия] Задает, включена ли сохраняемость AOF.
После включения сохраняемости AOF вы не сможете отключить его.
Поддержка отключения сохраняемости AOF после включения будет добавлена позже.
Свойства параметра
Тип: SwitchParameter
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
CreateClusterWithDatabase
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-AofPersistenceFrequency
[предварительная версия] Задает частоту записи данных на диск, если включена сохраняемость AOF.
Допустимые значения: 1s, всегда
Свойства параметра
Тип: AofFrequency
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
CreateClusterWithDatabase
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-AsJob
Выполнение команды в качестве задания
Свойства параметра
Тип: SwitchParameter
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-Capacity
Размер кластера RedisEnterprise.
По умолчанию используется значение 2 или 3 или не применимо в зависимости от номера SKU. Допустимые значения: (2, 4, 6, ...) для номеров SKU Enterprise_* и (3, 9, 15, ...) для номеров SKU EnterpriseFlash_*.
Для других аргументов емкости SKU не поддерживается.
Свойства параметра
Тип: Int32
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Aliases: SkuCapacity
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-ClientProtocol
Указывает, могут ли клиенты Redis подключаться с помощью протоколов redis с шифрованием TLS или открытого текста. Значение по умолчанию — зашифрованные значения: Encrypted, Plaintext
Свойства параметра
Тип: Protocol
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
CreateClusterWithDatabase
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-ClusteringPolicy
Политика кластеризации — по умолчанию — OSSCluster Указан во время создания.
Допустимые значения: EnterpriseCluster, OSSCluster
Свойства параметра
Тип: ClusteringPolicy
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
CreateClusterWithDatabase
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-ClusterName
Имя кластера Redis Enterprise.
Свойства параметра
Тип: String
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Aliases: Имя
Наборы параметров
(All)
Position: Named
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-Confirm
Запрашивает подтверждение перед запуском cmdlet.
Свойства параметра
Тип: SwitchParameter
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Aliases: cf
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-CustomerManagedKeyEncryptionKeyUrl
Только url-адрес ключа шифрования ключей.
Бывший: https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78"
Свойства параметра
Тип: String
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-DefaultProfile
Учетные данные, учетная запись, клиент и подписка, используемые для взаимодействия с Azure.
Свойства параметра
Тип: PSObject
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Aliases: AzureRMContext, AzureCredential
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-EvictionPolicy
Политика вытеснения Redis— по умолчанию — это допустимые значения VolatileLRU: AllKeysLFU, AllKeysLRU, AllKeysRandom, VolatileLRU, VolatileLFU, VolatileTTL, VolatileRandom, NoEviction
Свойства параметра
Тип: EvictionPolicy
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
CreateClusterWithDatabase
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-GroupNickname
Имя группы ресурсов связанной базы данных
Свойства параметра
Тип: String
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
CreateClusterWithDatabase
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-HighAvailability
Включен по умолчанию.
Может быть обновлено только отключено.
Если высокая доступность отключена, набор данных не реплицируется.
Это влияет на соглашение об уровне обслуживания доступности и повышает риск потери данных.
Свойства параметра
Тип: HighAvailability
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-IdentityType
Тип управляемого удостоверения службы (где разрешены типы SystemAssigned и UserAssigned).
Свойства параметра
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-IdentityUserAssignedIdentity
Набор назначенных пользователем удостоверений, связанных с ресурсом.
Ключи словаря userAssignedIdentities будут идентификаторами ресурсов ARM в форме: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}.
Значения словаря могут быть пустыми объектами ({}) в запросах.
Свойства параметра
Тип: Hashtable
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-KeyEncryptionKeyIdentityType
В этой версии API поддерживается только userAssignedIdentity; Другие типы могут поддерживаться в будущем
Свойства параметра
Тип: CmkIdentityType
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-KeyEncryptionKeyIdentityUserAssignedIdentityResourceId
Назначаемое пользователем удостоверение для доступа к URL-адресу ключа шифрования ключей.
Ex: /subscriptions/<sub uuid>/resourceGroups/<resourceGroups/resource group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId.
Свойства параметра
Тип: String
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-LinkedDatabase
Список ресурсов базы данных для связывания с этой базой данных To, см. раздел NOTES для свойств GEOREPLICATIONLINKEDDATABASE и создание хэш-таблицы.
Сведения о создании см. в разделе NOTES свойств LINKEDDATABASE и создании хэш-таблицы.
Свойства параметра
Тип: ILinkedDatabase [ ]
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
CreateClusterWithDatabase
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-Location
Географическое расположение, в котором находится ресурс.
Свойства параметра
Тип: String
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
(All)
Position: Named
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-MinimumTlsVersion
Минимальная версия TLS для кластера для поддержки — значение по умолчанию — 1.2 Разрешенные значения: 1.0, 1.1, 1.2
Свойства параметра
Тип: TlsVersion
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-Module
Необязательный набор модулей redis для включения в этой базе данных — модули могут добавляться только во время создания.
Сведения о создании см. в разделе NOTES для свойств МОДУЛЯ и создании хэш-таблицы.
Свойства параметра
Тип: IModule [ ]
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
CreateClusterWithDatabase
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-NoDatabase
Дополнительно. Не создавайте базу данных по умолчанию автоматически.
Предупреждение. Кэш не будет использоваться, пока не создадите базу данных.
Свойства параметра
Тип: SwitchParameter
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
CreateClusterOnly
Position: Named
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-NoWait
Асинхронное выполнение команды
Свойства параметра
Тип: SwitchParameter
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-Port
TCP-порт конечной точки базы данных — по умолчанию используется доступный порт, указанный во время создания.
Свойства параметра
Тип: Int32
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
CreateClusterWithDatabase
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-RdbPersistenceEnabled
[предварительная версия] Задает, включена ли сохраняемость RDB.
После включения сохраняемости RDB вы не сможете отключить его.
Поддержка отключения сохраняемости RDB после включения будет добавлена позже.
Свойства параметра
Тип: SwitchParameter
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
CreateClusterWithDatabase
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-RdbPersistenceFrequency
[предварительная версия] Задает частоту создания моментального снимка базы данных, если включена сохраняемость RDB.
Допустимые значения: 1h, 6h, 12h
Свойства параметра
Тип: RdbFrequency
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
CreateClusterWithDatabase
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-ResourceGroupName
Имя группы ресурсов.
Имя не зависит от регистра.
Свойства параметра
Тип: String
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
(All)
Position: Named
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-Sku
Тип развернутого кластера RedisEnterprise.
Принятые значения: Balanced_B0, Balanced_B1, Balanced_B10 Balanced_B100, Balanced_B1000, Balanced_B150, Balanced_B20, Balanced_B250, Balanced_B3, Balanced_B350, Balanced_B5, Balanced_B50, Balanced_B500, Balanced_B700, ComputeOptimized_X10, ComputeOptimized_X100, ComputeOptimized_X150, ComputeOptimized_X20, ComputeOptimized_X250, ComputeOptimized_X3, ComputeOptimized_X350, ComputeOptimized_X5, ComputeOptimized_X50, ComputeOptimized_X500, ComputeOptimized_X700, EnterpriseFlash_F1500, EnterpriseFlash_F300, EnterpriseFlash_F700, Enterprise_E1, Enterprise_E10, Enterprise_E100, Enterprise_E20, Enterprise_E200, Enterprise_E400, Enterprise_E5, Enterprise_E50, FlashOptimized_A1000, FlashOptimized_A1500, FlashOptimized_A2000, FlashOptimized_A250, FlashOptimized_A4500, FlashOptimized_A500, FlashOptimized_A700, MemoryOptimized_M10, MemoryOptimized_M100, MemoryOptimized_M1000, MemoryOptimized_M150, MemoryOptimized_M1500, MemoryOptimized_ M20, MemoryOptimized_M2000, MemoryOptimized_M250, MemoryOptimized_M350, MemoryOptimized_M50, MemoryOptimized_M500, MemoryOptimized_M700
Свойства параметра
Тип: SkuName
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Aliases: Название SKU
Наборы параметров
(All)
Position: Named
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-SubscriptionId
Идентификатор целевой подписки.
Свойства параметра
Тип: String
Default value: (Get-AzContext).Subscription.Id
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-Tag
Теги ресурсов кластера.
Свойства параметра
Тип: Hashtable
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-WhatIf
Показывает, что произойдет, если командлет будет запущен.
Командлет не запускается.
Свойства параметра
Тип: SwitchParameter
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Aliases: wi
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-Zone
Зоны доступности, в которых будет развернут этот кластер.
Свойства параметра
Тип: String [ ]
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters .
Выходные данные