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>]
   [-DisableAccessKeyAuthentication <Boolean>]
   [-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         : ******
          SecondaryKey       : ******
          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         : ******
          SecondaryKey       : ******
          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         : ******
          SecondaryKey       : ******
          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.

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 .
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         : ******
          SecondaryKey       : ******
          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.

Eseguire questo comando Get-AzStorageAccountKey -ResourceGroupName $resourceGroupName -Name $storageAccountName in PowerShell.
Nell'output precedente copiare qualsiasi chiave.
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.

Formato stringa di connessione :- "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=******;EndpointSuffix=mySuffix"; "rdb-backup-frequency" = "30"}

PrimaryKey         : ******
          SecondaryKey       : ******
          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=******;EndpointSuffix=mySuffix"}

PrimaryKey         : ******
          SecondaryKey       : ******
          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.

Tipo:	SwitchParameter
Alias:	cf
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-DefaultProfile

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

Tipo:	IAzureContextContainer
Alias:	AzContext, AzureRmContext, AzureCredential
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-DisableAccessKeyAuthentication

Facoltativo: l'autenticazione a Redis tramite chiavi di accesso è disabilitata se impostata su true. Il valore predefinito è false.

Tipo:	String
Posizione:	Named
Valore predefinito:	false
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-EnableNonSslPort

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

Tipo:	Nullable<T>[Boolean]
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-IdentityType

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

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	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

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-MinimumTlsVersion

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

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-Name

Specifica il nome della cache Redis da creare.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	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 di 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

Tipo:	Hashtable
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	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'.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-ResourceGroupName

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

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-ShardCount

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

Tipo:	Nullable<T>[Int32]
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	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.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-Sku

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

Di base
Standard
Premium Il valore predefinito è Standard.

Tipo:	String
Valori accettati:	Basic, Standard, Premium
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	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.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	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}

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-Tag

Tabella hash che rappresenta i tag.

Tipo:	Hashtable
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-TenantSettings

Questo parametro è stato deprecato.

Tipo:	Hashtable
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	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'

Tipo:	String
Posizione:	Named
Valore predefinito:	Stable
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	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}'

Tipo:	String[]
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-WhatIf

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

Tipo:	SwitchParameter
Alias:	wi
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Zone

Elenco di aree di Azure con zone di disponibilità.

Tipo:	String[]
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	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

Condividi tramite

New-AzRedisCache

Sintassi

Descrizione

Esempio

Esempio 1: Creare una cache Redis

Esempio 2: Creare una cache Redis SKU Standard

Esempio 3: Creare una cache con ridondanza della zona

Esempio 4: Creare un Rete virtuale abilitare cache

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

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

Parametri

-Confirm

-DefaultProfile

-DisableAccessKeyAuthentication

-EnableNonSslPort

-IdentityType

-Location

-MinimumTlsVersion

-Name

-RedisConfiguration

-RedisVersion

-ResourceGroupName

-ShardCount

-Size

-Sku

-StaticIP

-SubnetId

-Tag

-TenantSettings

-UpdateChannel

-UserAssignedIdentity

-WhatIf

-Zone

Input

Output

Risorse aggiuntive

Condividi tramite

New-AzRedisCache

Sintassi

Descrizione

Esempio

Esempio 1: Creare una cache Redis

Esempio 2: Creare una cache Redis SKU Standard

Esempio 3: Creare una cache con ridondanza della zona

Esempio 4: Creare un Rete virtuale abilitare cache

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

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

Parametri

-Confirm

-DefaultProfile

-DisableAccessKeyAuthentication

-EnableNonSslPort

-IdentityType

-Location

-MinimumTlsVersion

-Name

-RedisConfiguration

-RedisVersion

-ResourceGroupName

-ShardCount

-Size

-Sku

-StaticIP

-SubnetId

-Tag

-TenantSettings

-UpdateChannel

-UserAssignedIdentity

-WhatIf

-Zone

Input

Output

Collegamenti correlati

Risorse aggiuntive