New-AzRedisCache

  • Riferimento
Modulo:
Az.RedisCache

Crea una cache Redis.

Sintassi

New-AzRedisCache
   -ResourceGroupName <String>
   -Name <String>
   -Location <String>
   [-Size <String>]
   [-Sku <String>]
   [-RedisConfiguration <Hashtable>]
   [-EnableNonSslPort <Boolean>]
   [-TenantSettings <Hashtable>]
   [-ShardCount <Int32>]
   [-MinimumTlsVersion <String>]
   [-SubnetId <String>]
   [-StaticIP <String>]
   [-Tag <Hashtable>]
   [-Zone <String[]>]
   [-RedisVersion <String>]
   [-UpdateChannel <String>]
   [-IdentityType <String>]
   [-UserAssignedIdentity <String[]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Il cmdlet New-AzRedisCache crea una cache Redis di Azure.

Esempio

Esempio 1: Creare una cache Redis

New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "North Central US"

PrimaryKey         : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          SecondaryKey       : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          ResourceGroupName  : MyGroup
          Id                 : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/mycache
          Location           : North Central US
          Name               : MyCache
          Type               : Microsoft.Cache/Redis
          HostName           : mycache.redis.cache.windows.net
          Port               : 6379
          ProvisioningState  : creating
          SslPort            : 6380
          RedisConfiguration : {}
          EnableNonSslPort   : False
          RedisVersion       : 2.8
          Size               : 1GB
          Sku                : Standard
          Tag                : {}
          Zone               : []

Questo comando crea una cache Redis.

Esempio 2: Creare una cache Redis SKU Standard

New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "North Central US" -Size 250MB -Sku "Standard" -RedisConfiguration @{"maxmemory-policy" = "allkeys-random"}

PrimaryKey         : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          SecondaryKey       : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          ResourceGroupName  : MyGroup
          Id                 : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/MyCache
          Location           : North Central US
          Name               : mycache
          Type               : Microsoft.Cache/Redis
          HostName           : mycache.redis.cache.windows.net
          Port               : 6379
          ProvisioningState  : creating
          SslPort            : 6380
          RedisConfiguration : {[maxmemory-policy, allkeys-random]}
          EnableNonSslPort   : False
          RedisVersion       : 2.8
          Size               : 250MB
          Sku                : Standard
          Tag                : {}
          Zone               : []

Questo cmdlet crea una cache usando cache di Azure per Redis.

Esempio 3: Creare una cache con ridondanza della zona

New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "Central US" -Size P1 -Sku "Premium" -Zone @("1","2")

PrimaryKey         : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          SecondaryKey       : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          ResourceGroupName  : MyGroup
          Id                 : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/MyCache
          Location           : Central US
          Name               : mycache
          Type               : Microsoft.Cache/Redis
          HostName           : mycache.redis.cache.windows.net
          Port               : 6379
          ProvisioningState  : creating
          SslPort            : 6380
          RedisConfiguration : {[maxmemory-policy, allkeys-random], [maxclients, 7500], [maxmemory-reserved, 200],
                                [maxfragmentationmemory-reserved, 300]...}
          EnableNonSslPort   : False
          RedisVersion       : 4.0.14
          Size               : 6GB
          Sku                : Premium
          Tag                : {}
          Zone               : {1, 2}

Questo comando crea un'istanza di Cache Redis di Azure nelle zone di mutliple.

Esempio 4: Creare un Rete virtuale abilitare cache

Requisiti per la creazione di Rete virtuale abilitare la cache.

  1. Creare la rete virtuale nello stesso gruppo di risorse in cui si vuole creare la cache Redis. È possibile creare una rete virtuale dal comando PowerShell New-AzVirtualNetwork .
  2. Per abilitare la cache sarà necessario subnetID per la rete virtuale. Di seguito è riportata la sintassi di SubnetID.

Formato di SubnetID: /subscriptions/{subid}/resourceGroups/{resourceGroupName}/providers/Microsoft.ClassicNetwork/VirtualNetworks/{vnetName}/subnets/{subnetName}

New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "Central US" -Size P1 -Sku "Premium" -SubnetId "/subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Network/virtualNetworks/MyNet/subnets/MySubnet"

PrimaryKey         : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          SecondaryKey       : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          ResourceGroupName  : MyGroup
          Id                 : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/MyCache
          Location           : Central US
          Name               : mycache
          Type               : Microsoft.Cache/Redis
          HostName           : mycache.redis.cache.windows.net
          Port               : 6379
          ProvisioningState  : creating
          SslPort            : 6380
          RedisConfiguration : {[maxmemory-policy, allkeys-random], [maxclients, 7500], [maxmemory-reserved, 200],
                                [maxfragmentationmemory-reserved, 300]...}
          EnableNonSslPort   : False
          RedisVersion       : 4.0.14
          Size               : 6GB
          Sku                : Premium
          SubnetId           : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Network/virtualNetworks/MyNet/subnets/MySubnet
          StaticIP           : 10.0.0.4
          Tag                : {}
          Zone               : []

Esempio 5: Configurare la persistenza dei dati per un cache di Azure per Redis Premium

La persistenza scrive i dati di Redis in un account Archiviazione di Azure di cui si è proprietari e gestiti. Quindi, prima di configurare la persistenza dei dati, è necessario avere un account di archiviazione nello stesso gruppo di risorse. Scegliere un account di archiviazione nella stessa area e nella stessa sottoscrizione della cache e un account di Archiviazione Premium è consigliato perché l'archiviazione Premium ha una velocità effettiva maggiore.

Dopo aver creato un account di archiviazione, ottenere l'account di archiviazione stringa di connessione usando questa procedura.

  1. Eseguire questo comando Get-Az Archiviazione AccountKey -ResourceGroupName $resourceGroupName -Name $storageAccountName in PowerShell.
  2. Nell'output precedente copiare qualsiasi chiave.
  3. Inserire la chiave dell'account di archiviazione e il nome dell'account di archiviazione nel formato seguente per ottenere il stringa di connessione dell'account di archiviazione.

Connessione ion String Format :- "DefaultEndpointsProtocol=https; AccountName={storageAccountName}; AccountKey={storageAccountKey}; EndpointSuffix=mySuffix"

Per abilitare la persistenza dei dati, è necessario disporre delle impostazioni di configurazione di Redis specifiche.

Per abilitare il backup RDB

  • rdb-backup-enabled (Impostare true o false)
  • rdb-storage-connection-string (assegnare stringa di connessione nel formato precedente).
  • rdb-backup-frequency (impostare un intervallo di backup in minuti. È possibile scegliere tra - 15, 30, 60, 360, 720 e 1440 minuti.
New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "Central US" -Size P1 -Sku "Premium" -RedisConfiguration @{"rdb-backup-enabled" = "true"; "rdb-storage-connection-string" = "DefaultEndpointsProtocol=https;AccountName=mystorageaccount;AccountKey=pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=;EndpointSuffix=mySuffix"; "rdb-backup-frequency" = "30"}

PrimaryKey         : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          SecondaryKey       : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          ResourceGroupName  : MyGroup
          Id                 : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/MyCache
          Location           : Central US
          Name               : mycache
          Type               : Microsoft.Cache/Redis
          HostName           : mycache.redis.cache.windows.net
          Port               : 6379
          ProvisioningState  : creating
          SslPort            : 6380
          RedisConfiguration : {[maxmemory-policy, allkeys-random], [maxclients, 7500], [maxmemory-reserved, 200],
                                [maxfragmentationmemory-reserved, 300], [rdb-backup-enabled, true]....}
          EnableNonSslPort   : False
          RedisVersion       : 4.0.14
          Size               : 6GB
          Sku                : Premium
          Tag                : {}
          Zone               : []

Esempio 6: Configurare la persistenza dei dati per un cache di Azure per Redis Premium - Backup AOF abilitato

Per il backup AOF abilitato.

  • aof-backup-enabled (Impostare true o false),
  • aof-storage-connection-string-0 (assegnare stringa di connessione in formato precedente).
  • aof-storage-connection-string-1 (facoltativamente è possibile configurare un altro account di archiviazione. Se è configurato un secondo account di archiviazione, le scritture nella cache di replica vengono scritte in questo secondo account di archiviazione.
New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "Central US" -Size P1 -Sku "Premium" -RedisConfiguration @{"aof-backup-enabled" = "true"; "aof-storage-connection-string-0" = "DefaultEndpointsProtocol=https;AccountName=mystorageaccount;AccountKey=pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=;EndpointSuffix=mySuffix"}

PrimaryKey         : pJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          SecondaryKey       : sJ+jruGKPHDKsEC8kmoybobH3TZx2njBR3ipEsquZFo=
          ResourceGroupName  : MyGroup
          Id                 : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/MyCache
          Location           : Central US
          Name               : mycache
          Type               : Microsoft.Cache/Redis
          HostName           : mycache.redis.cache.windows.net
          Port               : 6379
          ProvisioningState  : creating
          SslPort            : 6380
          RedisConfiguration : {[maxmemory-policy, allkeys-random], [maxclients, 7500], [maxmemory-reserved, 200],
                                [maxfragmentationmemory-reserved, 300], [aof-backup-enabled, true]...}
          EnableNonSslPort   : False
          RedisVersion       : 4.0.14
          Size               : 6GB
          Sku                : Premium
          Tag                : {}
          Zone               : []

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableNonSslPort

Indica se la porta non SSL è abilitata. Il valore predefinito è $False (la porta non SSL è disabilitata).

Type:Nullable<T>[Boolean]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-IdentityType

Specifica il tipo di identità utilizzata per il cache di Azure per Redis. Valori validi: "SystemAssigned" o "UserAssigned" o "SystemAssignedUserAssigned" o "Nessuno"

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Location

Specifica il percorso in cui creare una cache Redis. I valori validi sono:

  • Stati Uniti centro-settentrionali
  • Stati Uniti centro-meridionali
  • Stati Uniti centrali
  • Europa occidentale
  • Europa settentrionale
  • Stati Uniti occidentali
  • Stati Uniti orientali
  • Stati Uniti orientali 2
  • Giappone orientale
  • Giappone occidentale
  • Brasile meridionale
  • Asia sud-orientale
  • Asia orientale
  • Australia orientale
  • Australia sud-orientale
Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-MinimumTlsVersion

Specificare la versione TLS richiesta dai client per connettersi alla cache.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

Specifica il nome della cache Redis da creare.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-RedisConfiguration

Specifica le impostazioni di configurazione di Redis. I valori validi per questo parametro sono:

  • rdb-backup-enabled. Specifica che la persistenza dei dati Redis è abilitata. Solo livello Premium.
  • rdb-storage-connection-string. Specifica il stringa di connessione all'account Archiviazione per la persistenza dei dati Redis. Solo livello Premium.
  • rdb-backup-frequency. Specifica la frequenza di backup per la persistenza dei dati Redis. Solo livello Premium.
  • maxmemory-reserved. Configura la memoria riservata per i processi non della cache. Livelli Standard e Premium.
  • maxmemory-policy. Configura i criteri di rimozione per la cache. Tutti i piani tariffari.
  • notify-keyspace-events. Configura le notifiche keyspace. Livelli Standard e Premium.
  • hash-max-ziplist-entries. Configura l'ottimizzazione della memoria per i tipi di dati aggregati di piccole dimensioni. Livelli Standard e Premium.
  • hash-max-ziplist-value. Configura l'ottimizzazione della memoria per i tipi di dati aggregati di piccole dimensioni. Livelli Standard e Premium.
  • set-max-intset-entries. Configura l'ottimizzazione della memoria per i tipi di dati aggregati di piccole dimensioni. Livelli Standard e Premium.
  • zset-max-ziplist-entries. Configura l'ottimizzazione della memoria per i tipi di dati aggregati di piccole dimensioni. Livelli Standard e Premium.
  • zset-max-ziplist-value. Configura l'ottimizzazione della memoria per i tipi di dati aggregati di piccole dimensioni. Livelli Standard e Premium.
  • database. Configura il numero di database. Questa proprietà può essere configurata solo durante la creazione della cache. Livelli Standard e Premium. Per altre informazioni, vedere Gestire Cache Redis di Azure con Azure PowerShellhttp://go.microsoft.com/fwlink/?LinkId=800051 (http://go.microsoft.com/fwlink/?LinkId=800051).
  • preferred-data-archive-auth-method Metodo di autenticazione preferito per comunicare con l'account di archiviazione usato per l'archivio dati, specificare firma di accesso condiviso o ManagedIdentity. Il valore predefinito è SAS
  • preferred-data-persistence-auth-method Metodo di autenticazione preferito per comunicare con l'account di archiviazione usato per la persistenza dei dati, specificare firma di accesso condiviso o ManagedIdentity, il valore predefinito è SAS
Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-RedisVersion

Versione di Redis. Deve essere nel formato 'major[.minor]' (è necessario solo 'major' ) o il valore 'latest' che fa riferimento alla versione stabile più recente di Redis disponibile. Versioni supportate: 4.0, 6.0 (versione più recente). Il valore predefinito è 'latest'.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

Specifica il nome del gruppo di risorse in cui creare la cache Redis.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ShardCount

Specifica il numero di partizioni da creare in una cache del cluster Premium. I valori validi per questo parametro sono:

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Size

Specifica le dimensioni della cache Redis. I valori validi sono:

  • P1
  • P2
  • P3
  • P4
  • P5
  • C0
  • C1
  • S2
  • C3
  • C4
  • C5
  • C6
  • 250 MB
  • 1 GB
  • 2,5 GB
  • 6 GB
  • 13 GB
  • 26 GB
  • 53 GB Il valore predefinito è 1GB o C1.
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Sku

Specifica lo SKU della cache Redis da creare. I valori validi sono:

  • Basic
  • Standard
  • Premium Il valore predefinito è Standard.
Type:String
Accepted values:Basic, Standard, Premium
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-StaticIP

Specifica un indirizzo IP univoco nella subnet per cache Redis. Se non si specifica un valore per questo parametro, questo cmdlet sceglie un indirizzo IP dalla subnet.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-SubnetId

ID risorsa completo di una subnet in una rete virtuale in cui distribuire il cache di Azure per Redis. Formato di esempio: /subscriptions/{subid}/resourceGroups/{resourceGroupName}/Microsoft. {Network|ClassicNetwork}/VirtualNetworks/{vnetName}/subnets/{subnetName}

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Tag

Tabella hash che rappresenta i tag.

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-TenantSettings

Questo parametro è stato deprecato.

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-UpdateChannel

Facoltativo: specifica il canale di aggiornamento per gli aggiornamenti mensili di Redis che la cache Redis riceverà. Le cache che usano il canale di aggiornamento 'Anteprima' ottengono gli aggiornamenti di Redis più recenti almeno 4 settimane prima delle cache dei canali 'Stable'. Il valore predefinito è 'Stable'. I valori possibili includono: 'Stable', 'Preview'

Type:String
Position:Named
Default value:Stable
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-UserAssignedIdentity

Specifica una o più identità utente delimitati da virgole da associare alla cache di Azure per Redis. I riferimenti all'identità utente saranno id risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identities/{identityName}'

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Zone

Elenco di aree di Azure con zone di disponibilità.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Input

String

Hashtable

Nullable<T>[[System.Boolean, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

Nullable<T>[[System.Int32, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

String[]

Output

RedisCacheAttributesWithAccessKeys