New-AzureRmRedisCache

リファレンス

モジュール:: AzureRM.RedisCache

Redis Cache を作成します。

警告

AzureRM PowerShell モジュールは、2024 年 2 月 29 日に正式に非推奨になりました。引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。

AzureRM モジュールの機能は今後も使用できますが、メンテナンスやサポートは行われないため、引き続きの使用はユーザーの判断に委ねられ、リスクが発生することがあります。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。

構文

New-AzureRmRedisCache
   -ResourceGroupName <String>
   -Name <String>
   -Location <String>
   [-Size <String>]
   [-Sku <String>]
   [-RedisConfiguration <Hashtable>]
   [-EnableNonSslPort <Boolean>]
   [-TenantSettings <Hashtable>]
   [-ShardCount <Int32>]
   [-SubnetId <String>]
   [-StaticIP <String>]
   [-Tag <Hashtable>]
   [-Zone <String[]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

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

例

例 1: Redis Cache を作成する

PS C:\>New-AzureRmRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "North Central US"

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

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

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

PS C:\>New-AzureRmRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "North Central US" -Size 250MB -Sku "Standard" -RedisConfiguration @{"maxmemory-policy" = "allkeys-random"} -Force

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

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

パラメーター

-Confirm

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

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

-DefaultProfile

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

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

-EnableNonSslPort

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

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

-Location

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

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

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	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 の管理https://go.microsoft.com/fwlink/?LinkId=800051 (https://go.microsoft.com/fwlink/?LinkId=800051)」を参照してください。

型:	Hashtable
配置:	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
C0
C1
C2
C3
C4
C5
C6
250MB
1GB
2.5GB
6 GB
13GB
26 GB
53 GB 既定値は 1 GB または C1 です。

型:	String
指定可能な値:	P1, P2, P3, P4, C0, C1, C2, C3, C4, C5, C6, 250MB, 1GB, 2.5GB, 6GB, 13GB, 26GB, 53GB
配置:	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

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

-Tag

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

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

-TenantSettings

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

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

-WhatIf

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

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

-Zone

ゾーンのリスト。

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

入力

String

Hashtable

Nullable<T>[[System.Boolean, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

Nullable<T>[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

String[]

出力

RedisCacheAttributesWithAccessKeys

次の方法で共有

New-AzureRmRedisCache

構文

説明

例

例 1: Redis Cache を作成する

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

パラメーター

-Confirm

-DefaultProfile

-EnableNonSslPort

-Location

-Name

-RedisConfiguration

-ResourceGroupName

-ShardCount

-Size

-Sku

-StaticIP

-SubnetId

-Tag

-TenantSettings

-WhatIf

-Zone

入力

出力

その他のリソース

次の方法で共有

New-AzureRmRedisCache

構文

説明

例

例 1: Redis Cache を作成する

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

パラメーター

-Confirm

-DefaultProfile

-EnableNonSslPort

-Location

-Name

-RedisConfiguration

-ResourceGroupName

-ShardCount

-Size

-Sku

-StaticIP

-SubnetId

-Tag

-TenantSettings

-WhatIf

-Zone

入力

出力

関連リンク

その他のリソース