New-AzRedisCache

リファレンス

モジュール:: Az.RedisCache

Redis Cache を作成します。

構文

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

説明

New-AzRedisCache コマンドレットは、Azure Redis Cache を作成します。

例

例 1: Redis Cache を作成する

New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "North Central US"

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 : {}
          EnableNonSslPort   : False
          RedisVersion       : 2.8
          Size               : 1GB
          Sku                : Standard
          Tag                : {}
          Zone               : []

このコマンドを実行すると、Redis Cache が作成されます。

例 2: Standard SKU Redis Cache を作成する

New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "North Central US" -Size 250MB -Sku "Standard" -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               : []

このコマンドレットは、Azure Cache for Redis を使用してキャッシュを作成します。

例 3: ゾーン冗長キャッシュを作成する

New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "Central US" -Size P1 -Sku "Premium" -Zone @("1","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  : creating
          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               : {1, 2}

このコマンドは、複数のゾーンに Azure Cache for Redis インスタンスを作成します。

例 4: 仮想ネットワークを作成してキャッシュを有効にする

仮想ネットワークの有効化キャッシュを作成するための要件。

Redis Cache を作成するのと同じリソースグループに仮想ネットワークを作成します。仮想ネットワークは、powershell コマンド New-AzVirtualNetwork から作成できます。
VNET のキャッシュを有効にするには SubnetID が必要です。 SubnetID の構文を次に示します。

SubnetID の形式: /subscriptions/{subid}/resourceGroups/{resourceGroupName}/providers/Microsoft.ClassicNetwork/VirtualNetworks/{vnetName}/subnets/{subnetName}

New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "Central US" -Size P1 -Sku "Premium" -SubnetId "/subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Network/virtualNetworks/MyNet/subnets/MySubnet"

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  : creating
          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
          SubnetId           : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Network/virtualNetworks/MyNet/subnets/MySubnet
          StaticIP           : 10.0.0.4
          Tag                : {}
          Zone               : []

例 5: Premium Azure Cache for Redis のデータ永続化を構成する

永続化では、自分が所有して管理している Azure Storage アカウントに Redis データが書き込まれます。そのため、データ永続化を構成する前に、同じリソースグループにストレージアカウントが必要です。 Cache と同じリージョンおよびサブスクリプションのストレージアカウントを選択します。また、スループットが高いため Premium Storage アカウントを使用することをお勧めします。

ストレージアカウントを作成した後、この手順を使用してストレージアカウント接続文字列を取得します。

powershell で、次のコマンド Get-AzStorageAccountKey -ResourceGroupName $resourceGroupName -Name $storageAccountName を実行します。
上記の出力から、任意のキーをコピーします。
ストレージアカウントの接続文字列を取得するには、次の形式でストレージアカウントキーとストレージアカウント名を入力します。

接続文字列の形式 :- "DefaultEndpointsProtocol=https;AccountName={storageAccountName};AccountKey={storageAccountKey};EndpointSuffix=mySuffix"

データの永続化を有効にするには、特定の Redis 構成設定が必要です。

RDB バックアップの有効化

rdb-backup-enabled (true または false の設定)
rdb-storage-connection-string (上記の形式で接続文字列を指定します)。
rdb-backup-frequency (分単位でバックアップ間隔を設定します。15、30、60、360、720、1440 分からのみ選択できます)。

New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "Central US" -Size P1 -Sku "Premium" -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  : creating
          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: Premium Azure Cache for Redis のデータ永続化を構成する - AOF バックアップが有効になっている

AOF バックアップが有効になっている場合。

aof-backup-enabled (true または false の設定)
aof-storage-connection-string-0 (上記の形式で接続文字列を指定します)。
aof-storage-connection-string-1 (必要に応じて別のストレージアカウントを構成できます。2 つ目のストレージアカウントが構成されている場合、レプリカキャッシュへの書き込みは、この 2 つ目のストレージアカウントに書き込まれます)。

New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "Central US" -Size P1 -Sku "Premium" -RedisConfiguration @{"aof-backup-enabled" = "true"; "aof-storage-connection-string-0" = "DefaultEndpointsProtocol=https;AccountName=mystorageaccount;AccountKey=******;EndpointSuffix=mySuffix"}

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

-Location

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

米国中北部
米国中南部
米国中部
西ヨーロッパ
北ヨーロッパ
米国西部
米国東部
米国東部 2
日本東部
西日本
ブラジル南部
東南アジア
東アジア
オーストラリア東部
オーストラリア南東部

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

-MinimumTlsVersion

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

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

-Name

作成する Redis Cache の名前を指定します。

型:	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 PowerShell を使用した Azure Redis Cache の管理http://go.microsoft.com/fwlink/?LinkId=800051 (http://go.microsoft.com/fwlink/?LinkId=800051)」を参照してください。
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
必須:	True
パイプライン入力を受け取る:	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
250MB
1GB
2.5GB
6 GB
13GB
26 GB
53 GB 既定値は 1 GB または C1 です。

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

-Sku

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

Basic
Standard
Premium 既定値は Standard です。

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

-StaticIP

Redis Cache のサブネット内の一意の IP アドレスを指定します。このパラメーターの値を指定しない場合、このコマンドレットはサブネットから IP アドレスを選択します。

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

-SubnetId

Azure Cache for Redis をデプロイする仮想ネットワーク内のサブネットの完全なリソース ID。形式の例: /subscriptions/{subid}/resourceGroups/{resourceGroupName}/Microsoft。{ネットワーク|ClassicNetwork}/VirtualNetworks/{vnetName}/subnets/{subnetName}

型:	String
配置:	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
規定値:	Stable
必須:	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

-Zone

Availability ゾーンを持つ Azure リージョンの一覧。

型:	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]]

String[]

出力

RedisCacheAttributesWithAccessKeys

次の方法で共有

New-AzRedisCache

構文

説明

例

例 1: Redis Cache を作成する

例 2: Standard SKU Redis Cache を作成する

例 3: ゾーン冗長キャッシュを作成する

例 4: 仮想ネットワークを作成してキャッシュを有効にする

例 5: Premium Azure Cache for Redis のデータ永続化を構成する

例 6: Premium Azure Cache for Redis のデータ永続化を構成する - AOF バックアップが有効になっている

パラメーター

-Confirm

-DefaultProfile

-DisableAccessKeyAuthentication

-EnableNonSslPort

-IdentityType

-Location

-MinimumTlsVersion

-Name

-RedisConfiguration

-RedisVersion

-ResourceGroupName

-ShardCount

-Size

-Sku

-StaticIP

-SubnetId

-Tag

-TenantSettings

-UpdateChannel

-UserAssignedIdentity

-WhatIf

-Zone

入力

出力

その他のリソース

次の方法で共有

New-AzRedisCache

構文

説明

例

例 1: Redis Cache を作成する

例 2: Standard SKU Redis Cache を作成する

例 3: ゾーン冗長キャッシュを作成する

例 4: 仮想ネットワークを作成してキャッシュを有効にする

例 5: Premium Azure Cache for Redis のデータ永続化を構成する

例 6: Premium Azure Cache for Redis のデータ永続化を構成する - AOF バックアップが有効になっている

パラメーター

-Confirm

-DefaultProfile

-DisableAccessKeyAuthentication

-EnableNonSslPort

-IdentityType

-Location

-MinimumTlsVersion

-Name

-RedisConfiguration

-RedisVersion

-ResourceGroupName

-ShardCount

-Size

-Sku

-StaticIP

-SubnetId

-Tag

-TenantSettings

-UpdateChannel

-UserAssignedIdentity

-WhatIf

-Zone

入力

出力

関連リンク

その他のリソース