New-AzRedisCache

參考

模組:: Az.RedisCache

建立 Redis 快取。

Syntax

New-AzRedisCache
   -ResourceGroupName <String>
   -Name <String>
   -Location <String>
   [-Size <String>]
   [-Sku <String>]
   [-RedisConfiguration <Hashtable>]
   [-EnableNonSslPort <Boolean>]
   [-TenantSettings <Hashtable>]
   [-ShardCount <Int32>]
   [-MinimumTlsVersion <String>]
   [-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         : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          SecondaryKey       : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          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         : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          SecondaryKey       : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          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         : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          SecondaryKey       : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          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         : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          SecondaryKey       : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          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-Az 儲存體 AccountKey -ResourceGroupName $resourceGroupName -Name $storageAccountName。
從上述的輸出中，複製任何密鑰。
以下列格式放置記憶體帳戶金鑰和記憶體帳戶名稱，以取得記憶體帳戶的連接字串。

連線 ion 字串格式：- “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=pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=;EndpointSuffix=mySuffix"; "rdb-backup-frequency" = "30"}

PrimaryKey         : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          SecondaryKey       : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          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=pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=;EndpointSuffix=mySuffix"}

PrimaryKey         : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          SecondaryKey       : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          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 之前先提示您確認。

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

-DefaultProfile

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

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableNonSslPort

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

Type:	Nullable<T>[Boolean]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-IdentityType

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

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

-Location

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

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

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

-MinimumTlsVersion

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

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

-Name

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

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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

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

-RedisVersion

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

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

-ResourceGroupName

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

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

-ShardCount

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

Type:	Nullable<T>[Int32]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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。

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

-Sku

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

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

Type:	String
Accepted values:	Basic, Standard, Premium
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-StaticIP

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

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

-SubnetId

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

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

-Tag

表示標記的哈希表。

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

-TenantSettings

此參數已被取代。

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

-UpdateChannel

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

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

-UserAssignedIdentity

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

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

-WhatIf

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

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

-Zone

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

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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

Syntax

Description

範例

範例 1：建立 Redis 快取

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

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

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

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

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

參數

-Confirm

-DefaultProfile

-EnableNonSslPort

-IdentityType

-Location

-MinimumTlsVersion

-Name

-RedisConfiguration

-RedisVersion

-ResourceGroupName

-ShardCount

-Size

-Sku

-StaticIP

-SubnetId

-Tag

-TenantSettings

-UpdateChannel

-UserAssignedIdentity

-WhatIf

-Zone

輸入

輸出

意見反應

其他資源

New-AzRedisCache

Syntax

Description

範例

範例 1：建立 Redis 快取

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

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

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

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

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

參數

-Confirm

-DefaultProfile

-EnableNonSslPort

-IdentityType

-Location

-MinimumTlsVersion

-Name

-RedisConfiguration

-RedisVersion

-ResourceGroupName

-ShardCount

-Size

-Sku

-StaticIP

-SubnetId

-Tag

-TenantSettings

-UpdateChannel

-UserAssignedIdentity

-WhatIf

-Zone

輸入

輸出

相關連結

意見反應

其他資源

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

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

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