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>]
   [-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         : 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 を作成する

New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "North Central US" -Size 250MB -Sku "Standard" -RedisConfiguration @{"maxmemory-policy" = "allkeys-random"}

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

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

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

New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "Central US" -Size P1 -Sku "Premium" -Zone @("1","2")

PrimaryKey         : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          SecondaryKey       : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          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 を作成するのと同じリソースグループに仮想ネットワークを作成します。 New-AzVirtualNetwork powershell コマンドから仮想ネットワークを作成できます。
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         : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          SecondaryKey       : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          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: プレミアム 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=pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=;EndpointSuffix=mySuffix"; "rdb-backup-frequency" = "30"}

PrimaryKey         : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          SecondaryKey       : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          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: プレミアム 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=pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=;EndpointSuffix=mySuffix"}

PrimaryKey         : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          SecondaryKey       : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          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

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

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

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableNonSslPort

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

Type:	Nullable<T>[Boolean]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-IdentityType

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Location

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

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

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-MinimumTlsVersion

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

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

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-RedisConfiguration

Redis 構成の設定を指定します。このパラメーターの有効値は、次のとおりです。

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

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-RedisVersion

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ResourceGroupName

Redis Cache を作成するリソースグループの名前を指定します。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ShardCount

プレミアムクラスターキャッシュに作成するシャードの数を指定します。このパラメーターの有効値は、次のとおりです。

Type:	Nullable<T>[Int32]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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 です。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Sku

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

Basic
Standard
プレミアム既定値は Standard です。

Type:	String
Accepted values:	Basic, Standard, Premium
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-StaticIP

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-SubnetId

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Tag

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

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-TenantSettings

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

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-UpdateChannel

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

Type:	String
Position:	Named
Default value:	Stable
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-UserAssignedIdentity

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

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Zone

可用性ゾーンを持つ Azure リージョンの一覧。

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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: プレミアム Azure Cache for Redis のデータ永続化を構成する

例 6: プレミアム Azure Cache for Redis のデータ永続化を構成する - AOF バックアップを有効にする

パラメーター

-Confirm

-DefaultProfile

-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: プレミアム Azure Cache for Redis のデータ永続化を構成する

例 6: プレミアム Azure Cache for Redis のデータ永続化を構成する - AOF バックアップを有効にする

パラメーター

-Confirm

-DefaultProfile

-EnableNonSslPort

-IdentityType

-Location

-MinimumTlsVersion

-Name

-RedisConfiguration

-RedisVersion

-ResourceGroupName

-ShardCount

-Size

-Sku

-StaticIP

-SubnetId

-Tag

-TenantSettings

-UpdateChannel

-UserAssignedIdentity

-WhatIf

-Zone

入力

出力

関連リンク

フィードバック

その他のリソース