你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

New-AzRedisEnterpriseCache

参考

模块:: Az.RedisEnterpriseCache

创建 Redis Enterprise 缓存。

语法

New-AzRedisEnterpriseCache
   -ClusterName <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Location <String>
   -Sku <SkuName>
   [-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>]

New-AzRedisEnterpriseCache
   -ClusterName <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Location <String>
   -Sku <SkuName>
   [-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}

此命令使用名为 default 的关联数据库创建名为 MyCache 的 Redis Enterprise 缓存。

示例 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}

此命令使用一些可选参数创建名为 MyCache 的 Redis Enterprise 缓存，该缓存具有名为默认值的关联数据库。

示例 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      {}

警告：此命令创建名为 MyCache 的 Redis Enterprise 缓存群集，而无需任何关联的数据库来保存数据。

示例 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}

此命令使用名为 default 的异地复制数据库创建缓存名称 MyCache

参数

-AccessKeysAuthentication

此属性可以启用/禁用，以允许或拒绝使用当前访问密钥的访问。即使在创建数据库后也可以更新。

类型:	AccessKeysAuthentication
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-AofPersistenceEnabled

[预览]设置是否启用 AOF 持久性。启用 AOF 持久性后，将无法禁用它。稍后将添加启用后禁用 AOF 持久性的支持。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-AofPersistenceFrequency

[预览]设置启用 AOF 持久性时将数据写入磁盘的频率。允许的值：1s，始终

类型:	AofFrequency
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-AsJob

以作业身份运行命令

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Capacity

RedisEnterprise 群集的大小。默认为 2 或 3 或不适用，具体取决于 SKU。Enterprise_* SKU 的有效值为（2， 4， 6， ...），对于 EnterpriseFlash_* SKU，有效值为（3、9、15、...）。不支持其他 SKU 容量参数。

类型:	Int32
别名:	SkuCapacity
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ClientProtocol

指定 redis 客户端是否可以使用 TLS 加密或纯文本 redis 协议进行连接 - 默认值为加密允许的值：加密、纯文本

类型:	Protocol
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ClusteringPolicy

群集策略 - 默认为创建时指定的 OSSCluster。允许的值：EnterpriseCluster、OSSCluster

类型:	ClusteringPolicy
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ClusterName

Redis Enterprise 群集的名称。

类型:	String
别名:	Name
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Confirm

在运行 cmdlet 之前，提示你进行确认。

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-CustomerManagedKeyEncryptionKeyUrl

仅对密钥加密密钥 URL 进行版本控制。例如：https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78"

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

类型:	PSObject
别名:	AzureRMContext, AzureCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-EvictionPolicy

Redis 逐出策略 - 默认值为 VolatileLRU 允许的值：AllKeysLFU、AllKeysLRU、AllKeysRandom、VolatileLRU、VolatileLFU、VolatileTTL、VolatileRandom、NoEviction

类型:	EvictionPolicy
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-GroupNickname

链接数据库资源组的名称

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-HighAvailability

默认启用。只能从禁用更新为启用。如果禁用 highAvailability，则不会复制数据集。这会影响可用性 SLA，并增加数据丢失的风险。

类型:	HighAvailability
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-IdentityType

托管服务标识的类型（其中允许 SystemAssigned 和 UserAssigned 类型）。

类型:	ManagedServiceIdentityType
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-IdentityUserAssignedIdentity

与资源关联的用户分配标识集。 userAssignedIdentities 字典密钥将为 ARM 资源 ID，格式为“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}”。字典值可以是请求中的空对象（{}）。

类型:	Hashtable
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-KeyEncryptionKeyIdentityType

此 API 版本仅支持 userAssignedIdentity;将来可能支持其他类型的

类型:	CmkIdentityType
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-KeyEncryptionKeyIdentityUserAssignedIdentityResourceId

用户分配的标识用于访问密钥加密密钥 URL。例如：/subscriptions/<sub uuid>/resourceGroups/<资源组>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-LinkedDatabase

要与此数据库链接的数据库资源列表，请参阅 GEOREPLICATIONLINKEDDATABASE 属性的 NOTES 部分，并创建哈希表。若要构造，请参阅 LINKEDDATABASE 属性的 NOTES 部分并创建哈希表。

类型:	ILinkedDatabase[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Location

资源所在的地理位置。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-MinimumTlsVersion

要支持的群集的最低 TLS 版本 - 默认值为 1.2 允许的值：1.0、1.1、1.2

类型:	TlsVersion
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Module

在此数据库中启用的可选 redis 模块集 - 只能在创建时添加模块。若要构造，请参阅 MODULE 属性的 NOTES 部分并创建哈希表。

类型:	IModule[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-NoDatabase

高级 - 不自动创建默认数据库。警告：在创建数据库之前，缓存将不可用。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-NoWait

异步运行命令

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Port

数据库终结点的 TCP 端口 - 默认为创建时指定的可用端口。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RdbPersistenceEnabled

[预览]设置是否启用 RDB 持久性。启用 RDB 暂留后，将无法禁用它。在启用后禁用 RDB 暂留的支持将在以后添加。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RdbPersistenceFrequency

[预览]设置启用 RDB 暂留时创建数据库快照的频率。允许的值：1h、6h、12h

类型:	RdbFrequency
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ResourceGroupName

资源组的名称。名称不区分大小写。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	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
别名:	SkuName
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-SubscriptionId

目标订阅的 ID。

类型:	String
Position:	Named
默认值:	(Get-AzContext).Subscription.Id
必需:	False
接受管道输入:	False
接受通配符:	False

-Tag

群集资源标记。

类型:	Hashtable
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Zone

将部署此群集的可用性区域。

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输出

ICluster

通过