Gestire Cache Redis di Azure con Azure PowerShellManage Azure Redis Cache with Azure PowerShell

Questo argomento illustra come eseguire attività comuni, come creare, aggiornare e ridimensionare le istanze di Cache Redis di Azure, come rigenerare le chiavi di accesso e come visualizzare le informazioni relative alle cache.This topic shows you how to perform common tasks such as create, update, and scale your Azure Redis Cache instances, how to regenerate access keys, and how to view information about your caches. Per un elenco completo dei cmdlet PowerShell di Cache Redis di Azure, vedere Cmdlet di Cache Redis di Azure.For a complete list of Azure Redis Cache PowerShell cmdlets, see Azure Redis Cache cmdlets.

Nota

Azure offre due modelli di distribuzione per creare e usare le risorse: Gestione risorse e la distribuzione classica.Azure has two different deployment models for creating and working with resources: Resource Manager and classic. Questo articolo illustra il modello di distribuzione Resource Manager, che Microsoft consiglia di usare per le nuove distribuzioni in sostituzione del modello di distribuzione classica.This article covers using the Resource Manager deployment model, which Microsoft recommends for new deployments instead of the classic deployment model.

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.For more information about the classic deployment model, see Azure Resource Manager vs. classic deployment: Understand deployment models and the state of your resources.

prerequisitiPrerequisites

Se è già installato PowerShell di Microsoft Azure, è necessario installare Azure PowerShell versione 1.0.0 o versione successiva.If you have already installed Azure PowerShell, you must have Azure PowerShell version 1.0.0 or later. Per verificare quale versione di Azure PowerShell è installata, è possibile utilizzare il comando del relativo prompt di Microsoft PowerShell.You can check the version of Azure PowerShell that you have installed with this command at the Azure PowerShell command prompt.

Get-Module azure | format-table version

Prima di tutto è necessario accedere a Microsoft Azure con questo comando.First, you must log in to Azure with this command.

Connect-AzureRmAccount

Specificare l'indirizzo e-mail del proprio account Microsoft Azure e la relativa password nella finestra di accesso a Microsoft Azure.Specify the email address of your Azure account and its password in the Microsoft Azure sign-in dialog.

Successivamente, se si dispone di più sottoscrizioni di Microsoft Azure, è necessario impostare la sottoscrizione di Microsoft Azure prescelta.Next, if you have multiple Azure subscriptions, you need to set your Azure subscription. Per visualizzare un elenco di sottoscrizioni correnti, eseguire questo comando.To see a list of your current subscriptions, run this command.

Get-AzureRmSubscription | sort SubscriptionName | Select SubscriptionName

Per specificare la sottoscrizione, eseguire il comando seguente.To specify the subscription, run the following command. Nell'esempio seguente, il nome della sottoscrizione è ContosoSubscription.In the following example, the subscription name is ContosoSubscription.

Select-AzureRmSubscription -SubscriptionName ContosoSubscription

Per usare Windows PowerShell con Gestione risorse di Azure, è necessario disporre di quanto indicato di seguito:Before you can use Windows PowerShell with Azure Resource Manager, you need the following:

Per informazioni dettagliate sui cmdlet usati in questa esercitazione, eseguire il cmdlet Get-Help.To get detailed help for any cmdlet you see in this tutorial, use the Get-Help cmdlet.

Get-Help <cmdlet-name> -Detailed

Ad esempio, per informazioni sul cmdlet New-AzureRmRedisCache digitare:For example, to get help for the New-AzureRmRedisCache cmdlet, type:

Get-Help New-AzureRmRedisCache -Detailed

Come connettersi ad altri cloudHow to connect to other clouds

Per impostazione predefinita l'ambiente di Azure è AzureCloudche rappresenta l'istanza globale del cloud di Azure.By default the Azure environment is AzureCloud, which represents the global Azure cloud instance. Per connettersi a un'altra istanza, usare il comando Connect-AzureRmAccount con l'opzione della riga di comando -Environment o -EnvironmentName con l'ambiente desiderato o il nome dell'ambiente.To connect to a different instance, use the Connect-AzureRmAccount command with the -Environment or -EnvironmentName command line switch with the desired environment or environment name.

Per visualizzare l'elenco degli ambienti disponibili, eseguire il cmdlet Get-AzureRmEnvironment .To see the list of available environments, run the Get-AzureRmEnvironment cmdlet.

Per connettersi ad Azure Government CloudTo connect to the Azure Government Cloud

Per connettersi ad Azure Government Cloud, usare uno dei comandi seguenti.To connect to the Azure Government Cloud, use one of the following commands.

Connect-AzureRmAccount -EnvironmentName AzureUSGovernment

oppureor

Connect-AzureRmAccount -Environment (Get-AzureRmEnvironment -Name AzureUSGovernment)

Per creare una cache in Azure Government Cloud, usare una delle località seguenti.To create a cache in the Azure Government Cloud, use one of the following locations.

  • USGov VirginiaUSGov Virginia
  • USGov IowaUSGov 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.For more information about the Azure Government Cloud, see Microsoft Azure Government and Microsoft Azure Government Developer Guide.

Per connettersi ad Azure China CloudTo connect to the Azure China Cloud

Per connettersi ad Azure China Cloud, usare uno dei comandi seguenti.To connect to the Azure China Cloud, use one of the following commands.

Connect-AzureRmAccount -EnvironmentName AzureChinaCloud

oppureor

Connect-AzureRmAccount -Environment (Get-AzureRmEnvironment -Name AzureChinaCloud)

Per creare una cache in Azure China Cloud, usare una delle località seguenti.To create a cache in the Azure China Cloud, use one of the following locations.

  • Cina orientaleChina East
  • Cina settentrionaleChina North

Per altre informazioni su Azure China Cloud, vedere la pagina relativa ad Azure China Cloud per Azure gestito da 21Vianet in Cina.For more information about the Azure China Cloud, see AzureChinaCloud for Azure operated by 21Vianet in China.

Per connettersi a Microsoft Azure GermaniaTo connect to Microsoft Azure Germany

Per connettersi a Microsoft Azure Germania, usare uno dei comandi seguenti.To connect to Microsoft Azure Germany, use one of the following commands.

Connect-AzureRmAccount -EnvironmentName AzureGermanCloud

oppureor

Connect-AzureRmAccount -Environment (Get-AzureRmEnvironment -Name AzureGermanCloud)

Per creare una cache in Microsoft Azure Germania, usare una delle località seguenti.To create a cache in Microsoft Azure Germany, use one of the following locations.

  • Germania centraleGermany Central
  • Germania nord-orientaleGermany Northeast

Per altre informazioni su Microsoft Azure Germania, vedere Microsoft Azure Germania.For more information about Microsoft Azure Germany, see Microsoft Azure Germany.

Proprietà usate per PowerShell nella Cache Redis di Azure Properties used for Azure Redis Cache PowerShell

La tabella seguente contiene le proprietà e le descrizioni dei parametri usati durante la creazione e la gestione di istanze di Cache Redis di Azure con Azure PowerShell.The following table contains properties and descriptions for commonly used parameters when creating and managing your Azure Redis Cache instances using Azure PowerShell.

ParametroParameter DESCRIZIONEDescription PredefinitoDefault
NOMEName Nome della cacheName of the cache
LocalitàLocation Percorso della cacheLocation of the cache
ResourceGroupNameResourceGroupName Nome del gruppo di risorse in cui creare la cacheResource group name in which to create the cache
DimensioneSize Dimensioni della cache.The size of the cache. I valori validi sono: P1, P2, P3, P4, C0, C1, C2, C3, C4, C5, C6, 250 MB, 1 GB, 2,5 GB, 6 GB, 13 GB, 26 GB, 53 GBValid values are: P1, P2, P3, P4, C0, C1, C2, C3, C4, C5, C6, 250MB, 1GB, 2.5GB, 6GB, 13GB, 26GB, 53GB 1 GB1GB
ShardCountShardCount Numero di partizioni da creare quando si crea una cache Premium con clustering abilitato.The number of shards to create when creating a premium cache with clustering enabled. I valori validi sono: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10Valid values are: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10
SKUSKU Specifica gli SKU della cache.Specifies the SKU of the cache. I valori validi sono: Basic, Standard e PremiumValid values are: Basic, Standard, Premium StandardStandard
RedisConfigurationRedisConfiguration Specifica le impostazioni di configurazione di Redis.Specifies Redis configuration settings. Per i dettagli di ogni impostazione, vedere la tabella Proprietà di RedisConfiguration seguente.For details on each setting, see the following RedisConfiguration properties table.
EnableNonSslPortEnableNonSslPort Indica se la porta non SSL è abilitata.Indicates whether the non-SSL port is enabled. FalseFalse
MaxMemoryPolicyMaxMemoryPolicy Questo parametro è stato deprecato, usare invece RedisConfiguration.This parameter has been deprecated - use RedisConfiguration instead.
StaticIPStaticIP Quando si ospita la cache in una rete virtuale, specifica l'indirizzo IP univoco nella subnet per la cache.When hosting your cache in a VNET, specifies a unique IP address in the subnet for the cache. Se non specificato, ne verrà scelto uno dalla subnet.If not provided, one is chosen for you from the subnet.
SubnetSubnet Quando si ospita la cache in una rete virtuale, specifica il nome della subnet in cui distribuire la cache.When hosting your cache in a VNET, specifies the name of the subnet in which to deploy the cache.
VirtualNetworkVirtualNetwork Quando si ospita la cache in una rete virtuale, specifica l'ID risorsa della rete virtuale in cui distribuire la cache.When hosting your cache in a VNET, specifies the resource ID of the VNET in which to deploy the cache.
KeyTypeKeyType Specifica la chiave di accesso da rigenerare quando si rinnovano le chiavi di accesso.Specifies which access key to regenerate when renewing access keys. Valori validi: Primario, SecondarioValid values are: Primary, Secondary

Proprietà di RedisConfigurationRedisConfiguration properties

ProprietàProperty DESCRIZIONEDescription Piani tariffariPricing tiers
rdb-backup-enabledrdb-backup-enabled Indica se la persistenza dei dati Redis è abilitataWhether Redis data persistence is enabled Solo PremiumPremium only
rdb-storage-connection-stringrdb-storage-connection-string Stringa di connessione dell'account di archiviazione per la persistenza dei dati RedisThe connection string to the storage account for Redis data persistence Solo PremiumPremium only
rdb-backup-frequencyrdb-backup-frequency Frequenza di backup per la persistenza dei dati RedisThe backup frequency for Redis data persistence Solo PremiumPremium only
maxmemory-reservedmaxmemory-reserved Configura la memoria riservata per i processi non della cacheConfigures the memory reserved for non-cache processes Standard e PremiumStandard and Premium
maxmemory-policymaxmemory-policy Configura i criteri di rimozione per la cacheConfigures the eviction policy for the cache Tutti i piani tariffariAll pricing tiers
notify-keyspace-eventsnotify-keyspace-events Configura le notifiche keyspaceConfigures keyspace notifications Standard e PremiumStandard and Premium
hash-max-ziplist-entrieshash-max-ziplist-entries Configura l' ottimizzazione della memoria per tipi di dati aggregati di piccole dimensioniConfigures memory optimization for small aggregate data types Standard e PremiumStandard and Premium
hash-max-ziplist-valuehash-max-ziplist-value Configura l' ottimizzazione della memoria per tipi di dati aggregati di piccole dimensioniConfigures memory optimization for small aggregate data types Standard e PremiumStandard and Premium
set-max-intset-entriesset-max-intset-entries Configura l' ottimizzazione della memoria per tipi di dati aggregati di piccole dimensioniConfigures memory optimization for small aggregate data types Standard e PremiumStandard and Premium
zset-max-ziplist-entrieszset-max-ziplist-entries Configura l' ottimizzazione della memoria per tipi di dati aggregati di piccole dimensioniConfigures memory optimization for small aggregate data types Standard e PremiumStandard and Premium
zset-max-ziplist-valuezset-max-ziplist-value Configura l' ottimizzazione della memoria per tipi di dati aggregati di piccole dimensioniConfigures memory optimization for small aggregate data types Standard e PremiumStandard and Premium
databasedatabases Configura il numero di database.Configures the number of databases. Questa proprietà può essere configurata solo durante la creazione della cache.This property can be configured only at cache creation. Standard e PremiumStandard and Premium

Creare una Cache RedisTo create a Redis Cache

Le nuove istanze della Cache Redis di Azure vengono create con il cmdlet New AzureRmRedisCache .New Azure Redis Cache instances are created using the New-AzureRmRedisCache cmdlet.

Importante

La prima volta chr si crea una cache Redis 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 in una sottoscrizione usando PowerShell, è necessario prima registrare tale spazio dei nomi con il comando seguente. In caso contrario, i cmdlet come New-AzureRmRedisCache e Get-AzureRmRedisCache non riusciranno.

Register-AzureRmResourceProvider -ProviderNamespace "Microsoft.Cache"

Per visualizzare un elenco di parametri disponibili e le relative descrizioni per New-AzureRmRedisCache, eseguire il comando seguente.To see a list of available parameters and their descriptions for New-AzureRmRedisCache, run the following command.

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

NAME
    New-AzureRmRedisCache

SYNOPSIS
    Creates a new redis cache.


SYNTAX
    New-AzureRmRedisCache -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-AzureRmRedisCache cmdlet creates a new redis cache.


PARAMETERS
    -Name <String>
        Name of the redis cache to create.

    -ResourceGroupName <String>
        Name of resource group in which to create the redis cache.

    -Location <String>
        Location in which to create the redis cache.

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

    -Size <String>
        Size of the redis cache. 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 redis cache. 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 Redis Cache. 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 redis cache in. Example format: /subscriptions/{
        subid}/resourceGroups/{resourceGroupName}/providers/Microsoft.ClassicNetwork/VirtualNetworks/{vnetName}

    -Subnet <String>
        Required when deploying a redis cache inside an existing Azure Virtual Network.

    -StaticIP <String>
        Required when deploying a redis cache 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 (http://go.microsoft.com/fwlink/?LinkID=113216).

Per creare una cache con i parametri predefiniti, eseguire il comando seguente.To create a cache with default parameters, run the following command.

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

ResourceGroupName, Name, e Location sono parametri obbligatori, ma il resto sono facoltativi e hanno valori predefiniti.ResourceGroupName, Name, and Location are required parameters, but the rest are optional and have default values. 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 specificati e dimensioni di 1 GB con la porta non SSL disabilitata.Running the previous command creates a Standard SKU Azure Redis Cache instance with the specified name, location, and resource group, that is 1 GB in size with the non-SSL port disabled.

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).To create a premium cache, specify a size of P1 (6 GB - 60 GB), P2 (13 GB - 130 GB), P3 (26 GB - 260 GB), or P4 (53 GB - 530 GB). Per abilitare il clustering, specificare un numero di partizioni con il parametro ShardCount .To enable clustering, specify a shard count using the ShardCount parameter. L'esempio seguente crea una cache Premium P1 con 3 partizioni.The following example creates a P1 premium cache with 3 shards. 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).A P1 premium cache is 6 GB in size, and since we specified three shards the total size is 18 GB (3 x 6 GB).

New-AzureRmRedisCache -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"}.To specify values for the RedisConfiguration parameter, enclose the values inside {} as key/value pairs like @{"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.The following example creates a standard 1 GB cache with allkeys-random maxmemory policy and keyspace notifications configured with KEA. Per altre informazioni, vedere Notifiche di Keyspace (impostazioni avanzate) e Criteri per la memoria.For more information, see Keyspace notifications (advanced settings) and Memory policies.

New-AzureRmRedisCache -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 cacheTo configure the databases setting during cache creation

L'impostazione databases può essere configurata solo durante la creazione della cache.The databases setting can be configured only during cache creation. L'esempio seguente crea una cache P3 (26 GB) Premium con 48 database usando il cmdlet New-AzureRmRedisCache .The following example creates a premium P3 (26 GB) cache with 48 databases using the New-AzureRmRedisCache cmdlet.

New-AzureRmRedisCache -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.For more information on the databases property, see Default Azure Redis Cache server configuration. Per altre informazioni sulla creazione di una cache con il cmdlet New-AzureRmRedisCache, vedere la sezione precedente Per creare una cache Redis.For more information on creating a cache using the New-AzureRmRedisCache cmdlet, see the previous To create a Redis Cache section.

Per aggiornare una Cache RedisTo update a Redis cache

Le nuove istanze della Cache Redis di Azure vengono aggiornate con il cmdlet Set-AzureRmRedisCache .Azure Redis Cache instances are updated using the Set-AzureRmRedisCache cmdlet.

Per visualizzare un elenco di parametri disponibili e le relative descrizioni per Set-AzureRmRedisCache, eseguire il comando seguente.To see a list of available parameters and their descriptions for Set-AzureRmRedisCache, run the following command.

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

NAME
    Set-AzureRmRedisCache

SYNOPSIS
    Set redis cache updatable parameters.

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

DESCRIPTION
    The Set-AzureRmRedisCache cmdlet sets redis cache parameters.

PARAMETERS
    -Name <String>
        Name of the redis cache to update.

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

    -Size <String>
        Size of the redis cache. 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 redis cache. 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 Redis Cache. 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 (http://go.microsoft.com/fwlink/?LinkID=113216).

Il cmdlet Set-AzureRmRedisCache può essere usato per aggiornare le proprietà, ad esempio i valori Size, Sku, EnableNonSslPort e RedisConfiguration.The Set-AzureRmRedisCache cmdlet can be used to update properties such as Size, Sku, EnableNonSslPort, and the RedisConfiguration values.

Il comando seguente aggiorna maxmemory-policy per la Cache Redis denominata myCache.The following command updates the maxmemory-policy for the Redis Cache named myCache.

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

Ridimensionare una Cache RedisTo scale a Redis cache

Set-AzureRmRedisCache può essere usato per ridimensionare un'istanza della Cache Redis di Azure quando si modificano le proprietà Size, Sku o ShardCount.Set-AzureRmRedisCache can be used to scale an Azure Redis cache instance when the Size, Sku, or ShardCount properties are modified.

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.The following example shows how to scale a cache named myCache to a 2.5 GB cache. Si noti che questo comando funziona sia con una cache Basic che una cache Standard.Note that this command works for both a Basic or a Standard cache.

Set-AzureRmRedisCache -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-AzureRmRedisCache).After this command is issued, the status of the cache is returned (similar to calling Get-AzureRmRedisCache). Si noti che il ProvisioningState è Scaling.Note that the ProvisioningState is Scaling.

PS C:\> Set-AzureRmRedisCache -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.When the scaling operation is complete, the ProvisioningState changes to Succeeded. Se si vuole effettuare un'operazione di ridimensionamento successiva, 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.If you need to make a subsequent scaling operation, such as changing from Basic to Standard and then changing the size, you must wait until the previous operation is complete or you receive an error similar to the following.

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

Per ottenere informazioni su una Cache RedisTo get information about a Redis cache

È possibile recuperare informazioni su una cache con il cmdlet Get-AzureRmRedisCache .You can retrieve information about a cache using the Get-AzureRmRedisCache cmdlet.

Per visualizzare un elenco di parametri disponibili e le relative descrizioni per Get-AzureRmRedisCache, eseguire il comando seguente.To see a list of available parameters and their descriptions for Get-AzureRmRedisCache, run the following command.

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

NAME
    Get-AzureRmRedisCache

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

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

DESCRIPTION
    The Get-AzureRmRedisCache cmdlet gets the details about a cache or caches depending on input parameters. If both
    ResourceGroupName and Name parameters are provided then Get-AzureRmRedisCache 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-AzureRmRedisCache
        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-AzureRmRedisCache 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 (http://go.microsoft.com/fwlink/?LinkID=113216).

Per restituire informazioni su tutte le cache nella sottoscrizione corrente, eseguire Get-AzureRmRedisCache senza parametri.To return information about all caches in the current subscription, run Get-AzureRmRedisCache without any parameters.

Get-AzureRmRedisCache

Per restituire informazioni su tutte le cache in un gruppo di risorse specifico, eseguire Get-AzureRmRedisCache con il parametro ResourceGroupName.To return information about all caches in a specific resource group, run Get-AzureRmRedisCache with the ResourceGroupName parameter.

Get-AzureRmRedisCache -ResourceGroupName myGroup

Per restituire informazioni su una cache specifica, eseguire Get-AzureRmRedisCache con il parametro Name che contiene il nome della cache e il parametro ResourceGroupName con il gruppo di risorse che contiene tale cache.To return information about a specific cache, run Get-AzureRmRedisCache with the Name parameter containing the name of the cache, and the ResourceGroupName parameter with the resource group containing that cache.

PS C:\> Get-AzureRmRedisCache -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         :

Per recuperare le chiavi di accesso per una Cache RedisTo retrieve the access keys for a Redis cache

Per recuperare le chiavi di accesso per la cache, è possibile usare il cmdlet Get-AzureRmRedisCacheKey .To retrieve the access keys for your cache, you can use the Get-AzureRmRedisCacheKey cmdlet.

Per visualizzare un elenco di parametri disponibili e le relative descrizioni per Get-AzureRmRedisCacheKey, eseguire il comando seguente.To see a list of available parameters and their descriptions for Get-AzureRmRedisCacheKey, run the following command.

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

NAME
    Get-AzureRmRedisCacheKey

SYNOPSIS
    Gets the accesskeys for the specified redis cache.


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

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

PARAMETERS
    -Name <String>
        Name of the redis cache.

    -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 (http://go.microsoft.com/fwlink/?LinkID=113216).

Per recuperare le chiavi per la cache, chiamare il cmdlet Get-AzureRmRedisCacheKey e passare il nome della cache e il nome del gruppo di risorse che contiene la cache.To retrieve the keys for your cache, call the Get-AzureRmRedisCacheKey cmdlet and pass in the name of your cache the name of the resource group that contains the cache.

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

PrimaryKey   : b2wdt43sfetlju4hfbryfnregrd9wgIcc6IA3zAO1lY=
SecondaryKey : ABhfB757JgjIgt785JgKH9865eifmekfnn649303JKL=

Per rigenerare le chiavi di accesso per la Cache RedisTo regenerate access keys for your Redis cache

Per rigenerare le chiavi di accesso per la cache, è possibile usare il cmdlet New-AzureRmRedisCacheKey .To regenerate the access keys for your cache, you can use the New-AzureRmRedisCacheKey cmdlet.

Per visualizzare un elenco di parametri disponibili e le relative descrizioni per New-AzureRmRedisCacheKey, eseguire il comando seguente.To see a list of available parameters and their descriptions for New-AzureRmRedisCacheKey, run the following command.

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

NAME
    New-AzureRmRedisCacheKey

SYNOPSIS
    Regenerates the access key of a redis cache.

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

DESCRIPTION
    The New-AzureRmRedisCacheKey cmdlet regenerate the access key of a redis cache.

PARAMETERS
    -Name <String>
        Name of the redis cache.

    -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 (http://go.microsoft.com/fwlink/?LinkID=113216).

Per rigenerare la chiave primaria o secondaria per la cache, chiamare il cmdlet New-AzureRmRedisCacheKey e passare il nome e il gruppo di risorse, quindi specificare il parametro Primary o Secondary per il parametro KeyType.To regenerate the primary or secondary key for your cache, call the New-AzureRmRedisCacheKey cmdlet and pass in the name, resource group, and specify either Primary or Secondary for the KeyType parameter. Nell'esempio seguente viene rigenerata la chiave di accesso secondaria per una cache.In the following example, the secondary access key for a cache is regenerated.

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

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


PrimaryKey   : b2wdt43sfetlju4hfbryfnregrd9wgIcc6IA3zAO1lY=
SecondaryKey : c53hj3kh4jhHjPJk8l0jji785JgKH9865eifmekfnn6=

Per eliminare una Cache RedisTo delete a Redis cache

Per eliminare una cache Redis, usare il cmdlet Remove AzureRmRedisCache .To delete a Redis cache, use the Remove-AzureRmRedisCache cmdlet.

Per visualizzare un elenco di parametri disponibili e le relative descrizioni per Remove-AzureRmRedisCache, eseguire il comando seguente.To see a list of available parameters and their descriptions for Remove-AzureRmRedisCache, run the following command.

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

NAME
    Remove-AzureRmRedisCache

SYNOPSIS
    Remove redis cache if exists.

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

DESCRIPTION
    The Remove-AzureRmRedisCache cmdlet removes a redis cache if it exists.

PARAMETERS
    -Name <String>
        Name of the redis cache 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-AzureRmRedisCache removes the cache and does not return any value. If the PassThru par
        is provided then Remove-AzureRmRedisCache 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 (http://go.microsoft.com/fwlink/?LinkID=113216).

Nell'esempio seguente viene rimossa la cache denominata myCache .In the following example, the cache named myCache is removed.

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

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

Per importare una Cache RedisTo import a Redis cache

È possibile importare dati in un'istanza della Cache Redis di Azure usando il cmdlet Import-AzureRmRedisCache .You can import data into an Azure Redis Cache instance using the Import-AzureRmRedisCache cmdlet.

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-AzureRmRedisCache, eseguire il comando seguente.To see a list of available parameters and their descriptions for Import-AzureRmRedisCache, run the following command.

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

NAME
    Import-AzureRmRedisCache

SYNOPSIS
    Import data from blobs to Azure Redis Cache.


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


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


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-AzureRmRedisCache imports data in cache and does not return any value. If the PassThru
        parameter is provided then Import-AzureRmRedisCache 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 (http://go.microsoft.com/fwlink/?LinkID=113216).

Il comando seguente importa dati dal BLOB specificato dall'URI della firma di accesso condiviso nella Cache Redis di Azure.The following command imports data from the blob specified by the SAS uri into Azure Redis Cache.

PS C:\>Import-AzureRmRedisCache -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

Per esportare una Cache RedisTo export a Redis cache

È possibile esportare dati da un'istanza della Cache Redis di Azure usando il cmdlet Export-AzureRmRedisCache .You can export data from an Azure Redis Cache instance using the Export-AzureRmRedisCache cmdlet.

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-AzureRmRedisCache, eseguire il comando seguente.To see a list of available parameters and their descriptions for Export-AzureRmRedisCache, run the following command.

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

NAME
    Export-AzureRmRedisCache

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


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


DESCRIPTION
    The Export-AzureRmRedisCache cmdlet exports data from Azure Redis Cache 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-AzureRmRedisCache does not return any value. If the PassThru parameter is provided
        then Export-AzureRmRedisCache 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 (http://go.microsoft.com/fwlink/?LinkID=113216).

Il comando seguente esporta dati da un'istanza della Cache Redis di Azure al contenitore specificato dall'URI della firma di accesso condiviso.The following command exports data from an Azure Redis Cache instance into the container specified by the SAS uri.

    PS C:\>Export-AzureRmRedisCache -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"

Per riavviare una Cache RedisTo reboot a Redis cache

È possibile riavviare un'istanza della Cache Redis di Azure usando il cmdlet Reset-AzureRmRedisCache .You can reboot your Azure Redis Cache instance using the Reset-AzureRmRedisCache cmdlet.

Importante

La funzionalità di riavvio è disponibile solo per le cache del piano 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-AzureRmRedisCache, eseguire il comando seguente.To see a list of available parameters and their descriptions for Reset-AzureRmRedisCache, run the following command.

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

NAME
    Reset-AzureRmRedisCache

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


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


DESCRIPTION
    The Reset-AzureRmRedisCache cmdlet reboots the specified node(s) of an Azure Redis Cache 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-AzureRmRedisCache does not return any value. If the PassThru parameter is provided
        then Reset-AzureRmRedisCache 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 (http://go.microsoft.com/fwlink/?LinkID=113216).

Il comando seguente riavvia entrambi i nodi della cache specificata.The following command reboots both nodes of the specified cache.

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

Passaggi successiviNext steps

Per ulteriori informazioni sull'utilizzo di Windows PowerShell con Azure, vedere le risorse seguenti:To learn more about using Windows PowerShell with Azure, see the following resources: