Bagikan melalui

Mengelola Azure Cache for Redis dengan Azure PowerShell

  • Artikel

Artikel ini menunjukkan kepada Anda cara melakukan tugas umum seperti membuat, memperbarui, dan menskalakan instans Azure Cache for Redis. Artikel ini juga memperlihatkan cara meregenerasi kunci akses, dan cara melihat informasi tentang cache Anda. Untuk daftar lengkap cmdlet Azure Cache for Redis PowerShell, lihat cmdlet Azure Cache for Redis.

Catatan

Azure memiliki dua model penyebaran yang berbeda untuk membuat dan bekerja dengan sumber daya: Azure Resource Manager dan klasik. Artikel ini mencakup penggunaan model penyebaran Resource Manager. Kami merekomendasikan model penyebaran Resource Manager untuk penyebaran baru, bukan model penyebaran klasik.

Untuk informasi selengkapnya tentang model penyebaran klasik, lihat Azure Resource Manager vs. penyebaran klasik: Memahami model penyebaran dan status sumber daya Anda.

Prasyarat

Jika Anda sudah memasang Azure PowerShell, Anda harus memiliki Azure PowerShell versi 1.0.0 atau yang lebih baru. Anda dapat memeriksa versi Azure PowerShell dengan perintah ini di perintah Azure PowerShell.

    Get-Module Az | format-table version

Pertama, Anda harus masuk ke Azure dengan perintah ini.

    Connect-AzAccount

Tentukan alamat email akun Azure dan kata sandi Anda dalam dialog masuk Microsoft Azure.

Berikutnya, jika Anda memiliki beberapa langganan Azure, Anda perlu mengatur langganan Azure Anda. Untuk melihat daftar langganan Anda saat ini, jalankan perintah ini.

    Get-AzSubscription | sort SubscriptionName | Select SubscriptionName

Untuk menentukan langganan, jalankan perintah berikut. Dalam contoh berikut, nama langganan adalah ContosoSubscription.

    Select-AzSubscription -SubscriptionName ContosoSubscription

Sebelum Anda bisa menggunakan Windows PowerShell dengan Azure Resource Manager, Anda perlu memverifikasi penyetelan Anda:

  • Windows PowerShell, Versi 3.0 atau 4.0. Untuk menemukan versi Windows PowerShell, ketik: $PSVersionTable dan verifikasi nilai PSVersion adalah 3.0 atau 4.0. Untuk memasang versi yang kompatibel, lihat Windows Management Framework 3.0.

Untuk mendapatkan bantuan terperinci untuk cmdlet apa pun yang Anda lihat dalam tutorial ini, gunakan cmdlet Get-Help.

    Get-Help <cmdlet-name> -Detailed

Misalnya, untuk mendapatkan bantuan untuk cmdlet New-AzRedisCache, ketik:

    Get-Help New-AzRedisCache -Detailed

Cara menyambungkan ke cloud lain

Secara default lingkungan Azure adalah AzureCloud, yang mewakili instans cloud Azure global. Untuk menyambungkan ke instans yang berbeda, gunakan perintah Connect-AzAccount dengan -Environment atau sakelar baris perintah -EnvironmentNamedengan lingkungan atau nama lingkungan yang Anda inginkan.

Untuk melihat daftar lingkungan yang tersedia, jalankan cmdlet Get-AzEnvironment.

Untuk menyambungkan ke Azure Government Cloud

Untuk menyambungkan ke Azure Government Cloud, gunakan salah satu perintah berikut.

    Connect-AzAccount -EnvironmentName AzureUSGovernment

Atau

    Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureUSGovernment)

Untuk membuat cache di Azure Government Cloud, gunakan salah satu lokasi berikut.

  • Virginia Gov (US)
  • Iowa Gov (US)

Untuk informasi selengkapnya tentang Azure Government Cloud, lihat Microsoft Azure Government dan Panduan Microsoft Azure Government Developer.

Untuk menyambungkan ke Microsoft Azure yang dioperasikan oleh 21Vianet Cloud

Untuk menyambungkan ke Azure yang dioperasikan oleh cloud 21Vianet, gunakan salah satu perintah berikut.

    Connect-AzAccount -EnvironmentName AzureChinaCloud

Atau

    Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureChinaCloud)

Untuk membuat cache di Azure yang dioperasikan oleh 21Vianet Cloud, gunakan salah satu lokasi berikut.

  • Tiongkok Timur
  • Tiongkok Utara

Untuk menyambungkan ke Microsoft Azure Jerman

Untuk menyambungkan ke Microsoft Azure Jerman, gunakan salah satu perintah berikut ini.

    Connect-AzAccount -EnvironmentName AzureGermanCloud

Atau

    Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureGermanCloud)

Untuk membuat cache di Microsoft Azure Jerman, gunakan salah satu lokasi berikut.

  • Jerman Tengah
  • Jerman Timur Laut

Untuk informasi selengkapnya tentang Microsoft Azure Jerman, lihat Microsoft Azure Jerman.

Properti yang digunakan untuk Azure Cache for Redis PowerShell

Tabel berikut berisi properti dan deskripsi Azure PowerShell untuk parameter umum saat membuat dan mengelola instans Azure Cache for Redis.

Parameter Deskripsi Default
Nama Nama cache
Lokasi Lokasi cache
ResourceGroupName Nama grup sumber daya untuk membuat cache
Ukuran Ukuran cache. Nilai yang valid adalah: P1, P2, P3, P4, P5, C0, C1, C2, C3, C4, C5, C6, 250MB, 1GB, 2,5GB, 6GB, 13GB, 26GB, 53GB 1GB
ShardCount Jumlah shard untuk dibuat saat membuat cache premium dengan pengklusteran diaktifkan. Nilai yang valid adalah: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10
SKU Tentukan SKU dari cache. Nilai yang valid adalah: Dasar, Standar, Premium Standard
RedisConfiguration Tentukan pengaturan konfigurasi Redis. Untuk detail tentang setiap pengaturan, lihat tabel properti RedisConfiguration berikut.
EnableNonSslPort Menunjukkan apakah port non-SSL diaktifkan. Salah
MaxMemoryPolicy Parameter ini tidak digunakan lagi - gunakan RedisConfiguration sebagai gantinya.
StaticIP Saat meng-hosting tembolokan Anda di VNET, tentukan alamat IP unik di subnet untuk tembolokan. Jika tidak disediakan, akan dipilihkan untuk Anda dari subnet.
Subnet Saat meng-hosting tembolokan Anda di VNET, tentukan nama subnet tempat menyebarkan tembolokan.
JaringanVirtual Saat menghosting cache Anda di VNET, tentukan ID sumber daya VNET untuk menyebarkan cache.
KeyType Menentukan kunci akses mana yang akan diregenerasi ketika memperbarui kunci akses. Nilai yang valid adalah: Primer, Sekunder

Properti RedisConfiguration

Properti Deskripsi Tingkat harga
rdb-backup-enabled Apakah Persistensi data Redis diaktifkan Hanya premium
rdb-storage-connection-string String koneksi ke akun penyimpanan untuk Persistensi data Redis Hanya premium
rdb-backup-frequency Frekuensi cadangan untuk Persistensi data Redis Hanya premium
maxmemory-reserved Mengonfigurasi memori yang disediakan untuk proses non-cache Standar dan Premium
maxmemory-policy Mengonfigurasi kebijakan penggusuran untuk cache Semua tingkat harga
notify-keyspace-events Mengonfigurasi pemberitahuan ruang kunci Standar dan Premium
hash-max-ziplist-entries Mengonfigurasi pengoptimalan memori untuk jenis data agregat kecil Standar dan Premium
hash-max-ziplist-value Mengonfigurasi pengoptimalan memori untuk jenis data agregat kecil Standar dan Premium
set-max-intset-entri Mengonfigurasi pengoptimalan memori untuk jenis data agregat kecil Standar dan Premium
zset-max-ziplist-entries Mengonfigurasi pengoptimalan memori untuk jenis data agregat kecil Standar dan Premium
zset-max-ziplist-value Mengonfigurasi pengoptimalan memori untuk jenis data agregat kecil Standar dan Premium
database Konfigurasikan jumlah database. Properti ini hanya dapat dikonfigurasi pada pembuatan cache. Standar dan Premium

Untuk membuat Azure Cache for Redis

Azure Cache for Redis baru untuk instans dibuat menggunakan cmdlet New-AzRedisCache.

Penting

Pertama kali Anda membuat Azure Cache for Redis dalam langganan menggunakan portal Microsoft Azure, portal mendaftarkan namespace layanan Microsoft.Cache untuk langganan tersebut. Jika Anda mencoba membuat Azure Cache for Redis pertama dalam langganan menggunakan PowerShell, Anda harus terlebih dahulu mendaftarkan namespace layanan tersebut menggunakan perintah berikut; jika tidak cmdlet seperti New-AzRedisCache dan Get-AzRedisCache gagal.

Register-AzResourceProvider -ProviderNamespace "Microsoft.Cache"

Untuk melihat daftar parameter yang tersedia dan deskripsinya untuk New-AzRedisCache, jalankan perintah berikut.

    PS C:\> Get-Help New-AzRedisCache -detailed

    NAME
        New-AzRedisCache

    SYNOPSIS
        Creates a new Azure Cache for Redis.


    SYNTAX
        New-AzRedisCache -Name <String> -ResourceGroupName <String> -Location <String> [-RedisVersion <String>]
        [-Size <String>] [-Sku <String>] [-MaxMemoryPolicy <String>] [-RedisConfiguration <Hashtable>] [-EnableNonSslPort
        <Boolean>] [-ShardCount <Integer>] [-VirtualNetwork <String>] [-Subnet <String>] [-StaticIP <String>]
        [<CommonParameters>]


    DESCRIPTION
        The New-AzRedisCache cmdlet creates a new Azure Cache for Redis.


    PARAMETERS
        -Name <String>
            Name of the Azure Cache for Redis to create.

        -ResourceGroupName <String>
            Name of resource group in which to create the Azure Cache for Redis.

        -Location <String>
            Location in which to create the Azure Cache for Redis.

        -RedisVersion <String>
            RedisVersion is deprecated and will be removed in future release.

        -Size <String>
            Size of the Azure Cache for Redis. The default value is 1GB or C1. Possible values are P1, P2, P3, P4, C0, C1, C2, C3,
            C4, C5, C6, 250MB, 1GB, 2.5GB, 6GB, 13GB, 26GB, 53GB.

        -Sku <String>
            Sku of Azure Cache for Redis. The default value is Standard. Possible values are Basic, Standard and Premium.

        -MaxMemoryPolicy <String>
            The 'MaxMemoryPolicy' setting has been deprecated. Please use 'RedisConfiguration' setting to set
            MaxMemoryPolicy. e.g. -RedisConfiguration @{"maxmemory-policy" = "allkeys-lru"}

        -RedisConfiguration <Hashtable>
            All Redis Configuration Settings. Few possible keys: rdb-backup-enabled, rdb-storage-connection-string,
            rdb-backup-frequency, maxmemory-reserved, maxmemory-policy, notify-keyspace-events, hash-max-ziplist-entries,
            hash-max-ziplist-value, set-max-intset-entries, zset-max-ziplist-entries, zset-max-ziplist-value, databases.

        -EnableNonSslPort <Boolean>
            EnableNonSslPort is used by Azure Cache for Redis. If no value is provided, the default value is false and the
            non-SSL port will be disabled. Possible values are true and false.

        -ShardCount <Integer>
            The number of shards to create on a Premium Cluster Cache.

        -VirtualNetwork <String>
            The exact ARM resource ID of the virtual network to deploy the Azure Cache for Redis in. Example format: /subscriptions/{
            subid}/resourceGroups/{resourceGroupName}/providers/Microsoft.ClassicNetwork/VirtualNetworks/{vnetName}

        -Subnet <String>
            Required when deploying an Azure Cache for Redis inside an existing Azure Virtual Network.

        -StaticIP <String>
            Required when deploying an Azure Cache for Redis inside an existing Azure Virtual Network.

        <CommonParameters>
            This cmdlet supports the common parameters: Verbose, Debug,
            ErrorAction, ErrorVariable, WarningAction, WarningVariable,
            OutBuffer, PipelineVariable, and OutVariable. For more information, see
            about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Untuk membuat cache dengan parameter default, jalankan perintah berikut.

    New-AzRedisCache -ResourceGroupName myGroup -Name mycache -Location "North Central US"

ResourceGroupName, Name, dan Location diperlukan parameter, tetapi sisanya opsional dan memiliki nilai default. Menjalankan perintah sebelumnya membuat instans Azure Cache for Redis SKU Standar dengan nama, lokasi, dan grup sumber daya yang ditentukan. Instans berukuran 1 GB dengan port non-SSL dinonaktifkan.

Untuk membuat cache premium, tentukan ukuran P1 (6 GB - 60 GB), P2 (13 GB - 130 GB), P3 (26 GB - 260 GB), atau P4 (53 GB - 530 GB). Untuk mengaktifkan pengklusteran, tentukan jumlah shard menggunakan parameter ShardCount. Contoh berikut membuat cache premium P1 dengan tiga shard. Cache premium P1 berukuran 6 GB, dan karena kami menentukan tiga shard ukuran totalnya adalah 18 GB (3 x 6 GB).

    New-AzRedisCache -ResourceGroupName myGroup -Name mycache -Location "North Central US" -Sku Premium -Size P1 -ShardCount 3

Untuk menentukan nilai untuk parameter RedisConfiguration, sertakan nilai didalamnya {} sebagai pasangan kunci/nilai seperti @{"maxmemory-policy" = "allkeys-random", "notify-keyspace-events" = "KEA"}. Contoh berikut membuat cache 1-GB standar dengan kebijakan maxmemory allkeys-random dan pemberitahuan ruang kunci yang dikonfigurasi dengan KEA. Untuk informasi selengkapnya, lihat Pemberitahuan ruang kunci (pengaturan tingkat lanjut) dan Kebijakan memori.

    New-AzRedisCache -ResourceGroupName myGroup -Name mycache -Location "North Central US" -RedisConfiguration @{"maxmemory-policy" = "allkeys-random", "notify-keyspace-events" = "KEA"}

Untuk mengonfigurasi pengaturan database selama pembuatan cache

Pengaturan databases hanya dapat dikonfigurasi selama pembuatan cache. Contoh berikut membuat cache P3 premium (26 GB) dengan database 48 menggunakan cmdlet New-AzRedisCache.

    New-AzRedisCache -ResourceGroupName myGroup -Name mycache -Location "North Central US" -Sku Premium -Size P3 -RedisConfiguration @{"databases" = "48"}

Untuk informasi selengkapnya tentang properti databases, lihat Konfigurasi server Default Azure Cache for Redis. Untuk informasi selengkapnya tentang membuat cache menggunakan cmdlet New-AzRedisCache, lihat bagian sebelumnya Untuk membuat Azure Cache for Redis.

Untuk memperbarui Azure Cache for Redis

Instans Azure Cache for Redis diperbarui menggunakan cmdlet Set-AzRedisCache.

Untuk melihat daftar parameter yang tersedia dan deskripsinya untuk Set-AzRedisCache, jalankan perintah berikut.

    PS C:\> Get-Help Set-AzRedisCache -detailed

    NAME
        Set-AzRedisCache

    SYNOPSIS
        Set Azure Cache for Redis updatable parameters.

    SYNTAX
        Set-AzRedisCache -Name <String> -ResourceGroupName <String> [-Size <String>] [-Sku <String>]
        [-MaxMemoryPolicy <String>] [-RedisConfiguration <Hashtable>] [-EnableNonSslPort <Boolean>] [-ShardCount
        <Integer>] [<CommonParameters>]

    DESCRIPTION
        The Set-AzRedisCache cmdlet sets Azure Cache for Redis parameters.

    PARAMETERS
        -Name <String>
            Name of the Azure Cache for Redis to update.

        -ResourceGroupName <String>
            Name of the resource group for the cache.

        -Size <String>
            Size of the Azure Cache for Redis. The default value is 1GB or C1. Possible values are P1, P2, P3, P4, C0, C1, C2, C3,
            C4, C5, C6, 250MB, 1GB, 2.5GB, 6GB, 13GB, 26GB, 53GB.

        -Sku <String>
            Sku of Azure Cache for Redis. The default value is Standard. Possible values are Basic, Standard and Premium.

        -MaxMemoryPolicy <String>
            The 'MaxMemoryPolicy' setting has been deprecated. Please use 'RedisConfiguration' setting to set
            MaxMemoryPolicy. e.g. -RedisConfiguration @{"maxmemory-policy" = "allkeys-lru"}

        -RedisConfiguration <Hashtable>
            All Redis Configuration Settings. Few possible keys: rdb-backup-enabled, rdb-storage-connection-string,
            rdb-backup-frequency, maxmemory-reserved, maxmemory-policy, notify-keyspace-events, hash-max-ziplist-entries,
            hash-max-ziplist-value, set-max-intset-entries, zset-max-ziplist-entries, zset-max-ziplist-value.

        -EnableNonSslPort <Boolean>
            EnableNonSslPort is used by Azure Cache for Redis. The default value is null and no change will be made to the
            currently configured value. Possible values are true and false.

        -ShardCount <Integer>
            The number of shards to create on a Premium Cluster Cache.

        <CommonParameters>
            This cmdlet supports the common parameters: Verbose, Debug,
            ErrorAction, ErrorVariable, WarningAction, WarningVariable,
            OutBuffer, PipelineVariable, and OutVariable. For more information, see
            about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Cmdlet Set-AzRedisCache dapat digunakan untuk memperbarui properti seperti nilai Size, Sku, EnableNonSslPort, dan RedisConfiguration.

Perintah berikut memperbarui kebijakan maxmemory untuk Azure Cache for Redis bernama myCache.

    Set-AzRedisCache -ResourceGroupName "myGroup" -Name "myCache" -RedisConfiguration @{"maxmemory-policy" = "allkeys-random"}

Untuk menskalakan Azure Cache for Redis

Set-AzRedisCache dapat digunakan untuk menskalakan Azure Cache for Redis saat properti Size,Sku, atau ShardCount dimodifikasi.

Catatan

Penskalaan cache menggunakan PowerShell tunduk pada batas dan pedoman yang sama dengan penskalaan cache dari portal Microsoft Azure. Anda dapat menskalakan ke tingkat harga yang berbeda dengan batasan berikut.

  • Anda tidak dapat menurunkan skala dari tingkat harga yang lebih tinggi ke tingkat harga yang lebih rendah.
  • Anda tidak dapat menurunkan skala dari cache Premium ke cache Standar atau Dasar.
  • Anda tidak dapat menurunkan skala dari cache Standar ke cache Dasar.
  • Anda dapat menskalakan dari cache Dasar ke cache Standar tetapi Anda tidak dapat mengubah ukurannya secara bersamaan. Jika Anda membutuhkan ukuran yang berbeda, Anda dapat melakukan operasi penskalaan berikutnya ke ukuran yang diinginkan.
  • Anda tidak dapat menaikkan skala dari cache Dasar langsung ke cache Premium. Anda harus menskalakan dari Dasar ke Standar dalam satu operasi penskalaan, lalu dari Standar ke Premium dalam operasi penskalaan berikutnya.
  • Anda tidak dapat menurunkan skala dari ukuran yang lebih besar ke ukuran C0 (250 MB).

Untuk informasi selengkapnya, lihat Cara Menskalakan Azure Cache for Redis.

Contoh berikut menunjukkan cara menskalakan cache yang bernama myCache dengan cache 2,5 GB. Perintah ini berfungsi untuk cache Dasar atau Standar.

    Set-AzRedisCache -ResourceGroupName myGroup -Name myCache -Size 2.5GB

Setelah perintah ini dikeluarkan, status cache dikembalikan---serupa untuk memanggil Get-AzRedisCache. ProvisioningState diatur ke Scaling.

    PS C:\> Set-AzRedisCache -Name myCache -ResourceGroupName myGroup -Size 2.5GB


    Name               : mycache
    Id                 : /subscriptions/12ad12bd-abdc-2231-a2ed-a2b8b246bbad4/resourceGroups/mygroup/providers/Mi
                         crosoft.Cache/Redis/mycache
    Location           : South Central US
    Type               : Microsoft.Cache/Redis
    HostName           : mycache.redis.cache.windows.net
    Port               : 6379
    ProvisioningState  : Scaling
    SslPort            : 6380
    RedisConfiguration : {[maxmemory-policy, volatile-lru], [maxmemory-reserved, 150], [notify-keyspace-events, KEA],
                         [maxmemory-delta, 150]...}
    EnableNonSslPort   : False
    RedisVersion       : 3.0
    Size               : 1GB
    Sku                : Standard
    ResourceGroupName  : mygroup
    PrimaryKey         : ....
    SecondaryKey       : ....
    VirtualNetwork     :
    Subnet             :
    StaticIP           :
    TenantSettings     : {}
    ShardCount         :

Ketika operasi penskalaan selesai, ProvisioningState berubah ke Succeeded. Jika Anda perlu membuat operasi penskalaan lain---misal, mengubah dari Dasar ke Standar lalu ubah ukurannya---Anda harus menunggu sampai operasi sebelumnya selesai atau Anda menerima kesalahan yang mirip dengan yang berikut.

    Set-AzRedisCache : Conflict: The resource '...' is not in a stable state, and is currently unable to accept the update request.

Untuk mendapatkan informasi tentang Azure Cache for Redis

Anda dapat mengambil informasi tentang cache menggunakan cmdlet Get-AzRedisCache.

Untuk melihat daftar parameter yang tersedia dan deskripsinya untuk Get-AzRedisCache, jalankan perintah berikut.

    PS C:\> Get-Help Get-AzRedisCache -detailed

    NAME
        Get-AzRedisCache

    SYNOPSIS
        Gets details about a single cache or all caches in the specified resource group or all caches in the current
        subscription.

    SYNTAX
        Get-AzRedisCache [-Name <String>] [-ResourceGroupName <String>] [<CommonParameters>]

    DESCRIPTION
        The Get-AzRedisCache cmdlet gets the details about a cache or caches depending on input parameters. If both
        ResourceGroupName and Name parameters are provided then Get-AzRedisCache will return details about the
        specific cache name provided.

        If only ResourceGroupName is provided than it will return details about all caches in the specified resource group.

        If no parameters are given than it will return details about all caches the current subscription.

    PARAMETERS
        -Name <String>
            The name of the cache. When this parameter is provided along with ResourceGroupName, Get-AzRedisCache
            returns the details for the cache.

        -ResourceGroupName <String>
            The name of the resource group that contains the cache or caches. If ResourceGroupName is provided with Name
            then Get-AzRedisCache returns the details of the cache specified by Name. If only the ResourceGroup
            parameter is provided, then details for all caches in the resource group are returned.

        <CommonParameters>
            This cmdlet supports the common parameters: Verbose, Debug,
            ErrorAction, ErrorVariable, WarningAction, WarningVariable,
            OutBuffer, PipelineVariable, and OutVariable. For more information, see
            about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Untuk mengembalikan informasi tentang semua cache di langganan saat ini, jalankan Get-AzRedisCache tanpa parameter apa pun.

    Get-AzRedisCache

Untuk mengembalikan informasi tentang semua cache dalam grup sumber daya tertentu, jalankan Get-AzRedisCache dengan parameter ResourceGroupName.

    Get-AzRedisCache -ResourceGroupName myGroup

Untuk mengembalikan informasi tentang cache tertentu, jalankan Get-AzRedisCache dengan parameter Name yang berisi nama cache, dan parameter ResourceGroupName dengan grup sumber daya yang berisi cache tersebut.

    PS C:\> Get-AzRedisCache -Name myCache -ResourceGroupName myGroup

    Name               : mycache
    Id                 : /subscriptions/12ad12bd-abdc-2231-a2ed-a2b8b246bbad4/resourceGroups/myGroup/providers/Mi
                         crosoft.Cache/Redis/mycache
    Location           : South Central US
    Type               : Microsoft.Cache/Redis
    HostName           : mycache.redis.cache.windows.net
    Port               : 6379
    ProvisioningState  : Succeeded
    SslPort            : 6380
    RedisConfiguration : {[maxmemory-policy, volatile-lru], [maxmemory-reserved, 62], [notify-keyspace-events, KEA],
                         [maxclients, 1000]...}
    EnableNonSslPort   : False
    RedisVersion       : 3.0
    Size               : 1GB
    Sku                : Standard
    ResourceGroupName  : myGroup
    VirtualNetwork     :
    Subnet             :
    StaticIP           :
    TenantSettings     : {}
    ShardCount         :

Untuk mengambil kunci akses untuk Azure Cache for Redis

Untuk mengambil kunci akses untuk cache Anda, Anda dapat menggunakan cmdlet Get-AzRedisCacheKey.

Untuk melihat daftar parameter yang tersedia dan deskripsinya untuk Get-AzRedisCacheKey, jalankan perintah berikut.

    PS C:\> Get-Help Get-AzRedisCacheKey -detailed

    NAME
        Get-AzRedisCacheKey

    SYNOPSIS
        Gets the accesskeys for the specified Azure Cache for Redis.


    SYNTAX
        Get-AzRedisCacheKey -Name <String> -ResourceGroupName <String> [<CommonParameters>]

    DESCRIPTION
        The Get-AzRedisCacheKey cmdlet gets the access keys for the specified cache.

    PARAMETERS
        -Name <String>
            Name of the Azure Cache for Redis.

        -ResourceGroupName <String>
            Name of the resource group for the cache.

        <CommonParameters>
            This cmdlet supports the common parameters: Verbose, Debug,
            ErrorAction, ErrorVariable, WarningAction, WarningVariable,
            OutBuffer, PipelineVariable, and OutVariable. For more information, see
            about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Untuk mengambil kunci cache Anda, hubungi cmdlet Get-AzRedisCacheKey dan berikan nama cache Anda, nama grup sumber daya yang berisi cache.

    PS C:\> Get-AzRedisCacheKey -Name myCache -ResourceGroupName myGroup

    PrimaryKey   : b2wdt43sfetlju4hfbryfnregrd9wgIcc6IA3zAO1lY=
    SecondaryKey : ABhfB757JgjIgt785JgKH9865eifmekfnn649303JKL=

Untuk meregenerasi kunci akses untuk Azure Cache for Redis

Untuk meregenerasi kunci akses untuk cache Anda, Anda dapat menggunakan cmdlet New-AzRedisCacheKey.

Untuk melihat daftar parameter yang tersedia dan deskripsinya untuk New-AzRedisCacheKey, jalankan perintah berikut.

    PS C:\> Get-Help New-AzRedisCacheKey -detailed

    NAME
        New-AzRedisCacheKey

    SYNOPSIS
        Regenerates the access key of an Azure Cache for Redis.

    SYNTAX
        New-AzRedisCacheKey -Name <String> -ResourceGroupName <String> -KeyType <String> [-Force] [<CommonParameters>]

    DESCRIPTION
        The New-AzRedisCacheKey cmdlet regenerate the access key of an Azure Cache for Redis.

    PARAMETERS
        -Name <String>
            Name of the Azure Cache for Redis.

        -ResourceGroupName <String>
            Name of the resource group for the cache.

        -KeyType <String>
            Specifies whether to regenerate the primary or secondary access key. Possible values are Primary or Secondary.

        -Force
            When the Force parameter is provided, the specified access key is regenerated without any confirmation prompts.

        <CommonParameters>
            This cmdlet supports the common parameters: Verbose, Debug,
            ErrorAction, ErrorVariable, WarningAction, WarningVariable,
            OutBuffer, PipelineVariable, and OutVariable. For more information, see
            about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Untuk meregenerasi kunci utama atau sekunder untuk cache Anda, hubungi cmdlet New-AzRedisCacheKey dan berikan nama, grup sumber daya, dan tentukan salah satu Primary atau Secondary untuk parameter KeyType. Dalam contoh berikut, kunci akses sekunder untuk cache diregenerasi.

    PS C:\> New-AzRedisCacheKey -Name myCache -ResourceGroupName myGroup -KeyType Secondary

    Confirm
    Are you sure you want to regenerate Secondary key for Azure Cache for Redis 'myCache'?
    [Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"): Y


    PrimaryKey   : b2wdt43sfetlju4hfbryfnregrd9wgIcc6IA3zAO1lY=
    SecondaryKey : c53hj3kh4jhHjPJk8l0jji785JgKH9865eifmekfnn6=

Untuk menghapus Azure Cache for Redis

Untuk menghapus Azure Cache for Redis, gunakan cmdlet Remove-AzRedisCache.

Untuk melihat daftar parameter yang tersedia dan deskripsinya untuk Remove-AzRedisCache, jalankan perintah berikut.

    PS C:\> Get-Help Remove-AzRedisCache -detailed

    NAME
        Remove-AzRedisCache

    SYNOPSIS
        Remove Azure Cache for Redis if exists.

    SYNTAX
        Remove-AzRedisCache -Name <String> -ResourceGroupName <String> [-Force] [-PassThru] [<CommonParameters>

    DESCRIPTION
        The Remove-AzRedisCache cmdlet removes an Azure Cache for Redis if it exists.

    PARAMETERS
        -Name <String>
            Name of the Azure Cache for Redis to remove.

        -ResourceGroupName <String>
            Name of the resource group of the cache to remove.

        -Force
            When the Force parameter is provided, the cache is removed without any confirmation prompts.

        -PassThru
            By default Remove-AzRedisCache removes the cache and does not return any value. If the PassThru par
            is provided then Remove-AzRedisCache returns a boolean value indicating the success of the operatio

        <CommonParameters>
            This cmdlet supports the common parameters: Verbose, Debug,
            ErrorAction, ErrorVariable, WarningAction, WarningVariable,
            OutBuffer, PipelineVariable, and OutVariable. For more information, see
            about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Dalam contoh berikut, cache bernama myCache dihapus.

    PS C:\> Remove-AzRedisCache -Name myCache -ResourceGroupName myGroup

    Confirm
    Are you sure you want to remove Azure Cache for Redis 'myCache'?
    [Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"): Y

Untuk mengimpor Azure Cache for Redis

Anda dapat mengimpor data ke dalam instans Azure Cache for Redis menggunakan cmdlet Import-AzRedisCache.

Penting

Impor/Ekspor hanya tersedia untuk cache Tingkat premium. Untuk informasi selengkapnya tentang Impor/Ekspor, lihat Mengimpor dan Mengekspor data di Azure Cache for Redis.

Untuk melihat daftar parameter yang tersedia dan deskripsinya untuk Import-AzRedisCache, jalankan perintah berikut.

    PS C:\> Get-Help Import-AzRedisCache -detailed

    NAME
        Import-AzRedisCache

    SYNOPSIS
        Import data from blobs to Azure Cache for Redis.


    SYNTAX
        Import-AzRedisCache -Name <String> -ResourceGroupName <String> -Files <String[]> [-Format <String>] [-Force]
        [-PassThru] [<CommonParameters>]


    DESCRIPTION
        The Import-AzRedisCache cmdlet imports data from the specified blobs into Azure Cache for Redis.


    PARAMETERS
        -Name <String>
            The name of the cache.

        -ResourceGroupName <String>
            The name of the resource group that contains the cache.

        -Files <String[]>
            SAS urls of blobs whose content should be imported into the cache.

        -Format <String>
            Format for the blob.  Currently "rdb" is the only supported, with other formats expected in the future.

        -Force
            When the Force parameter is provided, import will be performed without any confirmation prompts.

        -PassThru
            By default Import-AzRedisCache imports data in cache and does not return any value. If the PassThru
            parameter is provided then Import-AzRedisCache returns a boolean value indicating the success of the
            operation.

        <CommonParameters>
            This cmdlet supports the common parameters: Verbose, Debug,
            ErrorAction, ErrorVariable, WarningAction, WarningVariable,
            OutBuffer, PipelineVariable, and OutVariable. For more information, see
            about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Perintah berikut mengimpor data dari blob yang ditentukan oleh SAS uri ke dalam Azure Cache for Redis.

    PS C:\>Import-AzRedisCache -ResourceGroupName "resourceGroupName" -Name "cacheName" -Files @("https://mystorageaccount.blob.core.windows.net/mycontainername/blobname?sv=2015-04-05&sr=b&sig=caIwutG2uDa0NZ8mjdNJdgOY8%2F8mhwRuGNdICU%2B0pI4%3D&st=2016-05-27T00%3A00%3A00Z&se=2016-05-28T00%3A00%3A00Z&sp=rwd") -Force

Untuk mengekspor Azure Cache for Redis

Anda dapat mengekspor data dari instans Azure Cache for Redis menggunakan cmdlet Export-AzRedisCache.

Penting

Impor/Ekspor hanya tersedia untuk cache Tingkat premium. Untuk informasi selengkapnya tentang Impor/Ekspor, lihat Mengimpor dan Mengekspor data di Azure Cache for Redis.

Untuk melihat daftar parameter yang tersedia dan deskripsinya untuk Export-AzRedisCache, jalankan perintah berikut.

    PS C:\> Get-Help Export-AzRedisCache -detailed

    NAME
        Export-AzRedisCache

    SYNOPSIS
        Exports data from Azure Cache for Redis to a specified container.


    SYNTAX
        Export-AzRedisCache -Name <String> -ResourceGroupName <String> -Prefix <String> -Container <String> [-Format
        <String>] [-PassThru] [<CommonParameters>]


    DESCRIPTION
        The Export-AzRedisCache cmdlet exports data from Azure Cache for Redis to a specified container.


    PARAMETERS
        -Name <String>
            The name of the cache.

        -ResourceGroupName <String>
            The name of the resource group that contains the cache.

        -Prefix <String>
            Prefix to use for blob names.

        -Container <String>
            SAS url of container where data should be exported.

        -Format <String>
            Format for the blob.  Currently "rdb" is the only supported, with other formats expected in the future.

        -PassThru
            By default Export-AzRedisCache does not return any value. If the PassThru parameter is provided
            then Export-AzRedisCache returns a boolean value indicating the success of the operation.

        <CommonParameters>
            This cmdlet supports the common parameters: Verbose, Debug,
            ErrorAction, ErrorVariable, WarningAction, WarningVariable,
            OutBuffer, PipelineVariable, and OutVariable. For more information, see
            about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Perintah berikut mengekspor data dari instans Azure Cache for Redis ke dalam kontainer yang ditentukan oleh SAS uri.

    PS C:\>Export-AzRedisCache -ResourceGroupName "resourceGroupName" -Name "cacheName" -Prefix "blobprefix"
    -Container "https://mystorageaccount.blob.core.windows.net/mycontainer?sv=2015-04-05&sr=c&sig=HezZtBZ3DURmEGDduauE7
    pvETY4kqlPI8JCNa8ATmaw%3D&st=2016-05-27T00%3A00%3A00Z&se=2016-05-28T00%3A00%3A00Z&sp=rwdl"

Untuk me-reboot Azure Cache for Redis

Anda dapat me-reboot Azure Cache for Redis menggunakan cmdlet Reset-AzRedisCache.

Penting

Reboot hanya tersedia untuk cache tingkat Dasar, Standar, dan Premium. Untuk informasi selengkapnya tentang me-reboot cache Anda, lihat Administrasi cache - reboot.

Untuk melihat daftar parameter yang tersedia dan deskripsinya untuk Reset-AzRedisCache, jalankan perintah berikut.

    PS C:\> Get-Help Reset-AzRedisCache -detailed

    NAME
        Reset-AzRedisCache

    SYNOPSIS
        Reboot specified node(s) of an Azure Cache for Redis instance.


    SYNTAX
        Reset-AzRedisCache -Name <String> -ResourceGroupName <String> -RebootType <String> [-ShardId <Integer>]
        [-Force] [-PassThru] [<CommonParameters>]


    DESCRIPTION
        The Reset-AzRedisCache cmdlet reboots the specified node(s) of an Azure Cache for Redis instance.


    PARAMETERS
        -Name <String>
            The name of the cache.

        -ResourceGroupName <String>
            The name of the resource group that contains the cache.

        -RebootType <String>
            Which node to reboot. Possible values are "PrimaryNode", "SecondaryNode", "AllNodes".

        -ShardId <Integer>
            Which shard to reboot when rebooting a premium cache with clustering enabled.

        -Force
            When the Force parameter is provided, reset will be performed without any confirmation prompts.

        -PassThru
            By default Reset-AzRedisCache does not return any value. If the PassThru parameter is provided
            then Reset-AzRedisCache returns a boolean value indicating the success of the operation.

        <CommonParameters>
            This cmdlet supports the common parameters: Verbose, Debug,
            ErrorAction, ErrorVariable, WarningAction, WarningVariable,
            OutBuffer, PipelineVariable, and OutVariable. For more information, see
            about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Perintah berikut me-reboot kedua simpul dari cache yang ditentukan.

    PS C:\>Reset-AzRedisCache -ResourceGroupName "resourceGroupName" -Name "cacheName" -RebootType "AllNodes"
    -Force

Langkah berikutnya

Untuk mempelajari selengkapnya tentang menggunakan Windows PowerShell dengan Azure, lihat sumber daya berikut: