New-AzRedisCache
構文
Default (既定)
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>]
[-ZonalAllocationPolicy <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
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
パラメーターのプロパティ
パラメーター セット
(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 以外のポートは無効です)。
パラメーターのプロパティ
パラメーター セット
(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
-Location
Redis Cache を作成する場所を指定します。
有効な値は次のとおりです。
米国中北部
米国中南部
米国中部
西ヨーロッパ
北ヨーロッパ
米国西部
米国東部
米国東部 2
東日本
西日本
ブラジル南部
東南アジア
東アジア
オーストラリア東部
オーストラリア南東部
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
(All)
配置: Named
必須: True
パイプラインからの値: False
プロパティ名別のパイプラインからの値: True
残りの引数からの値: False
-MinimumTlsVersion
クライアントがキャッシュに接続するために必要な TLS バージョンを指定します。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: True
残りの引数からの値: False
-Name
作成する Redis Cache の名前を指定します。
パラメーターのプロパティ
型: 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 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
規定値: 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
必須: True
パイプラインからの値: False
プロパティ名別のパイプラインからの値: True
残りの引数からの値: False
-ShardCount
Premium クラスター キャッシュに作成するシャードの数を指定します。
このパラメーターに使用できる値は次のとおりです。
パラメーターのプロパティ
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: 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 既定値は 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
-StaticIP
Redis Cache のサブネット内の一意の IP アドレスを指定します。
このパラメーターの値を指定しない場合、このコマンドレットはサブネットから IP アドレスを選択します。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: True
残りの引数からの値: False
-SubnetId
Azure Cache for Redis をデプロイする仮想ネットワーク内のサブネットの完全なリソース ID。
形式の例: /subscriptions/{subid}/resourceGroups/{resourceGroupName}/Microsoft。{ネットワーク|ClassicNetwork}/VirtualNetworks/{vnetName}/subnets/{subnetName}
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: 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
規定値: Stable
ワイルドカードのサポート: 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
-Zone
Availability ゾーンを持つ Azure リージョンの一覧 。
パラメーターのプロパティ
型: 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 を参照してください。
出力