Redis için Azure Cache’i Azure PowerShell ile yönetme

  • Makale

Bu makalede, Redis için Azure Cache örneklerinizi oluşturma, güncelleştirme ve ölçeklendirme işlemleri gösterilmektedir. Makalede ayrıca erişim anahtarlarını yeniden oluşturma ve önbelleklerinizle ilgili bilgileri görüntüleme işlemleri de gösterilir. Redis için Azure Cache PowerShell cmdlet'lerinin tam listesi için bkz. Redis için Azure Cache cmdlet'leri.

Not

Azure'da kaynak oluşturmak ve kaynaklarla çalışmak için kullanabileceğiniz iki farklı dağıtım modeli vardır: Azure Resource Manager ve klasik. Bu makale Resource Manager dağıtım modelinin kullanımını kapsar. Klasik dağıtım modeli yerine yeni dağıtımlar için Resource Manager dağıtım modelini öneririz.

Klasik dağıtım modeli hakkında daha fazla bilgi için bkz . Azure Resource Manager ile klasik dağıtım karşılaştırması: Dağıtım modellerini ve kaynaklarınızın durumunu anlama.

Önkoşullar

Azure PowerShell'i zaten yüklediyseniz, Azure PowerShell sürüm 1.0.0 veya üzeri olmalıdır. Azure PowerShell komut isteminde bu komutla Azure PowerShell sürümünü de kontrol edebilirsiniz.

    Get-Module Az | format-table version

İlk olarak, bu komutla Azure'da oturum açmanız gerekir.

    Connect-AzAccount

Microsoft Azure oturum açma iletişim kutusunda Azure hesabınızın e-posta adresini ve parolanızı belirtin.

Ardından, birden çok Azure aboneliğiniz varsa Azure aboneliğinizi ayarlamanız gerekir. Geçerli aboneliklerinizin listesini görmek için bu komutu çalıştırın.

    Get-AzSubscription | sort SubscriptionName | Select SubscriptionName

Aboneliği belirtmek için aşağıdaki komutu çalıştırın. Aşağıdaki örnekte abonelik adı şeklindedir ContosoSubscription.

    Select-AzSubscription -SubscriptionName ContosoSubscription

Windows PowerShell'i Azure Resource Manager ile kullanabilmeniz için önce kurulumunuzu doğrulamanız gerekir:

  • Windows PowerShell, Sürüm 3.0 veya 4.0. Windows PowerShell sürümünü bulmak için şunu yazın:$PSVersionTable ve değerinin PSVersion 3.0 veya 4.0 olduğunu doğrulayın. Uyumlu bir sürüm yüklemek için bkz . Windows Management Framework 3.0.

Bu öğreticide gördüğünüz tüm cmdlet'ler hakkında ayrıntılı yardım almak için Get-Help cmdlet'ini kullanın.

    Get-Help <cmdlet-name> -Detailed

Örneğin, cmdlet'iyle ilgili New-AzRedisCache yardım almak için şunu yazın:

    Get-Help New-AzRedisCache -Detailed

Diğer bulutlara bağlanma

Varsayılan olarak Azure ortamı, genel Azure bulut örneğini temsil eden ortamıdır AzureCloud. Farklı bir örneğe bağlanmak için, istediğiniz ortam veya ortam adıyla -Environment veya -EnvironmentName komut satırı anahtarıyla komutunu kullanınConnect-AzAccount.

Kullanılabilir ortamların listesini görmek için cmdlet'ini Get-AzEnvironment çalıştırın.

Azure Kamu Bulut'a bağlanmak için

Azure Kamu Bulut'a bağlanmak için aşağıdaki komutlardan birini kullanın.

    Connect-AzAccount -EnvironmentName AzureUSGovernment

Or

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

Azure Kamu Bulut'ta önbellek oluşturmak için aşağıdaki konumlardan birini kullanın.

  • USGov Virginia
  • USGov Iowa

Azure Kamu Bulutu hakkında daha fazla bilgi için bkz. Microsoft Azure Kamu ve Microsoft Azure Kamu Geliştirici Kılavuzu.

21Vianet Cloud tarafından sağlanan Microsoft Azure'a bağlanmak için

21Vianet bulutu tarafından sağlanan Azure'a bağlanmak için aşağıdaki komutlardan birini kullanın.

    Connect-AzAccount -EnvironmentName AzureChinaCloud

Or

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

21Vianet Cloud tarafından sağlanan Azure'da önbellek oluşturmak için aşağıdaki konumlardan birini kullanın.

  • Doğu Çin
  • Kuzey Çin

Microsoft Azure Almanya'ya bağlanmak için

Microsoft Azure Almanya'ya bağlanmak için aşağıdaki komutlardan birini kullanın.

    Connect-AzAccount -EnvironmentName AzureGermanCloud

Or

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

Microsoft Azure Almanya'da önbellek oluşturmak için aşağıdaki konumlardan birini kullanın.

  • Orta Almanya
  • Kuzeydoğu Almanya

Microsoft Azure Almanya hakkında daha fazla bilgi için bkz . Microsoft Azure Almanya.

Redis için Azure Cache PowerShell için kullanılan özellikler

Aşağıdaki tabloda, Redis için Azure Cache örneklerinizi oluştururken ve yönetirken sık kullanılan parametrelere yönelik Azure PowerShell özellikleri ve açıklamaları yer alır.

Parametre Açıklama Varsayılan
Veri Akışı Adı Önbelleğin adı
Konum Önbelleğin konumu
ResourceGroupName Önbelleğin oluşturulacağı kaynak grubu adı
Size Önbelleğin boyutu. Geçerli değerler şunlardır: P1, P2, P3, P4, P5, C0, C1, C2, C3, C4, C5, C6, 250 MB, 1GB, 2,5 GB, 6 GB, 13 GB, 26 GB, 53 GB 1 GB
ShardCount Kümeleme etkin bir premium önbellek oluştururken oluşturulacak parça sayısı. Geçerli değerler şunlardır: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10
SKU Önbelleğin SKU'sunu belirtir. Geçerli değerler şunlardır: Temel, Standart, Premium Standart
RedisConfiguration Redis yapılandırma ayarlarını belirtir. Her ayarın ayrıntıları için aşağıdaki RedisConfiguration özellikleri tablosuna bakın.
EnableNonSslPort SSL olmayan bağlantı noktasının etkinleştirilip etkinleştirilmediğini gösterir. False
MaxMemoryPolicy Bu parametre kullanım dışı bırakıldı. Bunun yerine RedisConfiguration kullanın.
StaticIP Önbelleğinizi bir sanal ağda barındırırken, önbellek için alt ağda benzersiz bir IP adresi belirtir. Sağlanmadıysa, alt ağdan sizin için bir tane seçilir.
Alt ağ Önbelleğinizi bir sanal ağda barındırırken, önbelleğin dağıtılacağı alt ağın adını belirtir.
VirtualNetwork Önbelleğinizi bir sanal ağda barındırırken, önbelleğin dağıtılacağı sanal ağın kaynak kimliğini belirtir.
Keytype Erişim anahtarları yenilenirken yeniden oluşturulacak erişim anahtarını belirtir. Geçerli değerler şunlardır: Birincil, İkincil

RedisConfiguration özellikleri

Özellik Açıklama Fiyatlandırma katmanları
rdb-backup etkin Redis veri kalıcılığının etkinleştirilip etkinleştirilmediği Yalnızca premium
rdb-storage-connection-string Redis veri kalıcılığı için depolama hesabına bağlantı dizesi Yalnızca premium
rdb-backup-frequency Redis veri kalıcılığı için yedekleme sıklığı Yalnızca premium
maxmemory-reserved Önbellek dışı işlemler için ayrılmış belleği yapılandırır Standart ve Premium
maxmemory-policy Önbellek için çıkarma ilkesini yapılandırır Tüm fiyatlandırma katmanları
notify-keyspace-events Anahtar alanı bildirimlerini yapılandırıyor Standart ve Premium
hash-max-ziplist-entries Küçük toplama veri türleri için bellek iyileştirmeyi yapılandırıyor Standart ve Premium
hash-max-ziplist-value Küçük toplama veri türleri için bellek iyileştirmeyi yapılandırıyor Standart ve Premium
set-max-intset-entrys Küçük toplama veri türleri için bellek iyileştirmeyi yapılandırıyor Standart ve Premium
zset-max-ziplist-entries Küçük toplama veri türleri için bellek iyileştirmeyi yapılandırıyor Standart ve Premium
zset-max-ziplist-value Küçük toplama veri türleri için bellek iyileştirmeyi yapılandırıyor Standart ve Premium
veritabanlarında Veritabanı sayısını yapılandırıyor. Bu özellik yalnızca önbellek oluşturma sırasında yapılandırılabilir. Standart ve Premium

Redis için Azure Cache oluşturmak için

Yeni Redis için Azure Cache örnekleri New-AzRedisCache cmdlet'i kullanılarak oluşturulur.

Önemli

Azure portalını kullanarak bir abonelikte ilk kez bir Redis için Azure Cache oluşturduğunuzda portal bu abonelik için ad alanını kaydederMicrosoft.Cache. PowerShell kullanarak bir abonelikte ilk Redis için Azure Cache oluşturmayı denerseniz, önce aşağıdaki komutu kullanarak bu ad alanını kaydetmeniz gerekir; aksi takdirde ve Get-AzRedisCache gibi New-AzRedisCache cmdlet'ler başarısız olur.

Register-AzResourceProvider -ProviderNamespace "Microsoft.Cache"

için kullanılabilir parametrelerin ve açıklamalarının listesini görmek için New-AzRedisCacheaşağıdaki komutu çalıştırın.

    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).

Varsayılan parametrelerle önbellek oluşturmak için aşağıdaki komutu çalıştırın.

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

ResourceGroupName, Nameve Location gerekli parametrelerdir, ancak geri kalanlar isteğe bağlıdır ve varsayılan değerlere sahiptir. Önceki komutu çalıştırmak, belirtilen ada, konuma ve kaynak grubuna sahip bir Standart SKU Redis için Azure Cache örneği oluşturur. Örneğin boyutu SSL olmayan bağlantı noktası devre dışı bırakılmış 1 GB'tır.

Premium önbellek oluşturmak için P1 (6 GB - 60 GB), P2 (13 GB - 130 GB), P3 (26 GB - 260 GB) veya P4 (53 GB - 530 GB) boyutu belirtin. Kümelemeye olanak tanımak için parametresini ShardCount kullanarak bir parça sayısı belirtin. Aşağıdaki örnek, üç parçalı bir P1 premium önbelleği oluşturur. P1 premium önbelleğin boyutu 6 GB'tır ve üç parça belirttiğimiz için toplam boyut 18 GB'tır (3 x 6 GB).

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

parametresinin RedisConfiguration değerlerini belirtmek için içindeki değerleri gibi anahtar/değer çiftleri {} olarak @{"maxmemory-policy" = "allkeys-random", "notify-keyspace-events" = "KEA"}içine alın. Aşağıdaki örnek, maxmemory ilkesi ve ile KEAyapılandırılmış anahtar alanı bildirimleriyle allkeys-random standart bir 1 GB önbellek oluşturur. Daha fazla bilgi için bkz . Keyspace bildirimleri (gelişmiş ayarlar) ve Bellek ilkeleri.

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

Önbellek oluşturma sırasında veritabanları ayarını yapılandırmak için

Ayar databases yalnızca önbellek oluşturma sırasında yapılandırılabilir. Aşağıdaki örnek, New-AzRedisCache cmdlet'ini kullanarak 48 veritabanı olan bir premium P3 (26 GB) önbelleği oluşturur.

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

özelliği hakkında databases daha fazla bilgi için bkz. Varsayılan Redis için Azure Cache sunucu yapılandırması. New-AzRedisCache cmdlet'ini kullanarak önbellek oluşturma hakkında daha fazla bilgi için önceki Redis için Azure Cache oluşturmak için bölümüne bakın.

Redis için Azure Cache güncelleştirmek için

Redis için Azure Cache örnekleri Set-AzRedisCache cmdlet'i.

için kullanılabilir parametrelerin ve açıklamalarının listesini görmek için Set-AzRedisCacheaşağıdaki komutu çalıştırın.

    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).

Set-AzRedisCache Cmdlet, , , EnableNonSslPortSkuve gibi özellikleri Sizegüncelleştirmek RedisConfiguration için kullanılabilir.

Aşağıdaki komut, myCache adlı Redis için Azure Cache için maxmemory-policy değerini güncelleştirir.

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

Redis için Azure Cache ölçeklendirmek için

Set-AzRedisCache, Skuveya ShardCount özellikleri değiştirildiğinde bir Redis için Azure Cache örneğini Sizeölçeklendirmek için kullanılabilir.

Not

PowerShell kullanarak önbelleği ölçeklendirmek, Azure portalından bir önbelleği ölçeklendirmeyle aynı sınırlara ve yönergelere tabidir. Aşağıdaki kısıtlamalarla farklı bir fiyatlandırma katmanına ölçeklendirme yapabilirsiniz.

  • Daha yüksek bir fiyatlandırma katmanından daha düşük bir fiyatlandırma katmanına ölçeklendirilemezsiniz.
  • Premium önbellekten Standart veya Temel önbelleğe ölçeklendirilemezsiniz.
  • Standart önbellekten Temel önbelleğe ölçeklendirilemezsiniz.
  • Temel önbellekten Standart önbelleğe ölçeklendirme yapabilirsiniz, ancak boyutu aynı anda değiştiremezsiniz. Farklı bir boyuta ihtiyacınız varsa, sonraki bir ölçeklendirme işlemini istediğiniz boyuta yapabilirsiniz.
  • Temel önbellekten doğrudan Premium önbelleğe ölçeklendirilemezsiniz. Bir ölçeklendirme işleminde Temel'den Standart'a, sonraki ölçeklendirme işleminde de Standart'tanPremium'a ölçeklendirmeniz gerekir.
  • Daha büyük bir boyuttan C0 (250 MB) boyutuna ölçeklendirilemezsiniz.

Daha fazla bilgi için bkz. Redis için Azure Cache Ölçeklendirme.

Aşağıdaki örnekte, adlı myCache bir önbelleğin 2,5 GB önbelleğe nasıl ölçeklendirilecekleri gösterilmektedir. Bu komut hem Temel hem de Standart önbellek için çalışır.

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

Bu komut verildikten sonra önbelleğin durumu döndürülür--- çağrısına Get-AzRedisCachebenzer. ProvisioningState olarak ayarlanırScaling.

    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         :

Ölçeklendirme işlemi tamamlandığında, ProvisioningState olarak değişir Succeeded. Başka bir ölçeklendirme işlemi yapmanız gerekirse--- örneğin, Temel'den Standart'a geçiş ve ardından boyutu değiştirme--- önceki işlem tamamlanana kadar beklemeniz veya aşağıdakine benzer bir hata almanız gerekir.

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

Redis için Azure Cache hakkında bilgi almak için

Get-AzRedisCache cmdlet'ini kullanarak önbellekle ilgili bilgileri alabilirsiniz.

için kullanılabilir parametrelerin ve açıklamalarının listesini görmek için Get-AzRedisCacheaşağıdaki komutu çalıştırın.

    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).

Geçerli abonelikteki tüm önbellekler hakkında bilgi döndürmek için herhangi bir parametre olmadan komutunu çalıştırın Get-AzRedisCache .

    Get-AzRedisCache

Belirli bir kaynak grubundaki tüm önbellekler hakkında bilgi döndürmek için parametresiyle ResourceGroupName komutunu çalıştırınGet-AzRedisCache.

    Get-AzRedisCache -ResourceGroupName myGroup

Belirli bir önbellek hakkında bilgi döndürmek için, önbelleğin Name adını içeren parametresiyle ve ResourceGroupName bu önbelleği içeren kaynak grubuyla parametresiyle komutunu çalıştırınGet-AzRedisCache.

    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         :

bir Redis için Azure Cache erişim anahtarlarını almak için

Önbelleğinizin erişim anahtarlarını almak için Get-AzRedisCacheKey cmdlet'ini kullanabilirsiniz.

için kullanılabilir parametrelerin ve açıklamalarının listesini görmek için Get-AzRedisCacheKeyaşağıdaki komutu çalıştırın.

    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).

Önbelleğinizin anahtarlarını almak için cmdlet'ini çağırın Get-AzRedisCacheKey ve önbelleğin adını önbelleği içeren kaynak grubunun adını geçirin.

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

    PrimaryKey   : b2wdt43sfetlju4hfbryfnregrd9wgIcc6IA3zAO1lY=
    SecondaryKey : ABhfB757JgjIgt785JgKH9865eifmekfnn649303JKL=

Redis için Azure Cache erişim anahtarlarını yeniden oluşturmak için

Önbelleğinizin erişim anahtarlarını yeniden oluşturmak için New-AzRedisCacheKey cmdlet'ini kullanabilirsiniz.

için kullanılabilir parametrelerin ve açıklamalarının listesini görmek için New-AzRedisCacheKeyaşağıdaki komutu çalıştırın.

    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).

Önbelleğinizin birincil veya ikincil anahtarını yeniden oluşturmak için cmdlet'ini çağırın New-AzRedisCacheKey ve adı, kaynak grubunu geçirin ve parametre için KeyType veya Secondary belirtinPrimary. Aşağıdaki örnekte, bir önbellek için ikincil erişim anahtarı yeniden oluşturulur.

    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=

Redis için Azure Cache silmek için

Bir Redis için Azure Cache silmek için Remove-AzRedisCache cmdlet'ini kullanın.

için kullanılabilir parametrelerin ve açıklamalarının listesini görmek için Remove-AzRedisCacheaşağıdaki komutu çalıştırın.

    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).

Aşağıdaki örnekte adlı myCache önbellek kaldırılır.

    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

Redis için Azure Cache içeri aktarmak için

Cmdlet'ini kullanarak verileri bir Redis için Azure Cache örneğine Import-AzRedisCache aktarabilirsiniz.

Önemli

İçeri/Dışarı Aktarma yalnızca Premium katman önbellekleri. İçeri/Dışarı Aktarma hakkında daha fazla bilgi için bkz. Redis için Azure Cache'da verileri içeri ve dışarı aktarma.

için kullanılabilir parametrelerin ve açıklamalarının listesini görmek için Import-AzRedisCacheaşağıdaki komutu çalıştırın.

    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).

Aşağıdaki komut SAS uri'sinin belirttiği blobdaki verileri Redis için Azure Cache içeri aktarır.

    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

Redis için Azure Cache dışarı aktarmak için

cmdlet'ini kullanarak bir Redis için Azure Cache örneğinden Export-AzRedisCache verileri dışarı aktarabilirsiniz.

Önemli

İçeri/Dışarı Aktarma yalnızca Premium katman önbellekleri. İçeri/Dışarı Aktarma hakkında daha fazla bilgi için bkz. Redis için Azure Cache'da verileri içeri ve dışarı aktarma.

için kullanılabilir parametrelerin ve açıklamalarının listesini görmek için Export-AzRedisCacheaşağıdaki komutu çalıştırın.

    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).

Aşağıdaki komut, bir Redis için Azure Cache örneğindeki verileri SAS uri'sinin belirttiği kapsayıcıya aktarır.

    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"

bir Redis için Azure Cache yeniden başlatmak için

cmdlet'ini kullanarak Reset-AzRedisCache Redis için Azure Cache örneğinizi yeniden başlatabilirsiniz.

Önemli

Yeniden başlatma yalnızca Temel, Standart ve Premium katman önbelleklerinde kullanılabilir. Önbelleğinizi yeniden başlatma hakkında daha fazla bilgi için bkz . Önbellek yönetimi - yeniden başlatma.

için kullanılabilir parametrelerin ve açıklamalarının listesini görmek için Reset-AzRedisCacheaşağıdaki komutu çalıştırın.

    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).

Aşağıdaki komut, belirtilen önbelleğin her iki düğümlerini de yeniden başlatır.

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

Sonraki adımlar

Windows PowerShell'i Azure ile kullanma hakkında daha fazla bilgi edinmek için aşağıdaki kaynaklara bakın: