New-AzRedisCache

參考

模組:: Az.RedisCache

建立 Redis 快取。

語法

New-AzRedisCache
   -ResourceGroupName <String>
   -Name <String>
   -Location <String>
   [-Size <String>]
   [-Sku <String>]
   [-RedisConfiguration <Hashtable>]
   [-EnableNonSslPort <Boolean>]
   [-TenantSettings <Hashtable>]
   [-ShardCount <Int32>]
   [-MinimumTlsVersion <String>]
   [-DisableAccessKeyAuthentication <Boolean>]
   [-SubnetId <String>]
   [-StaticIP <String>]
   [-Tag <Hashtable>]
   [-Zone <String[]>]
   [-RedisVersion <String>]
   [-UpdateChannel <String>]
   [-IdentityType <String>]
   [-UserAssignedIdentity <String[]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

New-AzRedisCache Cmdlet 會建立 Azure Redis 快取。

範例

範例 1：建立 Redis 快取

New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "North Central US"

PrimaryKey         : ******
          SecondaryKey       : ******
          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 快取。

範例 2：建立標準 SKU Redis 快取

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

PrimaryKey         : ******
          SecondaryKey       : ******
          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               : []

此 Cmdlet 會使用 Azure Cache for Redis 建立快取。

範例 3：建立區域備援快取

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

PrimaryKey         : ******
          SecondaryKey       : ******
          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}

此命令會在 Mutliple 區域中建立 Redis 實例的 Azure 快取。

範例 4：建立啟用快取虛擬網絡

建立虛擬網絡啟用快取的需求。

在您想要在其中建立 redis 快取的相同資源群組中建立虛擬網路。您可以從 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         : ******
          SecondaryKey       : ******
          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 的數據持續性

持續性會將 Redis 數據寫入您擁有和管理的 Azure 儲存體帳戶。因此，設定數據持續性之前，您需要在相同的資源群組中擁有記憶體帳戶。選擇與快取位於相同區域和訂用帳戶中的記憶體帳戶，因此建議使用進階儲存體帳戶，因為進階記憶體的輸送量較高。

建立記憶體帳戶之後，請使用此程式取得記憶體帳戶連接字串。

在 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=******;EndpointSuffix=mySuffix"; "rdb-backup-frequency" = "30"}

PrimaryKey         : ******
          SecondaryKey       : ******
          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 （您可以選擇性地設定另一個記憶體帳戶。如果設定了第二個記憶體帳戶，則寫入複本快取會寫入這個第二個記憶體帳戶。

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=******;EndpointSuffix=mySuffix"}

PrimaryKey         : ******
          SecondaryKey       : ******
          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

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

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

-DefaultProfile

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

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

-DisableAccessKeyAuthentication

選擇性：當設定為 true 時，會停用透過存取密鑰向 Redis 進行驗證。預設值為 False。

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

-EnableNonSslPort

指出是否已啟用非 SSL 連接埠。默認值為$False（停用非 SSL 埠）。

類型:	Nullable<T>[Boolean]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-IdentityType

指定用於 Azure Cache for Redis 的身分識別類型。有效值：“SystemAssigned” 或 “UserAssigned” 或 “SystemAssignedUserAssigned” 或 “None”

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

-Location

指定要在其中建立 Redis 快取的位置。有效值為：

美國中北部
美國中南部
美國中部
西歐
北歐
美國西部
美國東部
美國東部 2
日本東部
日本西部
巴西南部
東南亞
東亞
澳大利亞東部
澳大利亞東南部

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

-MinimumTlsVersion

指定客戶端連線至快取所需的 TLS 版本。

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

-Name

指定要建立的 Redis 快取名稱。

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

-RedisConfiguration

指定 Redis 組態設定。此參數可接受的值為：

已啟用 rdb-backup-enabled。指定已啟用 Redis 資料持續性。僅限進階層。
rdb-storage-connection-string。指定 Redis 數據持續性記憶體帳戶的連接字串。僅限進階層。
rdb-backup-frequency。指定 Redis 數據持續性的備份頻率。僅限進階層。
maxmemory-reserved。設定保留給非快取進程的記憶體。標準和進階層。
maxmemory-policy。設定快取的收回原則。所有定價層。
notify-keyspace-events。設定 keyspace 通知。標準和進階層。
hash-max-ziplist-entries。設定小型匯總數據類型的記憶體優化。標準和進階層。
hash-max-ziplist-value。設定小型匯總數據類型的記憶體優化。標準和進階層。
set-max-intset-entries。設定小型匯總數據類型的記憶體優化。標準和進階層。
zset-max-ziplist-entries。設定小型匯總數據類型的記憶體優化。標準和進階層。
zset-max-ziplist-value。設定小型匯總數據類型的記憶體優化。標準和進階層。
資料庫。設定資料庫數目。這個屬性僅可以在建立快取時設定。標準和進階層。如需詳細資訊，請參閱使用 Azure PowerShellhttp://go.microsoft.com/fwlink/?LinkId=800051 管理 Azure Redis 快取（http://go.microsoft.com/fwlink/?LinkId=800051）。
preferred-data-archive-auth-method Preferred auth 方法，用來與用於數據封存的記憶體帳戶通訊、指定 SAS 或 ManagedIdentity，預設值為 SAS
preferred-data-persistence-auth-method 慣用的驗證方法，用來與用於數據持續性的記憶體帳戶通訊，指定 SAS 或 ManagedIdentity，預設值為 SAS

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

-RedisVersion

Redis 版本。這的格式應該是 'major[.minor]' （只需要 'major' ）或值 'latest'，其指的是可用的最新穩定 Redis 版本。支援的版本：4.0、6.0（最新版）。預設值為『latest』。

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

-ResourceGroupName

指定要在其中建立 Redis 快取的資源群組名稱。

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

-ShardCount

指定要在進階叢集快取上建立的分區數目。此參數可接受的值為：

類型:	Nullable<T>[Int32]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-Size

指定 Redis 快取的大小。有效值為：

P1
P2
P3
P4
P5
C0
C1
C2
C3
C4
C5
C6
250MB
1GB
2.5GB
6GB
13GB
26GB
53GB 預設值為1GB或 C1。

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

-Sku

指定要建立的 Redis 快取 SKU。有效值為：

基本
標準
進階預設值為 Standard。

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

-StaticIP

在 Redis 快取的子網中指定唯一的 IP 位址。如果您未指定此參數的值，此 Cmdlet 會從子網選擇IP位址。

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

-SubnetId

虛擬網路中要部署 Azure Cache for Redis 之子網的完整資源識別碼。範例格式：/subscriptions/{subid}/resourceGroups/{resourceGroupName}/Microsoft。{Network|ClassicNetwork}/VirtualNetworks/{vnetName}/subnets/{subnetName}

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

-Tag

表示標記的哈希表。

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

-TenantSettings

此參數已被取代。

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

-UpdateChannel

選擇性：指定您 Redis 快取將接收之每月 Redis 更新的更新通道。使用「預覽」更新通道的快取，至少比「穩定」通道快取提前 4 周取得最新的 Redis 更新。默認值為『Stable』。可能的值包括：'Stable'、'Preview'

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

-UserAssignedIdentity

指定要與 Azure Cache for Redis 相關聯的一或多個逗號分隔使用者身分識別。使用者身分識別參考的格式為 ARM 資源標識符：'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identities/{identityName}'

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

-WhatIf

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

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

-Zone

具有可用性區域的 Azure 區域清單。

類型:	String[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	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

語法

Description

範例

範例 1：建立 Redis 快取

範例 2：建立標準 SKU Redis 快取

範例 3：建立區域備援快取

範例 4：建立啟用快取虛擬網絡

範例 5：設定進階 Azure Cache for Redis 的數據持續性

範例 6：設定進階 Azure Cache for Redis 的數據持續性 - 已啟用 AOF 備份

參數

-Confirm

-DefaultProfile

-DisableAccessKeyAuthentication

-EnableNonSslPort

-IdentityType

-Location

-MinimumTlsVersion

-Name

-RedisConfiguration

-RedisVersion

-ResourceGroupName

-ShardCount

-Size

-Sku

-StaticIP

-SubnetId

-Tag

-TenantSettings

-UpdateChannel

-UserAssignedIdentity

-WhatIf

-Zone

輸入

輸出

其他資源

共用方式為

New-AzRedisCache

語法

Description

範例

範例 1：建立 Redis 快取

範例 2：建立標準 SKU Redis 快取

範例 3：建立區域備援快取

範例 4：建立啟用快取 虛擬網絡

範例 5：設定進階 Azure Cache for Redis 的數據持續性

範例 6：設定進階 Azure Cache for Redis 的數據持續性 - 已啟用 AOF 備份

參數

-Confirm

-DefaultProfile

-DisableAccessKeyAuthentication

-EnableNonSslPort

-IdentityType

-Location

-MinimumTlsVersion

-Name

-RedisConfiguration

-RedisVersion

-ResourceGroupName

-ShardCount

-Size

-Sku

-StaticIP

-SubnetId

-Tag

-TenantSettings

-UpdateChannel

-UserAssignedIdentity

-WhatIf

-Zone

輸入

輸出

相關連結

其他資源

範例 4：建立啟用快取虛擬網絡