New-AzRedisEnterpriseCache

リファレンス

モジュール:: Az.RedisEnterpriseCache

Redis Enterprise キャッシュを作成します。

構文

New-AzRedisEnterpriseCache
   -ClusterName <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Location <String>
   -Sku <SkuName>
   [-Capacity <Int32>]
   [-MinimumTlsVersion <TlsVersion>]
   [-Zone <String[]>]
   [-Tag <Hashtable>]
   [-Module <IModule[]>]
   [-ClientProtocol <Protocol>]
   [-Port <Int32>]
   [-EvictionPolicy <EvictionPolicy>]
   [-GroupNickname <String>]
   [-LinkedDatabase <ILinkedDatabase[]>]
   [-ClusteringPolicy <ClusteringPolicy>]
   [-AccessKeysAuthentication <AccessKeysAuthentication>]
   [-CustomerManagedKeyEncryptionKeyUrl <String>]
   [-HighAvailability <HighAvailability>]
   [-IdentityType <ManagedServiceIdentityType>]
   [-IdentityUserAssignedIdentity <Hashtable>]
   [-KeyEncryptionKeyIdentityType <CmkIdentityType>]
   [-KeyEncryptionKeyIdentityUserAssignedIdentityResourceId <String>]
   [-AofPersistenceEnabled]
   [-AofPersistenceFrequency <AofFrequency>]
   [-RdbPersistenceEnabled]
   [-RdbPersistenceFrequency <RdbFrequency>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzRedisEnterpriseCache
   -ClusterName <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Location <String>
   -Sku <SkuName>
   [-Capacity <Int32>]
   [-MinimumTlsVersion <TlsVersion>]
   [-Zone <String[]>]
   [-Tag <Hashtable>]
   [-CustomerManagedKeyEncryptionKeyUrl <String>]
   [-HighAvailability <HighAvailability>]
   [-IdentityType <ManagedServiceIdentityType>]
   [-IdentityUserAssignedIdentity <Hashtable>]
   [-KeyEncryptionKeyIdentityType <CmkIdentityType>]
   [-KeyEncryptionKeyIdentityUserAssignedIdentityResourceId <String>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-NoDatabase]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

関連付けられたデータベースを使用して、既存のキャッシュクラスターを作成または更新します (潜在的なダウンタイムで上書きまたは再作成します)。

例

例 1: Redis Enterprise キャッシュを作成する

New-AzRedisEnterpriseCache -Name "MyCache" -ResourceGroupName "MyGroup" -Location "West US" -Sku "Enterprise_E10"

Location Name    Type                            Zone Database
-------- ----    ----                            ---- --------
West US  MyCache Microsoft.Cache/redisEnterprise      {default}

このコマンドは、MyCache という名前の Redis Enterprise キャッシュを、default という名前の関連付けられたデータベースで作成します。

例 2: 省略可能なパラメーターを使用して Redis Enterprise キャッシュを作成する

New-AzRedisEnterpriseCache -Name "MyCache" -ResourceGroupName "MyGroup" -Location "East US" -Sku "Enterprise_E20" -Capacity 4 -MinimumTlsVersion "1.2" -Zone "1","2","3" -Tag @{"tag1" = "value1"} -Module "{name:RedisBloom, args:`"ERROR_RATE 0.00 INITIAL_SIZE 400`"}","{name:RedisTimeSeries, args:`"RETENTION_POLICY 20`"}","{name:RediSearch}" -ClientProtocol "Plaintext" -EvictionPolicy "NoEviction" -ClusteringPolicy "EnterpriseCluster" -AofPersistenceEnabled -AofPersistenceFrequency "1s"

Location Name    Type                            Zone      Database
-------- ----    ----                            ----      --------
East US  MyCache Microsoft.Cache/redisEnterprise {1, 2, 3} {default}

このコマンドでは、オプションのパラメーターを使用して、MyCache という名前の Redis Enterprise キャッシュを、default という名前の関連付けられたデータベースと共に作成します。

例 3: 詳細 - 関連付けられたデータベースを使用せずに Redis Enterprise キャッシュクラスターを作成する

New-AzRedisEnterpriseCache -Name "MyCache" -ResourceGroupName "MyGroup" -Location "East US" -Sku "EnterpriseFlash_F300" -NoDatabase

Location Name    Type                            Zone Database
-------- ----    ----                            ---- --------
East US  MyCache Microsoft.Cache/redisEnterprise      {}

警告: このコマンドは、データを保持するデータベースが関連付けられていない MyCache という名前の Redis Enterprise キャッシュクラスターを作成します。

例 4: georeplicated データベースを使用して Redis Enterprise キャッシュを作成する

New-AzRedisEnterpriseCache -Name "MyCache" -ResourceGroupName "MyGroup" -Location "West US" -Sku "Enterprise_E10" -ClientProtocol "Encrypted" -EvictionPolicy "NoEviction" -ClusteringPolicy "EnterpriseCluster" -GroupNickname "GroupNickname" -LinkedDatabase '{id:"/subscriptions/6b9ac7d2-7f6d-4de4-962c-43fda44bc3f2/resourceGroups/MyGroup/providers/Microsoft.Cache/redisEnterprise/MyCache/databases/default"}'

Location Name      Type                            Zone Database
-------- ----      ----                            ---- --------
West US  MyCache   Microsoft.Cache/redisEnterprise      {default}

このコマンドは、default という名前の geo レプリケートされたデータベースを使用してキャッシュ名 MyCache を作成します。

パラメーター

-AccessKeysAuthentication

このプロパティを有効または無効にして、現在のアクセスキーでのアクセスを許可または拒否できます。データベースが作成された後でも更新できます。

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

-AofPersistenceEnabled

[プレビュー]AOF 永続化が有効かどうかを設定します。 AOF 永続化を有効にすると、無効にできなくなります。有効にした後の AOF 永続化の無効化のサポートは、後日追加されます。

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

-AofPersistenceFrequency

[プレビュー]AOF 永続化が有効になっている場合にデータがディスクに書き込まれる頻度を設定します。使用できる値: 1s、常に

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

-AsJob

コマンドをジョブとして実行する

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

-Capacity

RedisEnterprise クラスターのサイズ。既定値は 2 または 3、SKU によっては適用されません。有効な値は、Enterprise_* SKU の場合は (2、4、6、...)、EnterpriseFlash_* SKU の場合は (3、9、15、...) です。その他の SKU の場合、容量引数はサポートされていません。

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

-ClientProtocol

redis クライアントが TLS で暗号化された redis プロトコルまたはプレーンテキスト redis プロトコルを使用して接続できるかどうかを指定します。既定値は Encrypted Allowed 値です:Encrypted、Plaintext

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

-ClusteringPolicy

クラスタリングポリシー - 既定値は、作成時に指定された OSSCluster です。使用できる値: EnterpriseCluster、OSSCluster

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

-ClusterName

Redis Enterprise クラスターの名前。

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

-Confirm

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

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

-CustomerManagedKeyEncryptionKeyUrl

キー暗号化キー URL のバージョン管理のみ。例: https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78"

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

-DefaultProfile

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

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

-EvictionPolicy

Redis 削除ポリシー - 既定値は VolatileLRU 許可値です。AllKeysLFU、AllKeysLRU、AllKeysRandom、VolatileLRU、VolatileLFU、VolatileTTL、VolatileRandom、NoEviction

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

-GroupNickname

リンクされたデータベースリソースのグループの名前

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

-HighAvailability

既定で有効になっています。更新できるのは、無効から有効にすることだけです。 highAvailability が無効になっている場合、データセットはレプリケートされません。これは可用性 SLA に影響し、データ損失のリスクが高まります。

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

-IdentityType

マネージドサービス ID の種類 (SystemAssigned 型と UserAssigned 型の両方が許可されます)。

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

-IdentityUserAssignedIdentity

リソースに関連付けられているユーザー割り当て ID のセット。 userAssignedIdentities ディクショナリキーは、'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} という形式の ARM リソース ID になります。ディクショナリ値は、要求内の空のオブジェクト ({}) にすることができます。

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

-KeyEncryptionKeyIdentityType

この API バージョンでは userAssignedIdentity のみがサポートされています。他の型は将来サポートされる可能性があります

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

-KeyEncryptionKeyIdentityUserAssignedIdentityResourceId

キー暗号化キー URL へのアクセスに使用するユーザー割り当て ID。例: /subscriptions/</resourceGroups/<リソースグループ>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId を>サブ uuid。

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

-LinkedDatabase

このデータベースにリンクするデータベースリソースの一覧構築するには、GEOREPLICATIONLINKEDDATABASE プロパティの NOTES セクションを参照し、ハッシュテーブルを作成します。構築するには、LINKEDDATABASE プロパティの NOTES セクションを参照し、ハッシュテーブルを作成します。

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

-Location

リソースが存在する地理的な場所。

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

-MinimumTlsVersion

サポートするクラスターの TLS の最小バージョン - 既定値は 1.2 許可値:1.0、1.1、1.2

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

-Module

このデータベースで有効にする redis モジュールのオプションセット - モジュールは作成時にのみ追加できます。構築するには、MODULE プロパティの NOTES セクションを参照し、ハッシュテーブルを作成します。

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

-NoDatabase

[詳細設定] - 既定のデータベースを自動的に作成しません。警告: データベースを作成するまでキャッシュは使用できません。

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

-NoWait

コマンドを非同期的に実行する

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

-Port

データベースエンドポイントの TCP ポート - 既定値は、作成時に指定された使用可能なポートです。

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

-RdbPersistenceEnabled

[プレビュー]RDB 永続化が有効かどうかを設定します。 RDB 永続化を有効にすると、RDB 永続化を無効にできなくなります。有効にした後の RDB 永続化の無効化のサポートは、後日追加されます。

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

-RdbPersistenceFrequency

[プレビュー]RDB 永続化が有効になっている場合にデータベースのスナップショットが作成される頻度を設定します。使用できる値: 1h、6h、12h

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

-ResourceGroupName

リソースグループの名前。名前では大文字と小文字が区別されません。

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

-Sku

デプロイする RedisEnterprise クラスターの種類。使用できる値: Balanced_B0、Balanced_B1、Balanced_B10、 Balanced_B100、Balanced_B1000、Balanced_B150、Balanced_B20、Balanced_B250、Balanced_B3、Balanced_B350、Balanced_B5、Balanced_B50 Balanced_B500、Balanced_B700、ComputeOptimized_X10、ComputeOptimized_X100、ComputeOptimized_X150、ComputeOptimized_X20、ComputeOptimized_X250、ComputeOptimized_X3、ComputeOptimized_X350、ComputeOptimized_X5、ComputeOptimized_X50、ComputeOptimized_X500、ComputeOptimized_X700、EnterpriseFlash_F1500、EnterpriseFlash_F300、 EnterpriseFlash_F700、Enterprise_E1、Enterprise_E10、Enterprise_E100、Enterprise_E20、Enterprise_E200、Enterprise_E400、Enterprise_E5、Enterprise_E50 FlashOptimized_A1000、FlashOptimized_A1500、FlashOptimized_A2000、FlashOptimized_A250、FlashOptimized_A4500、FlashOptimized_A500、FlashOptimized_A700、MemoryOptimized_M10、MemoryOptimized_M100、MemoryOptimized_M1000、MemoryOptimized_M150、MemoryOptimized_M1500、MemoryOptimized_M20、MemoryOptimized_M2000、MemoryOptimized_M250、MemoryOptimized_M350、MemoryOptimized_M50、MemoryOptimized_M500、MemoryOptimized_M700

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

-SubscriptionId

ターゲットサブスクリプションの ID。

型:	String
配置:	Named
規定値:	(Get-AzContext).Subscription.Id
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Tag

クラスターリソースタグ。

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

-WhatIf

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

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

-Zone

このクラスターがデプロイされる可用性ゾーン。

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

出力

ICluster

次の方法で共有