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

New-AzureRmRedisCache

参考

模块:: AzureRM.RedisCache

创建 Redis 缓存。

警告

AzureRM PowerShell 模块已自 2024 年 2 月 29 日起正式弃用。为了确保持续获得支持和更新，建议用户从 AzureRM 迁移到 Az PowerShell 模块。

尽管 AzureRM 模块仍可运行，但不再受到维护或支持，任何继续使用的行为都由用户自行决定并自行承担风险。有关过渡到 Az 模块的指导，请参阅我们的迁移资源。

语法

New-AzureRmRedisCache
   -ResourceGroupName <String>
   -Name <String>
   -Location <String>
   [-Size <String>]
   [-Sku <String>]
   [-RedisConfiguration <Hashtable>]
   [-EnableNonSslPort <Boolean>]
   [-TenantSettings <Hashtable>]
   [-ShardCount <Int32>]
   [-SubnetId <String>]
   [-StaticIP <String>]
   [-Tag <Hashtable>]
   [-Zone <String[]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

New-AzureRmRedisCache cmdlet 创建 Azure Redis 缓存。

示例

示例 1：创建 Redis 缓存

PS C:\>New-AzureRmRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "North Central US"

          PrimaryKey         : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          SecondaryKey       : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          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 缓存

PS C:\>New-AzureRmRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "North Central US" -Size 250MB -Sku "Standard" -RedisConfiguration @{"maxmemory-policy" = "allkeys-random"} -Force

          PrimaryKey         : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          SecondaryKey       : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          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               : []

此命令创建 Redis 缓存。

参数

-Confirm

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

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

-DefaultProfile

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

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

-EnableNonSslPort

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

类型:	Nullable<T>[Boolean]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-Location

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

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

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

-Name

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

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

-RedisConfiguration

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

已启用 rdb-backup-enabled。指定已启用 Redis 数据持久性。仅限高级层。
rdb-storage-connection-string。指定 Redis 数据持久性存储帐户的连接字符串。仅限高级层。
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 PowerShellhttps://go.microsoft.com/fwlink/?LinkId=800051 管理 Azure Redis 缓存（https://go.microsoft.com/fwlink/?LinkId=800051）。

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

-ResourceGroupName

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

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

-ShardCount

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

类型:	Nullable<T>[Int32]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-Size

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

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

类型:	String
接受的值:	P1, P2, P3, P4, C0, C1, C2, C3, C4, C5, C6, 250MB, 1GB, 2.5GB, 6GB, 13GB, 26GB, 53GB
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-Sku

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

基本
Standard
高级默认值为 Standard。

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

-StaticIP

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

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

-SubnetId

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

-Tag

表示标记的哈希表。

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

-TenantSettings

此参数已弃用。

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

-WhatIf

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

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

-Zone

区域列表。

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

输入

String

Hashtable

Nullable<T>[[System.Boolean, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

Nullable<T>[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

String[]

输出

RedisCacheAttributesWithAccessKeys

通过

New-AzureRmRedisCache

语法

说明

示例

示例 1：创建 Redis 缓存

示例 2：创建标准 SKU Redis 缓存

参数

-Confirm

-DefaultProfile

-EnableNonSslPort

-Location

-Name

-RedisConfiguration

-ResourceGroupName

-ShardCount

-Size

-Sku

-StaticIP

-SubnetId

-Tag

-TenantSettings

-WhatIf

-Zone

输入

输出

其他资源

通过

New-AzureRmRedisCache

语法

说明

示例

示例 1：创建 Redis 缓存

示例 2：创建标准 SKU Redis 缓存

参数

-Confirm

-DefaultProfile

-EnableNonSslPort

-Location

-Name

-RedisConfiguration

-ResourceGroupName

-ShardCount

-Size

-Sku

-StaticIP

-SubnetId

-Tag

-TenantSettings

-WhatIf

-Zone

输入

输出

相关链接

其他资源