你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Set-AzureRmRedisCache
修改 Redis 缓存。
警告
AzureRM PowerShell 模块已自 2024 年 2 月 29 日起正式弃用。 为了确保持续获得支持和更新,建议用户从 AzureRM 迁移到 Az PowerShell 模块。
尽管 AzureRM 模块仍可运行,但不再受到维护或支持,任何继续使用的行为都由用户自行决定并自行承担风险。 有关过渡到 Az 模块的指导,请参阅我们的迁移资源。
语法
Set-AzureRmRedisCache
[-ResourceGroupName <String>]
-Name <String>
[-Size <String>]
[-Sku <String>]
[-RedisConfiguration <Hashtable>]
[-EnableNonSslPort <Boolean>]
[-TenantSettings <Hashtable>]
[-ShardCount <Int32>]
[-Tag <Hashtable>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
说明
Set-AzureRmRedisCache cmdlet 修改 Azure Redis 缓存。
示例
示例 1:修改 Redis 缓存
PS C:\>Set-AzureRmRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -RedisConfiguration @{"maxmemory-policy" = "allkeys-random"}
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 : []
此命令更新名为 MyCache 的 Redis 缓存的 maxmemory-policy。
参数
-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 |
-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 |
必需: | False |
接受管道输入: | 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 |
-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 |
输入
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]]
输出
RedisCacheAttributesWithAccessKeys