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

Description

使用相關聯的資料庫，建立或更新現有的快取叢集（覆寫/重新建立，並可能停機）。

範例

範例 1：建立 Redis 企業快取

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

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

此命令會使用名為 default 的相關聯資料庫，建立名為 MyCache 的 Redis 企業快取。

範例 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 企業快取叢集

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 企業快取叢集，而不需要任何相關聯的資料庫來保存數據。

範例 4：使用異地復寫的資料庫建立 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 之異地複寫資料庫的快取名稱 MyCache

參數

-AofPersistenceEnabled

[預覽]設定是否啟用 AOF 持續性。啟用 AOF 持續性之後，您將無法停用它。稍後會新增啟用之後停用 AOF 持續性的支援。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AofPersistenceFrequency

[預覽]設定啟用 AOF 持續性時，數據寫入磁碟的頻率。允許的值：1s，一律

類型:	AofFrequency
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AsJob

以作業身分執行命令

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Capacity

Redis Enterprise 叢集的大小 - 預設為 2 或 3，視 SKU 而定。允許的值為適用於企業 SKU 的 [2、4、6、...]，以及 Flash SKU 的 [3、9、15、 ...]。

類型:	Int32
別名:	SkuCapacity
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ClientProtocol

指定 redis 用戶端是否可以使用 TLS 加密或純文字 redis 通訊協議進行連線 - 預設值為 [加密允許的值：加密、純文字]

類型:	Protocol
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ClusteringPolicy

叢集原則 - 預設為在建立時間指定的 OSSCluster。允許的值：EnterpriseCluster、OSSCluster

類型:	ClusteringPolicy
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ClusterName

Redis Enterprise 叢集的名稱。

類型:	String
別名:	Name
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-Confirm

執行 Cmdlet 之前先提示您確認。

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-CustomerManagedKeyEncryptionKeyUrl

金鑰加密金鑰 URL 僅設定版本。例如： https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78"

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DefaultProfile

用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。

類型:	PSObject
別名:	AzureRMContext, AzureCredential
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-EvictionPolicy

Redis 收回原則 - 預設值為 VolatileLRU 允許的值：AllKeysLFU、AllKeysLRU、AllKeysRandom、VolatileLRU、VolatileLFU、VolatileTTL、VolatileRandom、NoEviction

類型:	EvictionPolicy
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-GroupNickname

連結資料庫資源群組的名稱

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-IdentityType

受控服務識別的類型（允許 SystemAssigned 和 UserAssigned 類型）。

類型:	ManagedServiceIdentityType
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-IdentityUserAssignedIdentity

與資源相關聯的使用者指派身分識別集。 userAssignedIdentities 字典索引鍵的格式為 ARM 資源標識符：'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}。字典值可以是要求中的空白物件（{}）。

類型:	Hashtable
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-KeyEncryptionKeyIdentityType

此 API 版本僅支援 userAssignedIdentity;未來可能支援其他類型

類型:	CmkIdentityType
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-KeyEncryptionKeyIdentityUserAssignedIdentityResourceId

使用者指派的身分識別可用來存取金鑰加密金鑰 URL。例如：/subscriptions/<sub uuid>/resourceGroups/<resource group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-LinkedDatabase

要與這個資料庫連結的資料庫資源清單若要建構，請參閱 GEOREPLICATIONLINKEDDATABASE 屬性的 NOTES 區段，並建立哈希表。若要建構，請參閱 LINKEDDATABASE 屬性的 NOTES 區段並建立哈希表。

類型:	ILinkedDatabase[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Location

資源所在的地理位置。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-MinimumTlsVersion

叢集支援的最低 TLS 版本 - 預設值為 1.2 允許的值：1.0、1.1、1.2

類型:	TlsVersion
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Module

要在此資料庫中啟用的選擇性 redis 模組集合 - 模組只能在建立時新增。若要建構，請參閱MODULE屬性的NOTES一節，並建立哈希表。

類型:	IModule[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-NoDatabase

進階 - 不要自動建立預設資料庫。警告：在您建立資料庫之前，快取將無法使用。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-NoWait

以異步方式執行命令

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Port

資料庫端點的 TCP 連接埠 - 預設為在建立時指定的可用埠。

類型:	Int32
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-RdbPersistenceEnabled

[預覽]設定是否啟用 RDB 持續性。啟用 RDB 持續性之後，您將無法將其停用。啟用之後停用 RDB 持續性的支援將會在稍後新增。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-RdbPersistenceFrequency

[預覽]設定啟用 RDB 持續性時，建立資料庫快照集的頻率。允許的值：1h、6h、12h

類型:	RdbFrequency
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ResourceGroupName

資源群組的名稱。名稱不區分大小寫。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-Sku

要部署的 Redis Enterprise 叢集類型。允許的值：Enterprise_E1、Enterprise_E5、Enterprise_E10、Enterprise_E20、Enterprise_E50、Enterprise_E100、Enterprise_E200、Enterprise_E400、EnterpriseFlash_F300、EnterpriseFlash_F700、EnterpriseFlash_F1500

類型:	SkuName
別名:	SkuName
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-SubscriptionId

目標訂用帳戶的標識碼。

類型:	String
Position:	Named
預設值:	(Get-AzContext).Subscription.Id
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Tag

叢集資源標籤。

類型:	Hashtable
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。未執行 Cmdlet。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Zone

將部署此叢集的可用性區域。

類型:	String[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸出

ICluster

共用方式為