Gestire Cache Redis di Azure con Azure PowerShell

  • Articolo

In questo articolo viene illustrato come creare, aggiornare e ridimensionare le istanze di Cache di Azure per Redis. L'articolo illustra anche come rigenerare le chiavi di accesso e come visualizzare informazioni sulle cache. Per un elenco completo dei cmdlet PowerShell di Cache Redis di Azure, vedere Cmdlet di Cache Redis di Azure.

Nota

Azure offre due diversi modelli di distribuzione che possono essere usati per creare e usare le risorse, ovvero Azure Resource Manager e la distribuzione classica. Questo articolo illustra l'uso del modello di distribuzione di Resource Manager. Per le nuove distribuzioni si consiglia di usare il modello di distribuzione di Resource Manager invece di quello classico.

Per altre informazioni sul modello di distribuzione classica vedere Confronto tra distribuzione Azure Resource Manager e classica: comprensione dei modelli di distribuzione e dello stato delle risorse.

Prerequisiti

Se è già installato PowerShell di Microsoft Azure, è necessario installare Azure PowerShell versione 1.0.0 o versione successiva. Per verificare la versione di Azure PowerShell è possibile utilizzare il comando del relativo prompt di Microsoft PowerShell.

    Get-Module Az | format-table version

Prima di tutto è necessario accedere a Microsoft Azure con questo comando.

    Connect-AzAccount

Specificare l'indirizzo e-mail del proprio account Microsoft Azure e la password nella finestra di accesso a Microsoft Azure.

Successivamente, se si dispone di più sottoscrizioni di Microsoft Azure, è necessario impostare la sottoscrizione di Microsoft Azure prescelta. Per visualizzare un elenco di sottoscrizioni correnti, eseguire questo comando.

    Get-AzSubscription | sort SubscriptionName | Select SubscriptionName

Per specificare la sottoscrizione, eseguire il comando seguente. Nell'esempio seguente, il nome della sottoscrizione è ContosoSubscription.

    Select-AzSubscription -SubscriptionName ContosoSubscription

Per usare Windows PowerShell con Gestione risorse di Azure, è necessario verificare la configurazione:

  • Windows PowerShell, versione 3.0 o 4.0. Per individuare la versione di Windows PowerShell, digitare $PSVersionTable e verificare che il valore di PSVersion sia 3.0 o 4.0. Per installare una versione compatibile, vedere Windows Management Framework 3.0.

Per informazioni dettagliate sui cmdlet usati in questa esercitazione, eseguire il cmdlet Get-Help.

    Get-Help <cmdlet-name> -Detailed

Ad esempio, per informazioni sul cmdlet New-AzRedisCache digitare:

    Get-Help New-AzRedisCache -Detailed

Come connettersi ad altri cloud

Per impostazione predefinita l'ambiente di Azure è AzureCloudche rappresenta l'istanza globale del cloud di Azure. Per connettersi a un'altra istanza, usare il comando Connect-AzAccount con l'opzione della riga di comando -Environment o -EnvironmentName con l'ambiente o il nome dell'ambiente.

Per visualizzare l'elenco degli ambienti disponibili, eseguire il cmdlet Get-AzEnvironment .

Per connettersi ad Azure Government Cloud

Per connettersi ad Azure Government Cloud, usare uno dei comandi seguenti.

    Connect-AzAccount -EnvironmentName AzureUSGovernment

O

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

Per creare una cache in Azure Government Cloud, usare una delle località seguenti.

  • USGov Virginia
  • USGov Iowa

Per altre informazioni su Azure Government Cloud, vedere Microsoft Azure per enti pubblici e Guida per gli sviluppatori di Microsoft Azure per enti pubblici.

Connettersi a Microsoft Azure gestito da 21Vianet Cloud

Per connettersi ad Azure gestito da 21Vianet Cloud, usare uno dei comandi seguenti.

    Connect-AzAccount -EnvironmentName AzureChinaCloud

O

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

Per creare una cache in Azure gestito da 21Vianet Cloud, usare una delle località seguenti.

  • Cina orientale
  • Cina settentrionale

Per connettersi a Microsoft Azure Germania

Per connettersi a Microsoft Azure Germania, usare uno dei comandi seguenti.

    Connect-AzAccount -EnvironmentName AzureGermanCloud

O

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

Per creare una cache in Microsoft Azure Germania, usare una delle località seguenti.

  • Germania centrale
  • Germania nord-orientale

Per altre informazioni su Microsoft Azure Germania, vedere Microsoft Azure Germania.

Proprietà usate per PowerShell nella Cache Redis di Azure

La tabella seguente contiene le proprietà Azure PowerShell e le descrizioni dei parametri comuni usati durante la creazione e la gestione di istanze di Cache Redis di Azure con Azure PowerShell.

Parametro Descrizione Default
Nome Nome della cache
Ufficio Percorso della cache
ResourceGroupName Nome del gruppo di risorse in cui creare la cache
Dimensione Dimensioni della cache. I valori validi sono: 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 1 GB
ShardCount Numero di partizioni da creare quando si crea una cache Premium con clustering abilitato. I valori validi sono: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10
SKU Specifica gli SKU della cache. I valori validi sono: Basic, Standard e Premium Standard
RedisConfiguration Specifica le impostazioni di configurazione di Redis. Per i dettagli di ogni impostazione, vedere la tabella Proprietà di RedisConfiguration seguente.
EnableNonSslPort Indica se la porta non SSL è abilitata. Falso
MaxMemoryPolicy Questo parametro è stato deprecato, usare invece RedisConfiguration.
StaticIP Quando si ospita la cache in una rete virtuale, specifica l'indirizzo IP univoco nella subnet per la cache. Se non specificato, ne verrà scelto uno dalla subnet.
Subnet Quando si ospita la cache in una rete virtuale, specifica il nome della subnet in cui distribuire la cache.
VirtualNetwork Quando si ospita la cache in una rete virtuale, specifica l'ID risorsa della rete virtuale in cui distribuire la cache.
KeyType Specifica la chiave di accesso da rigenerare quando si rinnovano le chiavi di accesso. Valori validi: Primario, Secondario

Proprietà di RedisConfiguration

Proprietà Descrizione Piani tariffari
rdb-backup-enabled Indica se la persistenza dei dati Redis è abilitata Solo Premium
rdb-storage-connection-string Stringa di connessione dell'account di archiviazione per la persistenza dei dati Redis Solo Premium
rdb-backup-frequency Frequenza di backup per la persistenza dei dati Redis Solo Premium
maxmemory-reserved Configura la memoria riservata per i processi non della cache Standard e Premium
maxmemory-policy Configura i criteri di rimozione per la cache Tutti i piani tariffari
notify-keyspace-events Configura le notifiche keyspace Standard e Premium
hash-max-ziplist-entries Configura l' ottimizzazione della memoria per tipi di dati aggregati di piccole dimensioni Standard e Premium
hash-max-ziplist-value Configura l' ottimizzazione della memoria per tipi di dati aggregati di piccole dimensioni Standard e Premium
set-max-intset-entries Configura l' ottimizzazione della memoria per tipi di dati aggregati di piccole dimensioni Standard e Premium
zset-max-ziplist-entries Configura l' ottimizzazione della memoria per tipi di dati aggregati di piccole dimensioni Standard e Premium
zset-max-ziplist-value Configura l' ottimizzazione della memoria per tipi di dati aggregati di piccole dimensioni Standard e Premium
database Configura il numero di database. Questa proprietà può essere configurata solo durante la creazione della cache. Standard e Premium

Come creare un'istanza di Cache Redis di Azure

Le nuove istanze di Cache Redis di Azure vengono create con il cmdlet New-AzRedisCache.

Importante

La prima volta chr si crea una cache Redis di Azure in una sottoscrizione tramite il portale di Azure, il portale registra lo spazio dei nomi Microsoft.Cache per la sottoscrizione. Se si prova a creare la prima cache Redis di Azure in una sottoscrizione usando PowerShell, è necessario prima registrare tale spazio dei nomi con il comando seguente. In caso contrario, i cmdlet come New-AzRedisCache e Get-AzRedisCache non riusciranno.

Register-AzResourceProvider -ProviderNamespace "Microsoft.Cache"

Per visualizzare un elenco di parametri disponibili e le relative descrizioni per New-AzRedisCache, eseguire il comando seguente.

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

Per creare una cache con i parametri predefiniti, eseguire il comando seguente.

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

ResourceGroupName, Name, e Location sono parametri obbligatori, ma i restanti sono facoltativi e hanno valori predefiniti. L'esecuzione del comando precedente crea un'istanza di Cache Redis di Azure con SKU Standard con un nome, un percorso e un gruppo di risorse. L'istanza è di 1 GB con la porta non SSL disabilitata.

Per creare una cache Premium, specificare dimensioni P1 (6 GB - 60 GB), P2 (13 GB - 130 GB), P3 (26 GB - 260 GB) o P4 (53 GB - 530 GB). Per abilitare il clustering, specificare un numero di partizioni con il parametro ShardCount . L'esempio seguente crea una cache Premium P1 con tre partizioni. Le dimensioni di una cache Premium P1 sono di 6 GB e dato che sono state specificate tre partizioni le dimensioni totale sono di 18 GB (3 x 6 GB).

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

Specificare i valori per il parametro RedisConfiguration, racchiudere i valori tra {} come coppie chiave/valore, ad esempio @{"maxmemory-policy" = "allkeys-random", "notify-keyspace-events" = "KEA"}. L'esempio seguente crea una cache Standard di 1 GB con criteri di maxmemory e notifiche keyspace allkeys-random configurati con KEA. Per altre informazioni, vedere Notifiche di Keyspace (impostazioni avanzate) e Criteri per la memoria.

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

Per configurare l'impostazione databases durante la creazione della cache

L'impostazione databases può essere configurata solo durante la creazione della cache. L'esempio seguente crea una cache P3 (26 GB) Premium con 48 database usando il cmdlet New-AzRedisCache.

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

Per altre informazioni sulla proprietà databases, vedere Configurazione predefinita del server Cache Redis di Azure. Per altre informazioni sulla creazione di una cache con il cmdlet New-AzRedisCache, vedere la sezione precedente Come creare una cache Redis di Azure.

Come aggiornare un'istanza di Cache Redis di Azure

Le istanze di Cache Redis di Azure vengono aggiornate con il cmdlet Set-AzRedisCache.

Per visualizzare un elenco di parametri disponibili e le relative descrizioni per Set-AzRedisCache, eseguire il comando seguente.

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

Il cmdlet Set-AzRedisCache può essere usato per aggiornare le proprietà, ad esempio i valori Size, Sku, EnableNonSslPort e RedisConfiguration.

Il comando seguente aggiorna maxmemory-policy per la Cache Redis di Azure denominata myCache.

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

Come ridimensionare un’istanza di Cache Redis di Azure

Set-AzRedisCache può essere usato per ridimensionare un'istanza della Cache Redis di Azure quando si modificano le proprietà Size, Sku o ShardCount.

Nota

Il ridimensionamento dell'istanza di una cache con PowerShell è soggetto agli stessi limiti e alle stesse linee guida per il ridimensionamento di una cache dal portale di Azure. Il passaggio a un piano tariffario diverso è soggetto alle restrizioni seguenti.

  • Non è possibile passare da un piano tariffario superiore a uno inferiore.
  • Non è possibile passare da una cache Premium a una cache Standard o Basic.
  • Non è possibile passare da una cache Standard a una cache Basic.
  • È possibile passare da una cache Basic a una cache Standard, ma non è possibile modificare contemporaneamente la dimensione. Se occorre una dimensione diversa, è possibile eseguire successivamente un'operazione di ridimensionamento in base ai propri requisiti.
  • Non è possibile passare direttamente da una cache Basic a una cache Premium. È necessario passare da Basic a Standard con una prima operazione di ridimensionamento e quindi da Standard a Premium con una successiva operazione.
  • Non è possibile passare da una dimensione maggiore alla dimensione C0 (250 MB) .

Per altre informazioni, vedere Come ridimensionare la Cache Redis di Azure.

L'esempio seguente illustra come ridimensionare una cache denominata myCache in una cache di 2,5 GB. Questo comando funziona sia con una cache Basic che una cache Standard.

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

Dopo l'esecuzione di questo comando, viene restituito lo stato della cache, simile a una chiamata a Get-AzRedisCache. ProvisioningState viene impostato su 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         :

Quando l'operazione di ridimensionamento è completa, ProvisioningState viene modificato in Succeeded. Se si vuole effettuare un'altra operazione di ridimensionamento, ad esempio la modifica da Basic a Standard e quindi modificare le dimensioni, è necessario attendere che l'operazione precedente sia stata completata. In caso contrario, verrà visualizzato un errore simile al seguente.

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

Come ottenere informazioni su un’istanza di Cache Redis di Azure

È possibile recuperare informazioni su una cache con il cmdlet Get-AzRedisCache.

Per visualizzare un elenco di parametri disponibili e le relative descrizioni per Get-AzRedisCache, eseguire il comando seguente.

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

Per restituire informazioni su tutte le cache nella sottoscrizione corrente, eseguire Get-AzRedisCache senza parametri.

    Get-AzRedisCache

Per restituire informazioni su tutte le cache in un gruppo di risorse specifico, eseguire Get-AzRedisCache con il parametro ResourceGroupName.

    Get-AzRedisCache -ResourceGroupName myGroup

Per restituire informazioni su una cache specifica, eseguire Get-AzRedisCache con il parametro Name che contiene il nome della cache e il parametro ResourceGroupName con il gruppo di risorse che contiene tale cache.

    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         :

Come recuperare le chiavi di accesso per un'istanza di Cache Redis di Azure

Per recuperare le chiavi di accesso per la cache, è possibile usare il cmdlet Get-AzRedisCacheKey.

Per visualizzare un elenco di parametri disponibili e le relative descrizioni per Get-AzRedisCacheKey, eseguire il comando seguente.

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

Per recuperare le chiavi per la cache, chiamare il cmdlet Get-AzRedisCacheKey e passare il nome della cache e il nome del gruppo di risorse che contiene la cache.

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

    PrimaryKey   : b2wdt43sfetlju4hfbryfnregrd9wgIcc6IA3zAO1lY=
    SecondaryKey : ABhfB757JgjIgt785JgKH9865eifmekfnn649303JKL=

Come rigenerare le chiavi di accesso per l’istanza di Cache Redis di Azure

Per rigenerare le chiavi di accesso per la cache, è possibile usare il cmdlet New-AzRedisCacheKey.

Per visualizzare un elenco di parametri disponibili e le relative descrizioni per New-AzRedisCacheKey, eseguire il comando seguente.

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

Per rigenerare la chiave primaria o secondaria per la cache, chiamare il cmdlet New-AzRedisCacheKey e passare il nome e il gruppo di risorse, quindi specificare il parametro Primary o Secondary per il parametro KeyType. Nell'esempio seguente viene rigenerata la chiave di accesso secondaria per una cache.

    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=

Come eliminare un’istanza di Cache Redis di Azure

Per eliminare un'istanza di Cache Redis di Azure, usare il cmdlet Remove-AzRedisCache.

Per visualizzare un elenco di parametri disponibili e le relative descrizioni per Remove-AzRedisCache, eseguire il comando seguente.

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

Nell'esempio seguente viene rimossa la cache denominata myCache .

    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

Come importare un'istanza di Cache Redis di Azure

È possibile importare dati in un'istanza di Cache Redis di Azure usando il cmdlet Import-AzRedisCache.

Importante

La funzionalità Importazione/Esportazione è disponibile solo per le cache del piano Premium. Per altre informazioni sull'importazione/esportazione, vedere Importare ed esportare dati in Cache Redis di Azure.

Per visualizzare un elenco di parametri disponibili e le relative descrizioni per Import-AzRedisCache, eseguire il comando seguente.

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

Il comando seguente importa dati dal BLOB specificato dall’URI della firma di accesso condiviso nell’istanza di Cache Redis di Azure.

    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

Come esportare un'istanza di Cache Redis di Azure

È possibile esportare dati da un'istanza di Cache Redis di Azure usando il cmdlet Export-AzRedisCache.

Importante

La funzionalità Importazione/Esportazione è disponibile solo per le cache del piano Premium. Per altre informazioni sull'importazione/esportazione, vedere Importare ed esportare dati in Cache Redis di Azure.

Per visualizzare un elenco di parametri disponibili e le relative descrizioni per Export-AzRedisCache, eseguire il comando seguente.

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

Il seguente comando consente di esportare dati da un’istanza di Cache Redis di Azure nel contenitore specificato dall’URI della firma di accesso condiviso.

    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"

Come riavviare un'istanza di Cache Redis di Azure

È possibile riavviare un'istanza della Cache Redis di Azure usando il cmdlet Reset-AzRedisCache.

Importante

Il reboot è disponibile solo per le cache dei livelli Basic, Standard e Premium. Per altre informazioni sul riavvio della cache, vedere Come amministrare Cache Redis di Azure - Riavviare.

Per visualizzare un elenco di parametri disponibili e le relative descrizioni per Reset-AzRedisCache, eseguire il comando seguente.

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

Il comando seguente riavvia entrambi i nodi della cache specificata.

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

Passaggi successivi

Per ulteriori informazioni sull'utilizzo di Windows PowerShell con Azure, vedere le risorse seguenti: