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

New-AzRedisCache

模块:: Az.RedisCache Module

创建 Redis 缓存。

语法

Default (默认值)

New-AzRedisCache
    -ResourceGroupName <String>
    -Name <String>
    -Location <String>
    [-Size <String>]
    [-Sku <String>]
    [-RedisConfiguration <Hashtable>]
    [-EnableNonSslPort <Boolean>]
    [-TenantSettings <Hashtable>]
    [-ShardCount <Int32>]
    [-MinimumTlsVersion <String>]
    [-DisableAccessKeyAuthentication <Boolean>]
    [-SubnetId <String>]
    [-StaticIP <String>]
    [-Tag <Hashtable>]
    [-Zone <String[]>]
    [-RedisVersion <String>]
    [-UpdateChannel <String>]
    [-ZonalAllocationPolicy <String>]
    [-IdentityType <String>]
    [-UserAssignedIdentity <String[]>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

New-AzRedisCache cmdlet 创建 Azure Redis 缓存。

示例

示例 1：创建 Redis 缓存

New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "North Central US"

          PrimaryKey         : ******
          SecondaryKey       : ******
          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：创建标准 SKU Redis 缓存

New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "North Central US" -Size 250MB -Sku "Standard" -RedisConfiguration @{"maxmemory-policy" = "allkeys-random"}

          PrimaryKey         : ******
          SecondaryKey       : ******
          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               : []

此 cmdlet 使用Azure Cache for Redis创建缓存。

示例 3：创建区域冗余缓存

New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "Central US" -Size P1 -Sku "Premium" -Zone @("1","2")

          PrimaryKey         : ******
          SecondaryKey       : ******
          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}

此命令在多个区域中为 Redis 实例创建Azure缓存。

示例 4：创建启用缓存Virtual Network

创建Virtual Network启用缓存的要求。

在要在其中创建 redis 缓存的同一资源组中创建虚拟网络。可以从 New-AzVirtualNetwork powershell 命令创建虚拟网络。
需要为 VNET 启用缓存提供 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         : ******
          SecondaryKey       : ******
          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 Cache for Redis配置数据持久性

持久性将 Redis 数据写入你拥有和管理的Azure Storage帐户中。因此，在配置数据持久性之前，需要在同一资源组中具有存储帐户。选择与缓存位于同一区域和订阅中的存储帐户，建议使用Premium Storage帐户，因为premium storage吞吐量较高。

创建存储帐户后，使用此过程获取存储帐户connection string。

在 powershell 中 Get-AzStorageAccountKey -ResourceGroupName $resourceGroupName -Name $storageAccountName 运行以下命令。
从上述输出中，复制任何密钥。
将存储帐户密钥和存储帐户名称的格式设置为下面的格式，以获取存储帐户的connection string。

连接字符串格式：- “DefaultEndpointsProtocol=https;AccountName={storageAccountName};AccountKey={storageAccountKey};EndpointSuffix=mySuffix”

必须具有特定的 Redis 配置设置才能启用数据持久性。

启用 RDB 备份

已启用 rdb-backup-enabled （设置 true 或 false）
rdb-storage-connection-string （以上述格式提供connection string）。
rdb-backup-frequency （以分钟为单位设置备份间隔）。只能选择 - 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=******;EndpointSuffix=mySuffix"; "rdb-backup-frequency" = "30"}

          PrimaryKey         : ******
          SecondaryKey       : ******
          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 Cache for Redis配置数据暂留 - 已启用 AOF 备份

启用 AOF 备份。

aof-backup-enabled （设置为 true 或 false），
aof-storage-connection-string-0 （采用上述格式提供connection string。
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=******;EndpointSuffix=mySuffix"}

          PrimaryKey         : ******
          SecondaryKey       : ******
          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

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

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False
别名:	Cf

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-DefaultProfile

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

参数属性

类型:	IAzureContextContainer
默认值:	None
支持通配符:	False
不显示:	False
别名:	AzContext, AzureRmContext, AzureCredential

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-DisableAccessKeyAuthentication

可选：如果设置为 true，则会禁用通过访问密钥向 Redis 进行身份验证。默认值为 false。

参数属性

类型:	String
默认值:	false
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-EnableNonSslPort

指示是否启用非 SSL 端口。默认值为$False（禁用非 SSL 端口）。

参数属性

类型:	Nullable<T>[Boolean]
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-IdentityType

指定用于Azure Cache for Redis的标识类型。有效值：“SystemAssigned”或“UserAssigned”或“SystemAssignedUserAssigned”或“None”

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-Location

指定要在其中创建 Redis 缓存的位置。有效值为：

美国中北部
美国中南部
美国中部
西欧
北欧
美国西部
美国东部
美国东部 2
日本东部
日本西部
Brazil South
东南亚
东亚
Australia East
澳大利亚东南部

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-MinimumTlsVersion

指定客户端连接到缓存所需的 TLS 版本。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-Name

指定要创建的 Redis 缓存的名称。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-RedisConfiguration

指定 Redis 配置设置。此参数的可接受值为：

已启用 rdb-backup-enabled。指定已启用 Redis 数据持久性。仅限高级层。
rdb-storage-connection-string。指定 Redis 数据持久性存储帐户的connection string。仅限高级层。
rdb-backup-frequency。指定 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。为小型聚合数据类型配置内存优化。标准和高级层。
数据库。配置数据库数。该属性只能在创建缓存时配置。标准和高级层。有关详细信息，请参阅使用 Azure PowerShellhttp://go.microsoft.com/fwlink/?LinkId=800051 管理 Azure Redis 缓存（http://go.microsoft.com/fwlink/?LinkId=800051）。
preferred-data-archive-auth-method Preferred auth 方法，用于与用于数据存档的存储帐户通信，指定 SAS 或 ManagedIdentity，默认值为 SAS
preferred-data-persistence-auth-method Preferred auth 方法，用于与用于数据暂留的存储帐户通信，指定 SAS 或 ManagedIdentity，默认值为 SAS

参数属性

类型:	Hashtable
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-RedisVersion

Redis 版本。这应采用“major[.minor]”（仅需要“major”）或值“latest”，该值引用可用的最新稳定 Redis 版本。支持的版本：4.0、6.0（最新版）。默认值为“latest”。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-ResourceGroupName

指定要在其中创建 Redis 缓存的资源组的名称。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-ShardCount

指定要在高级群集缓存上创建的分片数。此参数的可接受值为：

参数属性

类型:	Nullable<T>[Int32]
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-Size

指定 Redis 缓存的大小。有效值为：

P1
P2
P3
P4
P5
C0
C1
C2
C3
C4
C5
C6
250兆字节
1GB
2.5GB
6GB
13GB
26GB
53GB 默认值为 1GB 或 C1。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-Sku

指定要创建的 Redis 缓存的 SKU。有效值为：

基本
标准
高级默认值为 Standard。

参数属性

类型:	String
默认值:	None
接受的值:	Basic, Standard, Premium
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-StaticIP

指定 Redis 缓存子网中的唯一 IP 地址。如果未为此参数指定值，此 cmdlet 将从子网中选择 IP 地址。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-SubnetId

要在其中部署Azure Cache for Redis的虚拟网络中子网的完整资源 ID。示例格式：/subscriptions/{subid}/resourceGroups/{resourceGroupName}/Microsoft。{Network|ClassicNetwork}/VirtualNetworks/{vnetName}/subnets/{subnetName}

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-Tag

表示标记的哈希表。

参数属性

类型:	Hashtable
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-TenantSettings

此参数已弃用。

参数属性

类型:	Hashtable
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-UpdateChannel

可选：指定 Redis 缓存将接收的每月 Redis 更新的更新通道。使用“预览”更新通道的缓存在“稳定”通道缓存之前至少提前 4 周获取最新的 Redis 更新。默认值为“Stable”。可能的值包括：“Stable”、“Preview”

参数属性

类型:	String
默认值:	Stable
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-UserAssignedIdentity

指定要与Azure Cache for Redis关联的一个或多个逗号分隔的用户标识。用户标识引用的格式为 ARM 资源 ID：“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identities/{identityName}”

参数属性

类型:	String[]
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-WhatIf

显示 cmdlet 运行时会发生什么情况。命令脚本未运行。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False
别名:	无线

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ZonalAllocationPolicy

可选：可选：指定如何将可用性区域分配给 Redis 缓存。 “自动”启用区域冗余，Azure将根据区域可用性和容量自动选择区域。 “UserDefined”将使用“zone”参数选择传入的可用性区域。 “NoZones”将生成非区域性缓存。如果未传递“zonalAllocationPolicy”，则会在传入区域时将其设置为“UserDefined”，否则，在不支持区域的区域中，将设置为“自动”，在不支持区域的区域中将其设置为“NoZones”。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-Zone

具有 Availability 区域的Azure区域列表。

参数属性

类型:	String[]
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

CommonParameters

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。有关详细信息，请参阅 about_CommonParameters。