New-AzRedisEnterpriseCache

模組:: Az.RedisEnterpriseCache Module

建立 Redis Enterprise 快取。

語法

CreateClusterWithDatabase (預設值)

New-AzRedisEnterpriseCache
    -ClusterName <String>
    -ResourceGroupName <String>
    -Location <String>
    -Sku <SkuName>
    [-SubscriptionId <String>]
    [-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>]
    [-PublicNetworkAccess <PublicNetworkAccess>]
    [-IdentityType <ManagedServiceIdentityType>]
    [-IdentityUserAssignedIdentity <Hashtable>]
    [-KeyEncryptionKeyIdentityType <CmkIdentityType>]
    [-KeyEncryptionKeyIdentityUserAssignedIdentityResourceId <String>]
    [-AofPersistenceEnabled]
    [-AofPersistenceFrequency <AofFrequency>]
    [-RdbPersistenceEnabled]
    [-RdbPersistenceFrequency <RdbFrequency>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateClusterOnly

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

Description

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

範例

範例 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：使用異地複寫資料庫建立 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}

此命令會建立快取名稱 MyCache，其中包含名為 default 的異地複寫資料庫

參數

-AccessKeysAuthentication

此屬性可以是 Enabled/Disabled，以允許或拒絕目前存取金鑰的存取。即使在建立資料庫之後，也可以更新。

參數屬性

類型:	AccessKeysAuthentication
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

CreateClusterWithDatabase

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-AofPersistenceEnabled

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

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

CreateClusterWithDatabase

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-AofPersistenceFrequency

[預覽]設定在啟用 AOF 持續性時將資料寫入磁碟的頻率。允許的值：1秒，一律

參數屬性

類型:	AofFrequency
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

CreateClusterWithDatabase

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-AsJob

以作業身分執行命令

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Capacity

RedisEnterprise 叢集的大小。根據 SKU，預設為 2 或 3 或不適用。Enterprise_* SKU 的有效值為（2， 4， 6， ...）， EnterpriseFlash_* SKU 為（3， 9， 15， ...）。不支援其他 SKU 容量自變數。

參數屬性

類型:	Int32
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	SkuCapacity

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ClientProtocol

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

參數屬性

類型:	Protocol
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

CreateClusterWithDatabase

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ClusteringPolicy

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

參數屬性

類型:	ClusteringPolicy
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

CreateClusterWithDatabase

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ClusterName

Redis Enterprise 叢集的名稱。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	名稱

參數集

(All)

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	參見

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-CustomerManagedKeyEncryptionKeyUrl

金鑰加密金鑰僅版本化的 URL。前任： https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78"

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-DefaultProfile

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

參數屬性

類型:	PSObject
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	AzureRMContext, AzureCredential

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-EvictionPolicy

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

參數屬性

類型:	EvictionPolicy
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

CreateClusterWithDatabase

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-GroupNickname

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

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

CreateClusterWithDatabase

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-HighAvailability

默認為啟用。只能從停用更新為啟用。如果 highAvailability 已停用，則不會復寫數據集。這會影響可用性 SLA，並增加資料遺失的風險。

參數屬性

類型:	HighAvailability
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-IdentityType

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

參數屬性

類型:	ManagedServiceIdentityType
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-IdentityUserAssignedIdentity

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

參數屬性

類型:	Hashtable
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-KeyEncryptionKeyIdentityType

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

參數屬性

類型:	CmkIdentityType
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-KeyEncryptionKeyIdentityUserAssignedIdentityResourceId

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

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-LinkedDatabase

要與此資料庫連結的資料庫資源清單若要建構，請參閱 GEOREPLICATIONLINKEDDATABASE 內容的 NOTES 一節，並建立雜湊表。若要建構，請參閱 NOTES 區段，以取得 LINKEDDATABASE 內容，並建立雜湊表。

參數屬性

類型:	ILinkedDatabase[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

CreateClusterWithDatabase

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Location

資源所在的地理位置。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-MinimumTlsVersion

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

參數屬性

類型:	TlsVersion
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Module

在此資料庫中啟用的可選 redis 模組集 - 模組只能在建立時新增。若要建構，請參閱 NOTES 一節以取得 MODULE 內容，並建立雜湊表。

參數屬性

類型:	IModule[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

CreateClusterWithDatabase

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-NoDatabase

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

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

CreateClusterOnly

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-NoWait

以異步方式執行命令

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Port

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

參數屬性

類型:	Int32
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

CreateClusterWithDatabase

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-PublicNetworkAccess

公用網路流量是否可以存取Redis叢集。只能設定「啟用」或「停用」。

參數屬性

類型:	PublicNetworkAccess
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-RdbPersistenceEnabled

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

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

CreateClusterWithDatabase

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-RdbPersistenceFrequency

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

參數屬性

類型:	RdbFrequency
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

CreateClusterWithDatabase

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ResourceGroupName

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

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	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
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	SKU名稱

參數集

(All)

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-SubscriptionId

目標訂用帳戶的標識碼。

參數屬性

類型:	String
預設值:	(Get-AzContext).Subscription.Id
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Tag

叢集資源標籤。

參數屬性

類型:	Hashtable
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。指令未執行。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	威斯康辛

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Zone

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

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

CommonParameters

此 cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。如需詳細資訊，請參閱 about_CommonParameters。

輸出

ICluster

意見反應

此頁面對您有幫助嗎？

共用方式為

New-AzRedisEnterpriseCache

語法

CreateClusterWithDatabase (預設值)

CreateClusterOnly

Description

範例

範例 1：建立 Redis Enterprise 快取

範例 2：使用一些選擇性參數建立 Redis Enterprise 快取

範例 3：進階 - 建立沒有相關聯資料庫的 Redis Enterprise 快取叢集

範例 4：使用異地複寫資料庫建立 Redis Enterprise 快取

參數

-AccessKeysAuthentication

參數屬性

參數集

-AofPersistenceEnabled

參數屬性

參數集

-AofPersistenceFrequency

參數屬性

參數集

-AsJob

參數屬性

參數集

-Capacity

參數屬性

參數集

-ClientProtocol

參數屬性

參數集

-ClusteringPolicy

參數屬性

參數集

-ClusterName

參數屬性

參數集

-Confirm

參數屬性

參數集

-CustomerManagedKeyEncryptionKeyUrl

參數屬性

參數集

-DefaultProfile

參數屬性

參數集

-EvictionPolicy

參數屬性

參數集

-GroupNickname

參數屬性

參數集

-HighAvailability

參數屬性

參數集

-IdentityType

參數屬性

參數集

-IdentityUserAssignedIdentity

參數屬性

參數集

-KeyEncryptionKeyIdentityType

參數屬性

參數集

-KeyEncryptionKeyIdentityUserAssignedIdentityResourceId

參數屬性

參數集

-LinkedDatabase

參數屬性

參數集

-Location

參數屬性

參數集

-MinimumTlsVersion

參數屬性

參數集

-Module

參數屬性

參數集

-NoDatabase

參數屬性