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


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

Это свойство можно включить или отключить, чтобы разрешить или запретить доступ с помощью текущих ключей доступа. Можно обновлять даже после создания базы данных.

Свойства параметра

Тип:AccessKeysAuthentication
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

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).

Свойства параметра

Тип:ManagedServiceIdentityType
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(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.

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

ICluster