Správa služby Azure Cache for Redis pomocí Azure PowerShellu

  • Článek

V tomto článku se dozvíte, jak vytvářet, aktualizovat a škálovat instance Azure Cache for Redis. Článek také ukazuje, jak znovu vygenerovat přístupové klíče a jak zobrazit informace o vašich mezipamětí. Úplný seznam rutin PowerShellu pro Azure Cache for Redis najdete v tématu Rutiny Azure Cache for Redis.

Poznámka:

Azure má dva různé modely nasazení, které můžete použít k vytváření a práci s prostředky: Azure Resource Manager a Classic. Tento článek popisuje použití modelu nasazení Resource Manager. Pro nová nasazení místo modelu nasazení Classic doporučujeme model nasazení Resource Manager.

Další informace o modelu nasazení Classic najdete v tématu Azure Resource Manager vs. nasazení Classic: Vysvětlení modelů nasazení a stavu vašich prostředků.

Požadavky

Pokud jste už nainstalovali Azure PowerShell, musíte mít Azure PowerShell verze 1.0.0 nebo novější. Verzi Azure PowerShellu můžete zkontrolovat pomocí tohoto příkazu na příkazovém řádku Azure PowerShellu.

    Get-Module Az | format-table version

Nejprve se musíte přihlásit k Azure pomocí tohoto příkazu.

    Connect-AzAccount

V dialogovém okně pro přihlášení k Microsoft Azure zadejte e-mailovou adresu svého účtu Azure a heslo.

Pokud máte více předplatných Azure, musíte nastavit předplatné Azure. Pokud chcete zobrazit seznam aktuálních předplatných, spusťte tento příkaz.

    Get-AzSubscription | sort SubscriptionName | Select SubscriptionName

Pokud chcete zadat předplatné, spusťte následující příkaz. V následujícím příkladu je ContosoSubscriptionnázev předplatného .

    Select-AzSubscription -SubscriptionName ContosoSubscription

Než budete moct používat Windows PowerShell s Azure Resource Managerem, musíte ověřit nastavení:

  • Windows PowerShell verze 3.0 nebo 4.0. Pokud chcete najít verzi Windows PowerShellu, zadejte:$PSVersionTable a ověřte, že je hodnota PSVersion 3.0 nebo 4.0. Informace o instalaci kompatibilní verze naleznete v tématu Windows Management Framework 3.0.

Pokud chcete získat podrobnou nápovědu pro všechny rutiny, které vidíte v tomto kurzu, použijte rutinu Get-Help.

    Get-Help <cmdlet-name> -Detailed

Pokud chcete například získat nápovědu pro rutinu New-AzRedisCache , zadejte:

    Get-Help New-AzRedisCache -Detailed

Jak se připojit k jiným cloudům

Ve výchozím nastavení je AzureCloudprostředí Azure , které představuje globální cloudovou instanci Azure. Pokud se chcete připojit k jiné instanci, použijte Connect-AzAccount příkaz s -Environment přepínačem příkazového řádku neboEnvironmentName přepínačem příkazového řádku s požadovaným názvem prostředí nebo prostředí.

Pokud chcete zobrazit seznam dostupných prostředí, spusťte rutinu Get-AzEnvironment .

Připojení ke cloudu Azure Government

Pokud se chcete připojit ke cloudu Azure Government, použijte jeden z následujících příkazů.

    Connect-AzAccount -EnvironmentName AzureUSGovernment

Nebo

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

Pokud chcete vytvořit mezipaměť v cloudu Azure Government, použijte jedno z následujících umístění.

  • USGov Virginia
  • USGov Iowa

Další informace o cloudu Azure Government najdete v příručce pro vývojáře Microsoft Azure Government a Microsoft Azure Government.

Připojení k Microsoft Azure provozovanému společností 21Vianet Cloud

Pokud se chcete připojit k Azure provozovanému cloudem 21Vianet, použijte jeden z následujících příkazů.

    Connect-AzAccount -EnvironmentName AzureChinaCloud

Nebo

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

K vytvoření mezipaměti v Azure provozovaném společností 21Vianet Cloud použijte jedno z následujících umístění.

  • Čína – východ
  • Čína – sever

Připojení k Microsoft Azure Germany

Pokud se chcete připojit k Microsoft Azure Germany, použijte jeden z následujících příkazů.

    Connect-AzAccount -EnvironmentName AzureGermanCloud

Nebo

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

Pokud chcete vytvořit mezipaměť v Microsoft Azure Germany, použijte jedno z následujících umístění.

  • Německo – střed
  • Německo – severovýchod

Další informace o Microsoft Azure Germany naleznete v tématu Microsoft Azure Germany.

Vlastnosti používané pro Azure Cache for Redis PowerShell

Následující tabulka obsahuje vlastnosti a popisy Azure PowerShellu pro běžné parametry při vytváření a správě instancí Azure Cache for Redis.

Parametr Popis Výchozí
Název Název mezipaměti
Umístění Umístění mezipaměti
ResourceGroupName Název skupiny prostředků, ve které se má vytvořit mezipaměť
Velikost Velikost mezipaměti. Platné hodnoty jsou: P1, P2, P3, P4, P5, C0, C1, C2, C3, C4, C5, C6, 250 MB, 1 GB, 2,5 GB, 6 GB, 13 GB, 26 GB, 53 GB 1GB
ShardCount Počet horizontálních oddílů, které se mají vytvořit při vytváření mezipaměti Premium s povoleným clusteringem. Platné hodnoty jsou: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10
Skladová jednotka (SKU) Určuje skladovou položku mezipaměti. Platné hodnoty jsou: Basic, Standard, Premium Standard
RedisConfiguration Určuje nastavení konfigurace Redis. Podrobnosti o jednotlivých nastaveních najdete v následující tabulce vlastností RedisConfiguration.
EnableNonSslPort Určuje, jestli je povolený port bez SSL. False
MaxMemoryPolicy Tento parametr je zastaralý – místo toho použijte RedisConfiguration.
StaticIP Při hostování mezipaměti ve virtuální síti určuje jedinečnou IP adresu v podsíti pro mezipaměť. Pokud není k dispozici, vybere se pro vás z podsítě.
Podsíť Při hostování mezipaměti ve virtuální síti určuje název podsítě, ve které se má mezipaměť nasadit.
VirtualNetwork Při hostování mezipaměti ve virtuální síti určuje ID prostředku virtuální sítě, ve které se má mezipaměť nasadit.
Keytype Určuje, který přístupový klíč se má znovu vygenerovat při obnovování přístupových klíčů. Platné hodnoty jsou: Primární, Sekundární

RedisConfiguration – vlastnosti

Vlastnost Popis Cenové úrovně
Rdb-backup-enabled Jestli je povolená trvalost dat Redis Pouze Premium
rdb-storage-connection-string Připojovací řetězec k účtu úložiště pro trvalost dat Redis Pouze Premium
rdb-backup-frequency Frekvence zálohování pro trvalost dat Redis Pouze Premium
maxmemory-reserved Nakonfiguruje paměť vyhrazenou pro procesy mimo mezipaměť. Standard a Premium
maxmemory-policy Nakonfiguruje zásadu vyřazení pro mezipaměť. Všechny cenové úrovně
notify-keyspace-events Konfiguruje oznámení o prostoru klíčů. Standard a Premium
hash-max-ziplist-entries Konfiguruje optimalizaci paměti pro malé agregované datové typy. Standard a Premium
hash-max-ziplist-value Konfiguruje optimalizaci paměti pro malé agregované datové typy. Standard a Premium
set-max-intset-entries Konfiguruje optimalizaci paměti pro malé agregované datové typy. Standard a Premium
zset-max-ziplist-entries Konfiguruje optimalizaci paměti pro malé agregované datové typy. Standard a Premium
zset-max-ziplist-value Konfiguruje optimalizaci paměti pro malé agregované datové typy. Standard a Premium
V databázích Konfiguruje počet databází. Tuto vlastnost lze nakonfigurovat pouze při vytváření mezipaměti. Standard a Premium

Vytvoření azure Cache for Redis

Nové instance Azure Cache for Redis se vytvářejí pomocí rutiny New-AzRedisCache .

Důležité

Při prvním vytvoření služby Azure Cache for Redis v předplatném pomocí webu Azure Portal portál zaregistruje Microsoft.Cache obor názvů pro toto předplatné. Pokud se pokusíte vytvořit první službu Azure Cache for Redis v předplatném pomocí PowerShellu, musíte nejprve tento obor názvů zaregistrovat pomocí následujícího příkazu; jinak rutiny, jako New-AzRedisCache jsou a Get-AzRedisCache selžou.

Register-AzResourceProvider -ProviderNamespace "Microsoft.Cache"

Pokud chcete zobrazit seznam dostupných parametrů a jejich popis, New-AzRedisCachespusťte následující příkaz.

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

Pokud chcete vytvořit mezipaměť s výchozími parametry, spusťte následující příkaz.

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

ResourceGroupName, Namea Location jsou povinné parametry, ale zbývající hodnoty jsou volitelné a mají výchozí hodnoty. Spuštěním předchozího příkazu se vytvoří instance Azure Cache for Redis úrovně Standard se zadaným názvem, umístěním a skupinou prostředků. Instance má velikost 1 GB s zakázaným portem bez SSL.

Pokud chcete vytvořit mezipaměť Premium, zadejte velikost P1 (6 GB – 60 GB), P2 (13 GB – 130 GB), P3 (26 GB – 260 GB) nebo P4 (53 GB až 530 GB). Pokud chcete povolit clustering, zadejte pomocí parametru ShardCount počet horizontálních oddílů. Následující příklad vytvoří mezipaměť P1 Premium se třemi horizontálními oddíly. Mezipaměť P1 úrovně Premium je velikost 6 GB a vzhledem k tomu, že jsme zadali tři horizontální oddíly, celková velikost je 18 GB (3 x 6 GB).

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

Chcete-li zadat hodnoty parametru RedisConfiguration , uzavřete hodnoty uvnitř {} jako páry klíč/hodnota, například @{"maxmemory-policy" = "allkeys-random", "notify-keyspace-events" = "KEA"}. Následující příklad vytvoří standardní mezipaměť 1 GB se allkeys-random zásadami maxmemory a oznámeními o prostoru klíčů nakonfigurovanými pomocí KEA. Další informace najdete v tématu Oznámení služby Keyspace (upřesňující nastavení) a Zásady paměti.

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

Konfigurace nastavení databází během vytváření mezipaměti

Nastavení databases lze nakonfigurovat pouze během vytváření mezipaměti. Následující příklad vytvoří mezipaměť Premium P3 (26 GB) s 48 databázemi pomocí rutiny New-AzRedisCache .

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

Další informace o databases vlastnosti najdete v tématu Výchozí konfigurace serveru Azure Cache for Redis. Další informace o vytvoření mezipaměti pomocí rutiny New-AzRedisCache najdete v předchozí části Vytvoření služby Azure Cache for Redis.

Aktualizace azure Cache for Redis

Instance Azure Cache for Redis se aktualizují pomocí rutiny Set-AzRedisCache .

Pokud chcete zobrazit seznam dostupných parametrů a jejich popis, Set-AzRedisCachespusťte následující příkaz.

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

Rutinu Set-AzRedisCache lze použít k aktualizaci vlastností, jako Sizejsou , SkuEnableNonSslPorta RedisConfiguration hodnoty.

Následující příkaz aktualizuje zásady maxmemory-policy pro Azure Cache for Redis s názvem myCache.

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

Škálování služby Azure Cache for Redis

Set-AzRedisCachelze použít ke škálování instance Azure Cache for Redis při úpravě SizeSku, nebo ShardCount vlastností.

Poznámka:

Škálování mezipaměti pomocí PowerShellu podléhá stejným omezením a pokynům jako škálování mezipaměti z webu Azure Portal. S následujícími omezeními můžete škálovat na jinou cenovou úroveň.

  • Nemůžete škálovat z vyšší cenové úrovně na nižší cenovou úroveň.
  • Nejde škálovat z mezipaměti Premium dolů na mezipaměť Úrovně Standard nebo Basic .
  • Nejde škálovat z mezipaměti Standard dolů do mezipaměti Basic .
  • Velikost můžete škálovat z mezipaměti Basic na mezipaměť Úrovně Standard , ale nemůžete změnit velikost současně. Pokud potřebujete jinou velikost, můžete provést následnou operaci škálování na požadovanou velikost.
  • Nemůžete škálovat z mezipaměti Basic přímo do mezipaměti Premium . V jedné operaci škálování je nutné škálovat z úrovně Basic na Standard a potom z úrovně Standard na Premium v následné operaci škálování.
  • Nejde škálovat z větší velikosti na velikost C0 (250 MB).

Další informace najdete v tématu Škálování služby Azure Cache for Redis.

Následující příklad ukazuje, jak škálovat mezipaměť s názvem myCache na mezipaměť o velikosti 2,5 GB. Tento příkaz funguje pro mezipaměť Basic nebo Standard.

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

Po vydání tohoto příkazu se vrátí stav mezipaměti---similar pro volání Get-AzRedisCache. Je nastavena ProvisioningState na Scalinghodnotu .

    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         :

Po dokončení operace škálování se změní na ProvisioningStateSucceeded. Pokud potřebujete provést další operaci škálování--- například změna z úrovně Basic na standard a následná změna velikosti---počkejte na dokončení předchozí operace nebo se zobrazí chyba podobná následující.

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

Získání informací o službě Azure Cache for Redis

Informace o mezipaměti můžete načíst pomocí rutiny Get-AzRedisCache .

Pokud chcete zobrazit seznam dostupných parametrů a jejich popis, Get-AzRedisCachespusťte následující příkaz.

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

Pokud chcete vrátit informace o všech mezipamětí v aktuálním předplatném, spusťte Get-AzRedisCache bez parametrů.

    Get-AzRedisCache

Pokud chcete vrátit informace o všech mezipamětí v konkrétní skupině prostředků, spusťte Get-AzRedisCache s parametrem ResourceGroupName .

    Get-AzRedisCache -ResourceGroupName myGroup

Pokud chcete vrátit informace o konkrétní mezipaměti, spusťte Get-AzRedisCache s Name parametrem obsahujícím název mezipaměti a ResourceGroupName parametr se skupinou prostředků obsahující danou mezipaměť.

    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         :

Načtení přístupových klíčů pro Azure Cache for Redis

K načtení přístupových klíčů pro vaši mezipaměť můžete použít rutinu Get-AzRedisCacheKey .

Pokud chcete zobrazit seznam dostupných parametrů a jejich popis, Get-AzRedisCacheKeyspusťte následující příkaz.

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

Pokud chcete načíst klíče pro vaši mezipaměť, zavolejte rutinu Get-AzRedisCacheKey a předejte název mezipaměti název skupiny prostředků, která mezipaměť obsahuje.

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

    PrimaryKey   : b2wdt43sfetlju4hfbryfnregrd9wgIcc6IA3zAO1lY=
    SecondaryKey : ABhfB757JgjIgt785JgKH9865eifmekfnn649303JKL=

Opětovné vygenerování přístupových klíčů pro Azure Cache for Redis

K opětovnému vygenerování přístupových klíčů pro vaši mezipaměť můžete použít rutinu New-AzRedisCacheKey .

Pokud chcete zobrazit seznam dostupných parametrů a jejich popis, New-AzRedisCacheKeyspusťte následující příkaz.

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

Pokud chcete znovu vygenerovat primární nebo sekundární klíč pro vaši mezipaměť, zavolejte rutinu New-AzRedisCacheKey a předejte název, skupinu prostředků a zadejte buď Primary nebo Secondary pro KeyType parametr. V následujícím příkladu se sekundární přístupový klíč pro mezipaměť znovu vygeneruje.

    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=

Odstranění služby Azure Cache for Redis

Pokud chcete odstranit Azure Cache for Redis, použijte rutinu Remove-AzRedisCache .

Pokud chcete zobrazit seznam dostupných parametrů a jejich popis, Remove-AzRedisCachespusťte následující příkaz.

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

V následujícím příkladu je pojmenovaná myCache mezipaměť odebrána.

    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

Import služby Azure Cache for Redis

Data můžete importovat do instance Azure Cache for Redis pomocí této rutiny Import-AzRedisCache .

Důležité

Import/export je k dispozici pouze pro mezipaměti úrovně Premium. Další informace o importu a exportu najdete v tématu Import a export dat ve službě Azure Cache for Redis.

Pokud chcete zobrazit seznam dostupných parametrů a jejich popis, Import-AzRedisCachespusťte následující příkaz.

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

Následující příkaz naimportuje data z objektu blob určeného identifikátorem URI SAS do 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

Export služby Azure Cache for Redis

Data z instance Azure Cache for Redis můžete exportovat pomocí rutiny Export-AzRedisCache .

Důležité

Import/export je k dispozici pouze pro mezipaměti úrovně Premium. Další informace o importu a exportu najdete v tématu Import a export dat ve službě Azure Cache for Redis.

Pokud chcete zobrazit seznam dostupných parametrů a jejich popis, Export-AzRedisCachespusťte následující příkaz.

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

Následující příkaz exportuje data z instance Azure Cache for Redis do kontejneru určeného identifikátorem URI SAS.

    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"

Restartování služby Azure Cache for Redis

Instanci Azure Cache for Redis můžete restartovat pomocí této rutiny Reset-AzRedisCache .

Důležité

Restartování je k dispozici pouze pro mezipaměti úrovně Basic, Standard a Premium . Další informace o restartování mezipaměti naleznete v tématu Správa mezipaměti – restartování.

Pokud chcete zobrazit seznam dostupných parametrů a jejich popis, Reset-AzRedisCachespusťte následující příkaz.

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

Následující příkaz restartuje oba uzly zadané mezipaměti.

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

Další kroky

Další informace o používání Windows PowerShellu s Azure najdete v následujících zdrojích informací: