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

このコマンドレットは、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=******;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               : []

このコマンドレットを使用すると、既存のキャッシュで rdb-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               : []

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

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

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

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

このコマンドレットは、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

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

型:	SwitchParameter
Aliases:	cf
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DefaultProfile

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

型:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DisableAccessKeyAuthentication

省略可能: アクセスキーを使用した Redis への認証は、true に設定すると無効になります。既定値は false です。

型:	String
配置:	Named
規定値:	false
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-EnableNonSslPort

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

型:	Nullable<T>[Boolean]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-IdentityType

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-MinimumTlsVersion

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-Name

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

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-RedisConfiguration

Redis の構成設定を指定します。このパラメーターに使用できる値は次のとおりです。

rdb-backup-enabled。 Redis データ永続化が有効になっていることを指定します。 Premium レベルのみ。
rdb-storage-connection-string。 Redis データ永続化用のストレージアカウントへの接続文字列を指定します。 Premium レベルのみ。
rdb-backup-frequency。 Redis データ永続化のバックアップ頻度を指定します。 Premium レベルのみ。
maxmemory-reserved。キャッシュ以外のプロセス用に予約されているメモリを構成します。 Standard レベルと Premium レベル。
maxmemory-policy。キャッシュの削除ポリシーを構成します。すべての価格レベル。
notify-keyspace-events。キースペース通知を構成します。 Standard レベルと Premium レベル。
hash-max-ziplist-entries。小さい集計データ型のメモリ最適化を構成します。 Standard レベルと Premium レベル。
hash-max-ziplist-value。小さい集計データ型のメモリ最適化を構成します。 Standard レベルと Premium レベル。
set-max-intset-entries。小さい集計データ型のメモリ最適化を構成します。 Standard レベルと Premium レベル。
zset-max-ziplist-entries。小さい集計データ型のメモリ最適化を構成します。 Standard レベルと Premium レベル。
zset-max-ziplist-value。小さい集計データ型のメモリ最適化を構成します。 Standard レベルと Premium レベル。
データベース。データベースの数を構成します。このプロパティは、キャッシュの作成時にのみ構成できます。 Standard レベルと Premium レベル。詳細については、「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

型:	Hashtable
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-RedisVersion

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-ResourceGroupName

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-ShardCount

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

型:	Nullable<T>[Int32]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-Size

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

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-Sku

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

基本的な
標準
Premium 既定値は Standard です。

型:	String
指定可能な値:	Basic, Standard, Premium
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-Tag

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

型:	Hashtable
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-TenantSettings

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

型:	Hashtable
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-UpdateChannel

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-UserAssignedIdentity

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

型:	String[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-WhatIf

コマンドレットを実行した場合の動作を示します。コマンドレットは実行されません。

型:	SwitchParameter
Aliases:	wi
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ZonalAllocationPolicy

省略可能: 省略可能: 可用性ゾーンを Redis キャッシュに割り当てる方法を指定します。 "自動" ではゾーンの冗長性が有効になり、Azure ではリージョンの可用性と容量に基づいてゾーンが自動的に選択されます。 'UserDefined' は、'zones' パラメーターを使用して渡された可用性ゾーンを選択します。 'NoZones' は非ゾーンキャッシュを生成します。 'zonalAllocationPolicy' が渡されない場合、ゾーンが渡されるときに 'UserDefined' に設定されます。それ以外の場合は、ゾーンがサポートされているリージョンでは 'Automatic' に、ゾーンがサポートされていないリージョンでは 'NoZones' に設定されます。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	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

-DisableAccessKeyAuthentication

-EnableNonSslPort

-IdentityType

-MinimumTlsVersion

-Name

-RedisConfiguration

-RedisVersion

-ResourceGroupName

-ShardCount

-Size

-Sku

-Tag

-TenantSettings

-UpdateChannel

-UserAssignedIdentity

-WhatIf

-ZonalAllocationPolicy

入力

出力

その他のリソース

次の方法で共有

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

-DisableAccessKeyAuthentication

-EnableNonSslPort

-IdentityType

-MinimumTlsVersion

-Name

-RedisConfiguration

-RedisVersion

-ResourceGroupName

-ShardCount

-Size

-Sku

-Tag

-TenantSettings

-UpdateChannel

-UserAssignedIdentity

-WhatIf

-ZonalAllocationPolicy

入力

出力

関連リンク

その他のリソース

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