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>]
   [-RedisVersion <String>]
   [-UpdateChannel <String>]
   [-Tag <Hashtable>]
   [-IdentityType <String>]
   [-UserAssignedIdentity <String[]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

Set-AzRedisCache コマンドレットは、Azure Cache for Redis を変更します。

例

例 1: Azure Cache for Redis の変更

Set-AzRedisCache -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 という名前の Azure Cache fo Redis の maxmemory-policy を更新します。

例 2: Azure Cache for Redis を変更する - RDB または AOF データ永続化を無効にする場合。

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

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

このコマンドレットは、Azure Cache for Redis の RDB バックアップデータの永続化を無効にします。 AOF バックアップ永続キャッシュを無効にすることもできます。

例 3: Azure Cache for Redis を変更する - Azure Redis Cache の作成後にデータ永続化を追加する場合。

Set-AzRedisCache -Name "MyCache" -RedisConfiguration @{"rdb-backup-enabled" = "true"; "rdb-storage-connection-string" = "DefaultEndpointsProtocol=https;AccountName=mystorageaccount;AccountKey=pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=;EndpointSuffix=mySuffix"; "rdb-backup-frequency" = "30"}

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

このコマンドレットを使用すると、既存のキャッシュで rdb-backup 永続化が有効になります。バックアップの永続化を有効にすることもできます。

例 4: Azure Cache for Redis を変更する - rdb のバックアップ頻度を変更する場合。

たとえば、現在、RDB スナップショットを 30 分ごとに実行していますが、スナップショット 15 分かかります。

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

PrimaryKey         : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          SecondaryKey       : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          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=pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=;EndpointSuffix=mySuffix"; "rdb-backup-frequency" = "30"}

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

このコマンドレットは、永続化方法の変更に役立ちます。

例 6: Azure Cache for Redis インスタンスのスケーリング - 異なるサイズに更新します。

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

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

このコマンドは、キャッシュの層を変更するのに役立ちます。 Basic から Standard に、または Standard からプレミアムに変更できます。

例 8: Azure Cache for Redis インスタンスのスケーリング - Redis クラスタリングを有効にする。

Set-AzRedisCache -Name "MyCache" -ShardCount 1

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

このコマンドレットは、Azure Cache for Redis インスタンスのクラスタリングを有効にする際に役立ちます。シャード数を増やすには、まずクラスタリングを有効にする必要があります。

例 9: Azure Cache for Redis インスタンスをスケーリングする - Redis クラスターを使用してスケールイン/スケールアウトする。

Set-AzRedisCache -Name "MyCache" -ShardCount 2

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

コマンドレットの実行前に確認を求めるメッセージが表示されます。

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

-DefaultProfile

Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableNonSslPort

非 SSL ポートが有効になっているかどうかを示します。既定値は $False です (SSL 以外のポートは無効です)。

Type:	Nullable<T>[Boolean]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-IdentityType

Azure Cache for Redis に使用される ID の種類を指定します。有効な値: "SystemAssigned" または "UserAssigned" または "SystemAssignedUserAssigned" または "None"

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

-MinimumTlsVersion

クライアントがキャッシュに接続するために必要な TLS バージョンを指定します。

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

-Name

更新する Azure Cache for Redis の名前を指定します。

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

-RedisConfiguration

Redis 構成の設定を指定します。このパラメーターの有効値は、次のとおりです。

rdb-backup-enabled。 Redis データ永続化が有効になっていることを指定します。プレミアムレベルのみ。
rdb-storage-connection-string。 Redis データ永続化のためにストレージアカウントへの接続文字列を指定します。プレミアムレベルのみ。
rdb-backup-frequency。 Redis データ永続化のバックアップ頻度を指定します。プレミアムレベルのみ。
maxmemory-reserved。キャッシュ以外のプロセス用に予約されているメモリを構成します。 Standard レベルとプレミアムレベル。
maxmemory-policy。キャッシュの削除ポリシーを構成します。すべての価格レベル。
notify-keyspace-events。キースペース通知を構成します。 Standard レベルと Premium レベル。
hash-max-ziplist-entries。小さい集計データ型のメモリ最適化を構成します。 Standard レベルとプレミアムレベル。
hash-max-ziplist-value。小さい集計データ型のメモリ最適化を構成します。 Standard レベルとプレミアムレベル。
set-max-intset-entries。小さい集計データ型のメモリ最適化を構成します。 Standard レベルとプレミアムレベル。
zset-max-ziplist-entries。小さい集計データ型のメモリ最適化を構成します。 Standard レベルとプレミアムレベル。
zset-max-ziplist-value。小さい集計データ型のメモリ最適化を構成します。 Standard レベルとプレミアムレベル。
データベースをバックアップします。データベースの数を構成する。このプロパティは、キャッシュの作成時にのみ構成できます。 Standard レベルとプレミアムレベル。詳細については、Azure PowerShellhttp://go.microsoft.com/fwlink/?LinkId=800051 (http://go.microsoft.com/fwlink/?LinkId=800051) を使用した Azure Redis Cache の管理に関するページを参照してください。
preferred-data-archive-auth-method データアーカイブに使用されるストレージアカウントと通信するための優先認証方法、SAS または ManagedIdentity の指定、既定値は SAS
preferred-data-persistence-auth-method データ永続化に使用されるストレージアカウントと通信するための優先認証方法、SAS または ManagedIdentity の指定、既定値は SAS

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

-RedisVersion

Redis のバージョン。これは、'major[.minor]' ('major' のみが必要) または使用可能な最新の安定した Redis バージョンを参照する値 'latest' である必要があります。サポートされているバージョン: 4.0、6.0 (最新)。既定値は 'latest' です。

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

-ResourceGroupName

Redis Cache を含むリソースグループの名前を指定します。

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

-ShardCount

プレミアムクラスターキャッシュに作成するシャードの数を指定します。

Type:	Nullable<T>[Int32]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Size

Redis Cache のサイズを指定します。有効な値は次の通りです。

P1
P2
P3
P4
P5
C0
C1
C2
C3
C4
C5
C6
250MB
1GB
2.5GB
6 GB
13GB
26 GB
53 GB
120 GB 既定値は 1 GB または C1 です。

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

-Sku

作成する Redis Cache の SKU を指定します。有効な値は次の通りです。

Basic
Standard
プレミアム既定値は Standard です。

Type:	String
Accepted values:	Basic, Standard, Premium
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Tag

タグを表すハッシュテーブル。

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

-TenantSettings

このパラメーターは非推奨になりました。

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

-UpdateChannel

省略可能: Redis Cache が受け取る毎月の Redis 更新プログラムの更新チャネルを指定します。 "プレビュー" 更新チャネルを使用するキャッシュでは、少なくとも "安定" チャネルキャッシュの 4 週間前に最新の Redis 更新プログラムが取得されます。既定値は 'Stable' です。使用可能な値は次のとおりです: 'Stable'、'Preview'

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

-UserAssignedIdentity

Azure Cache for Redis に関連付ける 1 つ以上のコンマ区切りユーザー ID を指定します。ユーザー ID 参照は、"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identits/{identityName}" という形式の ARM リソース ID になります。

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

-WhatIf

コマンドレットの実行時に発生する内容を示します。このコマンドレットは実行されません。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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

構文

説明

例

例 1: Azure Cache for Redis の変更

例 2: Azure Cache for Redis を変更する - RDB または AOF データ永続化を無効にする場合。

例 3: Azure Cache for Redis を変更する - Azure Redis Cache の作成後にデータ永続化を追加する場合。

例 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

-EnableNonSslPort

-IdentityType

-MinimumTlsVersion

-Name

-RedisConfiguration

-RedisVersion

-ResourceGroupName

-ShardCount

-Size

-Sku

-Tag

-TenantSettings

-UpdateChannel

-UserAssignedIdentity

-WhatIf

入力

出力

フィードバック

その他のリソース

Set-AzRedisCache

構文

説明

例

例 1: Azure Cache for Redis の変更

例 2: Azure Cache for Redis を変更する - RDB または AOF データ永続化を無効にする場合。

例 3: Azure Cache for Redis を変更する - Azure Redis Cache の作成後にデータ永続化を追加する場合。

例 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

-EnableNonSslPort

-IdentityType

-MinimumTlsVersion

-Name

-RedisConfiguration

-RedisVersion

-ResourceGroupName

-ShardCount

-Size

-Sku

-Tag

-TenantSettings

-UpdateChannel

-UserAssignedIdentity

-WhatIf

入力

出力

関連リンク

フィードバック

その他のリソース

例 5: Azure Cache for Redis を変更する - AOF バックアップデータ永続化を RDB バックアップに変更する場合。