New-AzRedisCache

模組:: Az.RedisCache Module

建立 Redis 快取。

語法

Default (預設值)

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>]
    [-ZonalAllocationPolicy <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 會使用適用於 Redis 的 Azure 快取來建立快取。

範例 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}

此命令會在多個區域中建立適用於 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：設定適用於 Redis 的進階 Azure 快取的資料持續性

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

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

在 powershell 中 Get-AzStorageAccountKey -ResourceGroupName $resourceGroupName -Name $storageAccountName 執行此命令。
從上面的輸出中，複製任何鍵。
將儲存體帳戶金鑰和儲存體帳戶名稱以下列格式放置，以取得儲存體帳戶的連接字串。

連接字串格式：- “DefaultEndpointsProtocol=https;帳戶名稱={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：設定適用於 Redis 的進階 Azure 快取 - 已啟用 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
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	參見

參數集

(All)

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

-DefaultProfile

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

參數屬性

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

參數集

(All)

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

-DisableAccessKeyAuthentication

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

參數屬性

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

參數集

(All)

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

-EnableNonSslPort

指出是否啟用非 SSL 埠。預設值為$False（非SSL埠已停用）。

參數屬性

類型:	Nullable<T>[Boolean]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

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

-IdentityType

指定用於 Redis 的 Azure 快取的身分識別類型。有效值：「SystemAssigned」或「UserAssigned」或「SystemAssignedUserAssigned」或「None」

參數屬性

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

參數集

(All)

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

-Location

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

美國中北部
美國中南部
Central US
西歐
北歐
美國西部
美國東部
美國東部 2
日本東部
日本西部
巴西南部
東南亞
東亞
Australia East
Australia Southeast

參數屬性

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

參數集

(All)

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

-MinimumTlsVersion

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

參數屬性

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

參數集

(All)

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

-Name

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

參數屬性

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

參數集

(All)

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

-RedisConfiguration

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

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

參數屬性

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

參數集

(All)

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

-RedisVersion

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

參數屬性

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

參數集

(All)

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

-ResourceGroupName

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

參數屬性

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

參數集

(All)

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

-ShardCount

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

參數屬性

類型:	Nullable<T>[Int32]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

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

-Size

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

P1
P2
P3
P4
P5
C0
C1
C2
C3
C4
C5
C6
250兆位元組
1GB
2.5GB
6GB
13GB
26GB 字節
53GB 預設值為 1GB 或 C1。

參數屬性

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

參數集

(All)

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

-Sku

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

基本
標準
進階預設值為「標準」。

參數屬性

類型:	String
預設值:	None
接受的值:	Basic, Standard, Premium
支援萬用字元:	False
不要顯示:	False

參數集

(All)

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

-StaticIP

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

參數屬性

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

參數集

(All)

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

-SubnetId

虛擬網路中子網路的完整資源識別碼，以部署適用於 Redis 的 Azure 快取。範例格式：/subscriptions/{subid}/resourceGroups/{resourceGroupName}/Microsoft。{網路|ClassicNetwork}/VirtualNetworks/{vnetName}/subnets/{subnetName}

參數屬性

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

參數集

(All)

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

-Tag

代表標籤的雜湊表。

參數屬性

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

參數集

(All)

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

-TenantSettings

此參數已被取代。

參數屬性

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

參數集

(All)

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

-UpdateChannel

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

參數屬性

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

參數集

(All)

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

-UserAssignedIdentity

指定一或多個逗號分隔的使用者身分識別，以與適用於 Redis 的 Azure 快取相關聯。使用者身分識別參考會是 ARM 資源識別碼，格式為：'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identities/{identityName}'

參數屬性

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

參數集

(All)

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

-WhatIf

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

參數屬性

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

參數集

(All)

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

-ZonalAllocationPolicy

選擇性：選擇性：指定如何將可用區域配置給 Redis 快取。「自動」可啟用區域備援，Azure 會根據區域可用性和容量自動選取區域。 'UserDefined' 會選取您使用 'zones' 參數傳入的可用性區域。 'NoZones' 會產生非區域性快取。如果未傳遞 'zonalAllocationPolicy'，當區域傳入時，它將會設定為 'UserDefined'，否則，它會在區域不支援的區域和區域不支援的區域 'NoZones' 中設定為 'Automatic'。

參數屬性

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

參數集

(All)

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

-Zone

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

參數屬性

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

參數集

(All)

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

CommonParameters

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

輸出

RedisCacheAttributesWithAccessKeys

意見反應

此頁面對您有幫助嗎？

共用方式為

New-AzRedisCache

語法

Default (預設值)

Description

範例

範例 1：建立 Redis 快取

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

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

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

範例 5：設定適用於 Redis 的進階 Azure 快取的資料持續性

範例 6：設定適用於 Redis 的進階 Azure 快取 - 已啟用 AOF 備份的資料持續性

參數

-Confirm

參數屬性

參數集

-DefaultProfile

參數屬性

參數集

-DisableAccessKeyAuthentication

參數屬性

參數集

-EnableNonSslPort

參數屬性

參數集

-IdentityType

參數屬性

參數集

-Location

參數屬性

參數集

-MinimumTlsVersion

參數屬性

參數集

-Name

參數屬性

參數集

-RedisConfiguration

參數屬性

參數集

-RedisVersion

參數屬性

參數集

-ResourceGroupName

參數屬性

參數集

-ShardCount

參數屬性

參數集

-Size

參數屬性

參數集

-Sku

參數屬性

參數集

-StaticIP

參數屬性

參數集

-SubnetId

參數屬性

參數集

-Tag

參數屬性

參數集

-TenantSettings

參數屬性

參數集

-UpdateChannel

參數屬性

參數集

-UserAssignedIdentity

參數屬性

參數集

-WhatIf

參數屬性

參數集

-ZonalAllocationPolicy

參數屬性

參數集

-Zone