次の方法で共有

Set-AzRedisCache

モジュール:
Az.RedisCache Module

Azure Cache for Redis を変更します。

構文

Default (既定) 

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
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:cf

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-DefaultProfile

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

パラメーターのプロパティ

型:IAzureContextContainer
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-DisableAccessKeyAuthentication

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

パラメーターのプロパティ

型:String
規定値:false
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-EnableNonSslPort

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

パラメーターのプロパティ

型:

Nullable<T>[Boolean]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-IdentityType

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

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-MinimumTlsVersion

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

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-Name

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

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値: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 PowerShell を使用した Azure Redis Cache の管理」を参照してください。
  • preferred-data-archive-auth-method データ アーカイブに使用されるストレージ アカウントと通信するための優先認証方法、SAS または ManagedIdentity の指定、既定値は SAS
  • preferred-data-persistence-auth-method データ永続化に使用されるストレージ アカウントと通信するための優先認証方法、SAS または ManagedIdentity の指定、既定値は SAS

パラメーターのプロパティ

型:Hashtable
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-RedisVersion

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

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-ResourceGroupName

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

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-ShardCount

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

パラメーターのプロパティ

型:

Nullable<T>[Int32]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-Size

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

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

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-Sku

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

  • Basic
  • Standard
  • Premium 既定値は Standard です。

パラメーターのプロパティ

型:String
規定値:None
指定可能な値:Basic, Standard, Premium
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-Tag

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

パラメーターのプロパティ

型:Hashtable
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-TenantSettings

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

パラメーターのプロパティ

型:Hashtable
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-UpdateChannel

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

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-UserAssignedIdentity

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

パラメーターのプロパティ

型:

String[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-WhatIf

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

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:ウィスコンシン

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ZonalAllocationPolicy

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

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

CommonParameters

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

入力

String

Hashtable

Nullable<T>

Nullable<T>

出力

RedisCacheAttributesWithAccessKeys