New-AzRedisCache

  • Referensi
Modul:
Az.RedisCache

Membuat Redis Cache.

Sintaks

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

Deskripsi

Cmdlet New-AzRedisCache membuat Azure Redis Cache.

Contoh

Contoh 1: Membuat Cache 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               : []

Perintah ini membuat Redis Cache.

Contoh 2: Membuat Cache Redis SKU Standar

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 ini membuat cache menggunakan Azure Cache for Redis.

Contoh 3: Membuat Singgahan Redundan Zona

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}

Perintah ini membuat instans Azure cache for Redis di zona mutliple.

Contoh 4: Buat Virtual Network aktifkan Cache

Persyaratan untuk membuat Virtual Network mengaktifkan cache.

  1. Buat jaringan virtual dalam grup sumber daya yang sama tempat Anda ingin membuat cache redis Anda. Anda dapat membuat jaringan virtual dari perintah powershell New-AzVirtualNetwork .
  2. Anda akan memerlukan SubnetID untuk VNET mengaktifkan cache. Sintaks SubnetID diberikan di bawah ini.

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

Contoh 5: Mengonfigurasi persistensi data untuk Azure Cache for Redis Premium

Persistence menulis data Redis ke akun Microsoft Azure Storage yang Anda miliki dan kelola. Jadi sebelum mengonfigurasi persistensi data, Anda harus memiliki akun penyimpanan dalam grup sumber daya yang sama. Pilih akun penyimpanan di wilayah dan langganan yang sama dengan cache, dan akun Microsoft Azure Storage Premium direkomendasikan karena penyimpanan premium memiliki throughput yang lebih tinggi.

Setelah membuat akun penyimpanan, dapatkan akun penyimpanan string koneksi menggunakan prosedur ini.

  1. Jalankan perintah ini Get-AzStorageAccountKey -ResourceGroupName $resourceGroupName -Name $storageAccountName di powershell.
  2. Dari output di atas, salin kunci apa pun.
  3. Masukkan kunci akun penyimpanan dan nama akun penyimpanan dalam format di bawah ini untuk mendapatkan string koneksi akun penyimpanan Anda.

Format String Koneksi ion :- "DefaultEndpointsProtocol=https; AccountName={storageAccountName}; AccountKey={storageAccountKey}; EndpointSuffix=mySuffix"

Anda harus memiliki pengaturan konfigurasi Redis tertentu untuk mengaktifkan persistensi data.

Untuk mengaktifkan pencadangan RDB

  • rdb-backup-enabled (Set true atau false)
  • rdb-storage-connection-string (Berikan string koneksi dalam format di atas.)
  • Frekuensi pencadangan rdb (Atur interval cadangan dalam hitungan menit. Anda hanya dapat memilih dari - 15, 30, 60, 360, 720 dan 1440 menit.)
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               : []

Contoh 6: Mengonfigurasi persistensi data untuk Azure Cache for Redis Premium - Pencadangan AOF diaktifkan

Untuk pencadangan AOF diaktifkan.

  • aof-backup-enabled (Set true atau false),
  • aof-storage-connection-string-0 (Berikan string koneksi dalam format di atas.)
  • aof-storage-connection-string-1 (Anda dapat secara opsional mengonfigurasi akun penyimpanan lain. Jika akun penyimpanan kedua dikonfigurasi, tulisan ke cache replika ditulis ke akun penyimpanan kedua ini.)
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               : []

Parameter

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

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

-DefaultProfile

Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan azure.

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

-EnableNonSslPort

Menunjukkan apakah port non-SSL diaktifkan. Nilai default adalah $False (port non-SSL dinonaktifkan).

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

-IdentityType

Menentukan jenis identitas yang digunakan untuk Azure Cache for Redis. Nilai yang valid: "SystemAssigned" atau "UserAssigned" atau "SystemAssignedUserAssigned" atau "None"

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

-Location

Menentukan lokasi untuk membuat Redis Cache. Nilai yang valid adalah:

  • US Tengah Utara
  • US Tengah Selatan
  • AS Tengah
  • Eropa Barat
  • Eropa Utara
  • US Barat
  • AS Timur
  • AS Timur 2
  • Jepang Timur
  • Jepang Barat
  • Brasil Selatan
  • Asia Tenggara
  • Asia Timur
  • Australia Timur
  • Australia Tenggara
Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-MinimumTlsVersion

Tentukan versi TLS yang diperlukan oleh klien untuk menyambungkan ke cache.

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

-Name

Menentukan nama Redis Cache yang akan dibuat.

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

-RedisConfiguration

Tentukan pengaturan konfigurasi Redis. Nilai yang dapat diterima untuk parameter ini adalah:

  • rdb-backup-enabled. Menentukan bahwa persistensi data Redis diaktifkan. Tingkat premium saja.
  • rdb-storage-connection-string. Menentukan string koneksi ke akun Penyimpanan untuk persistensi data Redis. Tingkat premium saja.
  • rdb-backup-frequency. Menentukan frekuensi pencadangan untuk persistensi data Redis. Tingkat premium saja.
  • maxmemory-reserved. Mengonfigurasi memori yang dicadangkan untuk proses non-cache. Tingkat Standar dan Premium.
  • maxmemory-policy. Mengonfigurasi kebijakan pengeluaran untuk cache. Semua tingkat harga.
  • notify-keyspace-events. Mengonfigurasi pemberitahuan keyspace. Tingkat standar dan premium.
  • hash-max-ziplist-entries. Mengonfigurasi pengoptimalan memori untuk jenis data agregat kecil. Tingkat Standar dan Premium.
  • hash-max-ziplist-value. Mengonfigurasi pengoptimalan memori untuk jenis data agregat kecil. Tingkat Standar dan Premium.
  • set-max-intset-entries. Mengonfigurasi pengoptimalan memori untuk jenis data agregat kecil. Tingkat Standar dan Premium.
  • zset-max-ziplist-entries. Mengonfigurasi pengoptimalan memori untuk jenis data agregat kecil. Tingkat Standar dan Premium.
  • zset-max-ziplist-value. Mengonfigurasi pengoptimalan memori untuk jenis data agregat kecil. Tingkat Standar dan Premium.
  • Database. Konfigurasikan jumlah database. Properti ini hanya dapat dikonfigurasi pada pembuatan cache. Tingkat Standar dan Premium. Untuk informasi selengkapnya, lihat Mengelola Azure Redis Cache dengan Azure PowerShellhttp://go.microsoft.com/fwlink/?LinkId=800051 (http://go.microsoft.com/fwlink/?LinkId=800051).
  • metode autentikasi pilihan-arsip-arsip-data metode autentikasi untuk berkomunikasi ke akun penyimpanan yang digunakan untuk arsip data, tentukan SAS atau ManagedIdentity, nilai defaultnya adalah SAS
  • metode autentikasi pilihan-data-persistence-auth-method Untuk berkomunikasi ke akun penyimpanan yang digunakan untuk persistensi data, tentukan SAS atau ManagedIdentity, nilai defaultnya adalah SAS
Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-RedisVersion

Versi Redis. Ini harus dalam bentuk 'major[.minor]' (hanya 'mayor' yang diperlukan) atau nilai 'terbaru' yang mengacu pada versi Redis stabil terbaru yang tersedia. Versi yang didukung: 4.0, 6.0 (terbaru). Nilai defaultnya adalah 'terbaru'.

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

-ResourceGroupName

Menentukan nama grup sumber daya untuk membuat Redis Cache.

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

-ShardCount

Menentukan jumlah shard yang akan dibuat pada cache kluster Premium. Nilai yang dapat diterima untuk parameter ini adalah:

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Size

Menentukan ukuran Redis Cache. Nilai yang valid adalah:

  • Hal 1
  • P2
  • P3
  • P4
  • P5
  • C0
  • C1
  • C2
  • C3
  • C4
  • C5
  • C6
  • 250MB
  • 1GB
  • 2,5 GB
  • 6GB
  • 13GB
  • 26GB
  • 53GB Nilai defaultnya adalah 1GB atau C1.
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Sku

Menentukan SKU Cache Redis yang akan dibuat. Nilai yang valid adalah:

  • Dasar
  • Standard
  • Premium Nilai defaultnya adalah Standar.
Type:String
Accepted values:Basic, Standard, Premium
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-StaticIP

Menentukan alamat IP unik di subnet untuk Redis Cache. Jika Anda tidak menentukan nilai untuk parameter ini, cmdlet ini memilih alamat IP dari subnet.

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

-SubnetId

ID sumber daya lengkap subnet di jaringan virtual untuk menyebarkan Azure Cache for Redis. Contoh format: /subscriptions/{subid}/resourceGroups/{resourceGroupName}/Microsoft. {Jaringan|ClassicNetwork}/VirtualNetworks/{vnetName}/subnets/{subnetName}

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

-Tag

Tabel hash yang mewakili tag.

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

-TenantSettings

Parameter ini tidak digunakan lagi.

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

-UpdateChannel

Opsional: Menentukan saluran pembaruan untuk pembaruan Redis bulanan yang akan diterima Redis Cache Anda. Cache yang menggunakan saluran pembaruan 'Pratinjau' mendapatkan pembaruan Redis terbaru setidaknya 4 minggu sebelum cache saluran 'Stabil'. Nilai defaultnya adalah 'Stabil'. Nilai yang mungkin termasuk: 'Stabil', 'Pratinjau'

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

-UserAssignedIdentity

Menentukan satu atau beberapa identitas pengguna yang dipisahkan koma untuk dikaitkan dengan Azure Cache for Redis. Referensi identitas pengguna akan menjadi id sumber daya ARM dalam formulir: '/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

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

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

-Zone

Daftar wilayah Azure dengan Zona ketersediaan.

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

Input

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

Output

RedisCacheAttributesWithAccessKeys