New-AzureRmRedisCache

參考

模組:: AzureRM.RedisCache

建立 Redis 快取。

警告

自 2024 年 2 月 29 日起，AzureRM PowerShell 模組已正式淘汰。建議使用者從 AzureRM 遷移至 Az PowerShell 模組，以確保持續支援和更新。

雖然 AzureRM 模組可能仍可運作，但不再維護或支援它，但會根據用戶的判斷權和風險放置任何繼續使用。如需轉換至 Az 模組的指引，請參閱我們的移轉資源。

語法

New-AzureRmRedisCache
   -ResourceGroupName <String>
   -Name <String>
   -Location <String>
   [-Size <String>]
   [-Sku <String>]
   [-RedisConfiguration <Hashtable>]
   [-EnableNonSslPort <Boolean>]
   [-TenantSettings <Hashtable>]
   [-ShardCount <Int32>]
   [-SubnetId <String>]
   [-StaticIP <String>]
   [-Tag <Hashtable>]
   [-Zone <String[]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

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

範例

範例 1：建立 Redis 快取

PS C:\>New-AzureRmRedisCache -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 快取

PS C:\>New-AzureRmRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "North Central US" -Size 250MB -Sku "Standard" -RedisConfiguration @{"maxmemory-policy" = "allkeys-random"} -Force

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

此命令會建立 Redis 快取。

參數

-Confirm

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

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

-DefaultProfile

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

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

-EnableNonSslPort

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

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

-Location

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

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

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	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 PowerShellhttps://go.microsoft.com/fwlink/?LinkId=800051 管理 Azure Redis 快取（https://go.microsoft.com/fwlink/?LinkId=800051）。

類型:	Hashtable
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
C0
C1
C2
C3
C4
C5
C6
250MB
1GB
2.5GB
6GB
13GB
26GB
53GB 預設值為1GB或 C1。

類型:	String
接受的值:	P1, P2, P3, P4, C0, C1, C2, C3, C4, C5, C6, 250MB, 1GB, 2.5GB, 6GB, 13GB, 26GB, 53GB
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

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

-Tag

表示標記的哈希表。

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

-TenantSettings

此參數已被取代。

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

-WhatIf

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

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

-Zone

區域清單。

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

輸入

String

Hashtable

Nullable<T>[[System.Boolean, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

Nullable<T>[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

String[]

輸出

RedisCacheAttributesWithAccessKeys

共用方式為

New-AzureRmRedisCache

語法

Description

範例

範例 1：建立 Redis 快取

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

參數

-Confirm

-DefaultProfile

-EnableNonSslPort

-Location

-Name

-RedisConfiguration

-ResourceGroupName

-ShardCount

-Size

-Sku

-StaticIP

-SubnetId

-Tag

-TenantSettings

-WhatIf

-Zone

輸入

輸出

其他資源

共用方式為

New-AzureRmRedisCache

語法

Description

範例

範例 1：建立 Redis 快取

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

參數

-Confirm

-DefaultProfile

-EnableNonSslPort

-Location

-Name

-RedisConfiguration

-ResourceGroupName

-ShardCount

-Size

-Sku

-StaticIP

-SubnetId

-Tag

-TenantSettings

-WhatIf

-Zone

輸入

輸出

相關連結

其他資源