Share via


New-AzRedisEnterpriseCache

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>]
   [-CustomerManagedKeyEncryptionKeyUrl <String>]
   [-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>]
   [-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 を作成します。

パラメーター

-AofPersistenceEnabled

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

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

-AofPersistenceFrequency

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

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

-AsJob

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

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

-Capacity

Redis Enterprise クラスターのサイズは、SKU に応じて既定で 2 または 3 に設定されます。 使用できる値は、エンタープライズ SKU の場合は (2、4、6、...)、Flash SKU の場合は (3、9、15、...) です。

Type:Int32
Aliases:SkuCapacity
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ClientProtocol

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

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

-ClusteringPolicy

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

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

-ClusterName

Redis Enterprise クラスターの名前。

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

-Confirm

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

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

-CustomerManagedKeyEncryptionKeyUrl

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

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

-DefaultProfile

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

Type:PSObject
Aliases:AzureRMContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EvictionPolicy

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

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

-GroupNickname

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

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

-IdentityType

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

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

-IdentityUserAssignedIdentity

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

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

-KeyEncryptionKeyIdentityType

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

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

-KeyEncryptionKeyIdentityUserAssignedIdentityResourceId

キー暗号化キー URL へのアクセスに使用するユーザー割り当て ID。 例: /subscriptions/<sub uuid>/resourceGroups/<resource group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId。

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

-LinkedDatabase

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

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

-Location

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

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

-MinimumTlsVersion

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

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

-Module

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

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

-NoDatabase

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

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

-NoWait

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

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

-Port

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

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

-RdbPersistenceEnabled

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

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

-RdbPersistenceFrequency

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

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

-ResourceGroupName

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

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

-Sku

デプロイする Redis Enterprise クラスターの種類。 使用できる値: Enterprise_E10、Enterprise_E20、Enterprise_E50、Enterprise_E100、EnterpriseFlash_F300、EnterpriseFlash_F700、EnterpriseFlash_F1500

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

-SubscriptionId

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

Type:String
Position:Named
Default value:(Get-AzContext).Subscription.Id
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Tag

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

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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

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

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

出力

ICluster