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

New-AzRedisEnterpriseCache

参考

模块:: Az.RedisEnterpriseCache

创建 Redis Enterprise 缓存。

语法

New-AzRedisEnterpriseCache
   -ClusterName <String>
   -ResourceGroupName <String>
   -Location <String>
   -Sku <SkuName>
   [-SubscriptionId <String>]
   [-AofPersistenceEnabled]
   [-AofPersistenceFrequency <AofFrequency>]
   [-Capacity <Int32>]
   [-ClientProtocol <Protocol>]
   [-ClusteringPolicy <ClusteringPolicy>]
   [-CustomerManagedKeyEncryptionKeyUrl <String>]
   [-EvictionPolicy <EvictionPolicy>]
   [-GroupNickname <String>]
   [-IdentityType <ManagedServiceIdentityType>]
   [-IdentityUserAssignedIdentity <Hashtable>]
   [-KeyEncryptionKeyIdentityType <CmkIdentityType>]
   [-KeyEncryptionKeyIdentityUserAssignedIdentityResourceId <String>]
   [-LinkedDatabase <ILinkedDatabase[]>]
   [-MinimumTlsVersion <TlsVersion>]
   [-Module <IModule[]>]
   [-Port <Int32>]
   [-RdbPersistenceEnabled]
   [-RdbPersistenceFrequency <RdbFrequency>]
   [-Tag <Hashtable>]
   [-Zone <String[]>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]

New-AzRedisEnterpriseCache
   -ClusterName <String>
   -ResourceGroupName <String>
   -Location <String>
   -Sku <SkuName>
   -NoDatabase
   [-SubscriptionId <String>]
   [-Capacity <Int32>]
   [-CustomerManagedKeyEncryptionKeyUrl <String>]
   [-IdentityType <ManagedServiceIdentityType>]
   [-IdentityUserAssignedIdentity <Hashtable>]
   [-KeyEncryptionKeyIdentityType <CmkIdentityType>]
   [-KeyEncryptionKeyIdentityUserAssignedIdentityResourceId <String>]
   [-MinimumTlsVersion <TlsVersion>]
   [-Tag <Hashtable>]
   [-Zone <String[]>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-Confirm]
   [-WhatIf]
   [<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 缓存副本 (replica)数据库

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副本 (replica)

参数

-AofPersistenceEnabled

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AofPersistenceFrequency

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

Type:	AofFrequency
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AsJob

以作业身份运行命令

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Capacity

Redis Enterprise 群集的大小 - 默认为 2 或 3，具体取决于 SKU。允许的值为（2、4、6、...）（企业 SKU）和（3、9、15、...）（对于 Flash SKU）。

Type:	Int32
Aliases:	SkuCapacity
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ClientProtocol

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

Type:	Protocol
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ClusteringPolicy

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

Type:	ClusteringPolicy
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ClusterName

Redis Enterprise 群集的名称。

Type:	String
Aliases:	Name
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CustomerManagedKeyEncryptionKeyUrl

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

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

Type:	PSObject
Aliases:	AzureRMContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EvictionPolicy

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

Type:	EvictionPolicy
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-GroupNickname

链接数据库资源组的名称

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IdentityType

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

Type:	ManagedServiceIdentityType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IdentityUserAssignedIdentity

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

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-KeyEncryptionKeyIdentityType

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

Type:	CmkIdentityType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-KeyEncryptionKeyIdentityUserAssignedIdentityResourceId

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-LinkedDatabase

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

Type:	ILinkedDatabase[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Location

资源所在的地理位置。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-MinimumTlsVersion

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

Type:	TlsVersion
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Module

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

Type:	IModule[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoDatabase

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-NoWait

异步运行命令

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Port

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

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RdbPersistenceEnabled

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RdbPersistenceFrequency

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

Type:	RdbFrequency
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

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

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Sku

要部署的 Redis Enterprise 群集的类型。允许的值：Enterprise_E10、Enterprise_E20、Enterprise_E50、Enterprise_E100、EnterpriseFlash_F300、EnterpriseFlash_F700、EnterpriseFlash_F1500

Type:	SkuName
Aliases:	SkuName
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-SubscriptionId

目标订阅的 ID。

Type:	String
Position:	Named
Default value:	(Get-AzContext).Subscription.Id
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Tag

群集资源标记。

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Zone

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

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

输出

ICluster

备注

别名

复杂参数属性

若要创建下面所述的参数，请构造一个包含相应属性的哈希表。有关哈希表的信息，请运行 Get-Help about_Hash_Tables。

LINKEDDATABASE <ILinkedDatabase[]>：要与此数据库链接的数据库资源列表，请参阅 GEOREPLICATIONLINKEDDATABA 的 NOTES 部分标准版属性并创建哈希表。

[Id <String>]：要链接到此数据库的数据库资源的资源 ID。

MODULE <IModule[]>：在此数据库中启用的可选 redis 模块集 - 只能在创建时添加模块。

Name <String>：模块的名称，例如“RedisBloom”、“RediSearch”、“RedisTimeSeries”
[Arg <String>]：模块的配置选项，例如“ERROR_RATE 0.01 INITIAL_SIZE 400”。

Share via