Set-AzRedisCache

參考

模組:: Az.RedisCache

修改 Azure Cache for Redis。

語法

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

Description

Set-AzRedisCache Cmdlet 會修改 Azure Cache for Redis。

範例

範例 1：修改 Azure Cache for Redis

Set-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -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               : []

此命令會更新名為 MyCache 之 Azure Cache fo Redis 的 maxmemory-policy。

範例 2：修改 Azure Cache for Redis - 如果您想要停用 RDB 或 AOF 數據持續性。

Set-AzRedisCache -Name "MyCache"  -RedisConfiguration @{"rdb-backup-enabled" = "false"}

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  : Succeeded
          SslPort            : 6380
          RedisConfiguration : {[maxmemory-policy, allkeys-random], [maxclients, 7500], [maxmemory-reserved, 200],
                                [maxfragmentationmemory-reserved, 300], [rdb-backup-enabled, false]...} 
          EnableNonSslPort   : False
          RedisVersion       : 4.0.14
          Size               : 6GB
          Sku                : Premium
          Tag                : {}
          Zone               : []

此 Cmdlet 會停用 Azure Cache for Redis 的 RDB 備份數據持續性。您也可以停用 AOF 備份持續性快取。

範例 3：修改 Azure Cache for Redis - 如果您想要在建立 azure redis 快取之後新增數據持續性。

Set-AzRedisCache -Name "MyCache" -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  : Succeeded
          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               : []

此 Cmdlet 可在已經存在的快取上啟用 rdb-backup 持續性。您也可以啟用 aof-backup 持續性。

範例 4：修改 Azure Cache for Redis - 如果您想要變更 rdb 備份頻率。

例如 - 目前您會每隔 30 分鐘擷取 RDB 快照集，但您想要變更為擷取快照集 15 分鐘。

Set-AzRedisCache -Name "MyCache" -RedisConfiguration @{"rdb-backup-frequency" = "15"}

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  : Succeeded
          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               : []

範例 5：修改 Azure Cache for Redis - 如果您想要將 AOF 備份數據持續性變更為 RDB 備份。

Set-AzRedisCache -Name "MyCache"  -RedisConfiguration @{"aof-backup-enabled"= "false"; "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  : Succeeded
          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               : []

此 Cmdlet 有助於變更持續性方法。

範例 6：調整 Azure Cache for Redis 實例 - 更新為不同的大小。

Set-AzRedisCache -Name "MyCache" -Size "P2" -Sku "Premium"

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  : Scaling
          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               : []

此命令會增加或減少實例的記憶體大小。

範例 7：調整 Azure Cache for Redis 實例 - 更新至不同層級。

Set-AzRedisCache -Name "MyCache" -Size "P1" -Sku "Premium"

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  : Scaling
          SslPort            : 6380
          RedisConfiguration : {[maxmemory-policy, allkeys-random], [maxclients, 7500], [maxmemory-reserved, 200],
                                [maxfragmentationmemory-reserved, 300]....} 
          EnableNonSslPort   : False
          RedisVersion       : 4.0.14
          Size               : 1GB
          Sku                : Standard
          Tag                : {}
          Zone               : []

此命令可協助您變更快取的階層。您可以從 [基本] 變更為 [標準]，或 [標準] 變更為 [進階]。

範例 8：調整 Azure Cache for Redis 實例 - 啟用 Redis 叢集。

Set-AzRedisCache -Name "MyCache" -ShardCount 1

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  : Scaling
          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
          ShardCount         :
          Tag                : {}
          Zone               : []

此 Cmdlet 可協助您為 Azure Cache for Redis 實例啟用叢集。若要增加分區計數，必須先啟用叢集。

範例 9：調整 Azure Cache for Redis 實例 - 使用 Redis 叢集來相應縮小/放大。

Set-AzRedisCache -Name "MyCache" -ShardCount 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  : Scaling
          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
          ShardCount         : 1
          Tag                : {}
          Zone               : []

此命令會增加或減少叢集大小。

參數

-Confirm

執行 Cmdlet 之前先提示您確認。

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。

類型:	IAzureContextContainer
別名:	AzContext, AzureRmContext, AzureCredential
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DisableAccessKeyAuthentication

選擇性：當設定為 true 時，會停用透過存取密鑰向 Redis 進行驗證。預設值為 False。

類型:	String
Position:	Named
預設值:	false
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-EnableNonSslPort

指出是否已啟用非 SSL 連接埠。默認值為$False（停用非 SSL 埠）。

類型:	Nullable<T>[Boolean]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-IdentityType

指定用於 Azure Cache for Redis 的身分識別類型。有效值：“SystemAssigned” 或 “UserAssigned” 或 “SystemAssignedUserAssigned” 或 “None”

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-MinimumTlsVersion

指定客戶端連線至快取所需的 TLS 版本。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-Name

指定要更新的 Azure Cache for 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。設定 keyspace 通知。標準和進階層。
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 慣用的驗證方法，用來與用於數據持續性的記憶體帳戶通訊，指定 SAS 或 ManagedIdentity，預設值為 SAS

類型:	Hashtable
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-RedisVersion

Redis 版本。這的格式應該是 'major[.minor]' （只需要 'major' ）或值 'latest'，其指的是可用的最新穩定 Redis 版本。支援的版本：4.0、6.0（最新版）。預設值為『latest』。

類型:	String
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
P5
C0
C1
C2
C3
C4
C5
C6
250MB
1GB
2.5GB
6GB
13GB
26GB
53GB
120GB 預設值為1GB或 C1。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-Sku

指定要建立的 Redis 快取 SKU。有效值為：

基本
標準
進階預設值為 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

-UpdateChannel

選擇性：指定您 Redis 快取將接收之每月 Redis 更新的更新通道。使用「預覽」更新通道的快取，至少比「穩定」通道快取提前 4 周取得最新的 Redis 更新。默認值為『Stable』。可能的值包括：'Stable'、'Preview'

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-UserAssignedIdentity

指定要與 Azure Cache for Redis 相關聯的一或多個逗號分隔使用者身分識別。使用者身分識別參考的格式為 ARM 資源標識符：'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identities/{identityName}'

類型:	String[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。未執行 Cmdlet。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

String

Hashtable

Nullable<T>[[System.Boolean, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

Nullable<T>[[System.Int32, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

輸出

RedisCacheAttributesWithAccessKeys

共用方式為

Set-AzRedisCache

語法

Description

範例

範例 1：修改 Azure Cache for Redis

範例 2：修改 Azure Cache for Redis - 如果您想要停用 RDB 或 AOF 數據持續性。

範例 3：修改 Azure Cache for Redis - 如果您想要在建立 azure redis 快取之後新增數據持續性。

範例 4：修改 Azure Cache for Redis - 如果您想要變更 rdb 備份頻率。

範例 5：修改 Azure Cache for Redis - 如果您想要將 AOF 備份數據持續性變更為 RDB 備份。

範例 6：調整 Azure Cache for Redis 實例 - 更新為不同的大小。

範例 7：調整 Azure Cache for Redis 實例 - 更新至不同層級。

範例 8：調整 Azure Cache for Redis 實例 - 啟用 Redis 叢集。

範例 9：調整 Azure Cache for Redis 實例 - 使用 Redis 叢集來相應縮小/放大。

參數

-Confirm

-DefaultProfile

-DisableAccessKeyAuthentication

-EnableNonSslPort

-IdentityType

-MinimumTlsVersion

-Name

-RedisConfiguration

-RedisVersion

-ResourceGroupName

-ShardCount

-Size

-Sku

-Tag

-TenantSettings

-UpdateChannel

-UserAssignedIdentity

-WhatIf

輸入

輸出

其他資源

共用方式為

Set-AzRedisCache

語法

Description

範例

範例 1：修改 Azure Cache for Redis

範例 2：修改 Azure Cache for Redis - 如果您想要停用 RDB 或 AOF 數據持續性。

範例 3：修改 Azure Cache for Redis - 如果您想要在建立 azure redis 快取之後新增數據持續性。

範例 4：修改 Azure Cache for Redis - 如果您想要變更 rdb 備份頻率。

範例 5：修改 Azure Cache for Redis - 如果您想要將 AOF 備份數據持續性變更為 RDB 備份。

範例 6：調整 Azure Cache for Redis 實例 - 更新為不同的大小。

範例 7：調整 Azure Cache for Redis 實例 - 更新至不同層級。

範例 8：調整 Azure Cache for Redis 實例 - 啟用 Redis 叢集。

範例 9：調整 Azure Cache for Redis 實例 - 使用 Redis 叢集來相應縮小/放大。

參數

-Confirm

-DefaultProfile

-DisableAccessKeyAuthentication

-EnableNonSslPort

-IdentityType

-MinimumTlsVersion

-Name

-RedisConfiguration

-RedisVersion

-ResourceGroupName

-ShardCount

-Size

-Sku

-Tag

-TenantSettings

-UpdateChannel

-UserAssignedIdentity

-WhatIf

輸入

輸出

相關連結

其他資源