Lire en anglais

Partager via

New-AzSqlElasticPool

  • Référence
Module:
Az.Sql

Crée un pool de bases de données élastique pour une base de données SQL.

Syntaxe

PowerShell 
New-AzSqlElasticPool
   [-ElasticPoolName] <String>
   [-Edition <String>]
   [-Dtu <Int32>]
   [-StorageMB <Int32>]
   [-DatabaseDtuMin <Int32>]
   [-DatabaseDtuMax <Int32>]
   [-Tags <Hashtable>]
   [-ZoneRedundant]
   [-LicenseType <String>]
   [-MaintenanceConfigurationId <String>]
   [-HighAvailabilityReplicaCount <Int32>]
   [-PreferredEnclaveType <String>]
   [-AsJob]
   [-ServerName] <String>
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
PowerShell 
New-AzSqlElasticPool
   [-ElasticPoolName] <String>
   -Edition <String>
   [-StorageMB <Int32>]
   -VCore <Int32>
   -ComputeGeneration <String>
   [-DatabaseVCoreMin <Double>]
   [-DatabaseVCoreMax <Double>]
   [-Tags <Hashtable>]
   [-ZoneRedundant]
   [-LicenseType <String>]
   [-MaintenanceConfigurationId <String>]
   [-HighAvailabilityReplicaCount <Int32>]
   [-PreferredEnclaveType <String>]
   [-AsJob]
   [-ServerName] <String>
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

La cmdlet New-AzSqlElasticPool crée un pool de bases de données élastique pour une base de données Azure SQL Database. Plusieurs paramètres (-Dtu, -DatabaseDtuMin et -DatabaseDtuMax) nécessitent que la valeur définie provient de la liste des valeurs valides pour ce paramètre. Par exemple, -DatabaseDtuMax pour un pool d’eDTU Standard 100 ne peut être défini que sur 10, 20, 50 ou 100. Pour plus d’informations sur les valeurs valides, consultez le tableau de votre pool de tailles spécifique dans pools élastiques.

Exemples

Exemple 1 : Créer un pool élastique DTU

PowerShell 
New-AzSqlElasticPool -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -ElasticPoolName "ElasticPool01" -Edition "Standard" -Dtu 400 -DatabaseDtuMin 10 -DatabaseDtuMax 100

ResourceId        : /subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/resourcegroup01/providers/Microsoft.Sql/servers/server01/elasticPools/elasticpool01
ResourceGroupName : resourcegroup01
ServerName        : server01
ElasticPoolName   : elasticpool01
Location          : Central US
CreationDate      : 8/26/2015 10:00:17 PM
State             : Ready
Edition           : Standard
Dtu               : 400
DatabaseDtuMax    : 100
DatabaseDtuMin    : 10
StorageMB         : 409600
Tags              :

Cette commande crée un pool élastique dans le niveau de service Standard nommé ElasticPool01. Le serveur nommé server01, affecté à un groupe de ressources Azure nommé ResourceGroup01, héberge le pool élastique dans. La commande spécifie les valeurs de propriété DTU pour le pool et les bases de données du pool.

Exemple 2 : Créer un pool élastique vCore

PowerShell 
New-AzSqlElasticPool -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -ElasticPoolName "ElasticPool01" -Edition "GeneralPurpose" -vCore 2 -ComputeGeneration Gen5

ResourceId          : /subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/ResourceGroup01/providers/Microsoft.Sql/servers/server01/elasticPools/ElasticPool01
ResourceGroupName   : ResourceGroup01
ServerName          : Server01
ElasticPoolName     : ElasticPool01
Location            : Central US
CreationDate        : 8/29/2019 2:16:40 AM
State               : Ready
Edition             : GeneralPurpose
SkuName             : GP_Gen5
Dtu                 : 2
DatabaseDtuMax      : 2
DatabaseDtuMin      : 0
Capacity            : 2
DatabaseCapacityMin : 0
DatabaseCapacityMax : 2
Family              : Gen5
MaxSizeBytes        : 34359738368
StorageMB           : 32768
Tags                :

Cette commande crée un pool élastique dans le niveau de service GengeralPurpose nommé ElasticPool01. Le serveur nommé server01, affecté à un groupe de ressources Azure nommé ResourceGroup01, héberge le pool élastique dans. La commande spécifie les valeurs de propriété vCore pour le pool et les bases de données du pool.

Exemple 3

Crée un pool de bases de données élastique pour une base de données SQL. (généré automatiquement)

PowerShell 
New-AzSqlElasticPool -ComputeGeneration Gen5 -Edition 'GeneralPurpose' -ElasticPoolName 'ElasticPool01' -ResourceGroupName 'ResourceGroup01' -ServerName 'Server01' -StorageMB 2097152 -VCore 2

Exemple 4 : Crée un pool élastique avec un type d’enclave préféré en tant que VBS

PowerShell 
New-AzSqlElasticPool -ComputeGeneration Gen5 -Edition 'GeneralPurpose' -ElasticPoolName 'ElasticPool01' -ResourceGroupName 'ResourceGroup01' -ServerName 'Server01' -VCore 2 -PreferredEnclaveType 'VBS'

ResourceId          : /subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/ResourceGroup01/providers/Microsoft.Sql/servers/server01/elasticPools/ElasticPool01
ResourceGroupName   : ResourceGroup01
ServerName          : Server01
ElasticPoolName     : ElasticPool01
Location            : Central US
CreationDate        : 8/29/2019 2:16:40 AM
State               : Ready
Edition             : GeneralPurpose
SkuName             : GP_Gen5
Dtu                 : 2
DatabaseDtuMax      : 2
DatabaseDtuMin      : 0
Capacity            : 2
DatabaseCapacityMin : 0
DatabaseCapacityMax : 2
Family              : Gen5
MaxSizeBytes        : 34359738368
StorageMB           : 32768
PreferredEnclaveType: VBS
Tags                :

Cette commande crée un pool élastique configuré avec l’enclave VBS

Paramètres

-AsJob

Exécuter l’applet de commande en arrière-plan

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ComputeGeneration

Génération de calcul à affecter.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DatabaseDtuMax

Spécifie le nombre maximal d’unités de débit de base de données (DTU) que toute base de données unique du pool peut consommer. Les valeurs par défaut des différentes éditions sont les suivantes :

  • Basique. 5 DTU
  • Standard. 100 DTU
  • Prime. 125 DTU Pour plus d’informations sur les valeurs valides, consultez le tableau de votre pool de tailles spécifique dans pools élastiques
Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DatabaseDtuMin

Spécifie le nombre minimal de DTU que le pool élastique garantit à toutes les bases de données du pool. La valeur par défaut est zéro (0). Pour plus d’informations sur les valeurs valides, consultez le tableau de votre pool de tailles spécifique dans pools élastiques.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DatabaseVCoreMax

Nombre maximal de VCores que sqlAzure Database peut consommer dans le pool.

Type:Double
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DatabaseVCoreMin

Nombre VCore minimal que sqlAzure Database peut consommer dans le pool.

Type:Double
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure

Type:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Dtu

Spécifie le nombre total de DTU partagés pour le pool élastique. Les valeurs par défaut des différentes éditions sont les suivantes :

  • Basique. 100 DTU
  • Standard. 100 DTU
  • Prime. 125 DTU Pour plus d’informations sur les valeurs valides, consultez le tableau de votre pool de tailles spécifique dans pools élastiques.
Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Edition

Spécifie l’édition d’Azure SQL Database utilisée pour le pool élastique. Les valeurs acceptables pour ce paramètre sont les suivantes :

  • Aucun
  • Basique
  • Standard
  • Prime
  • DataWarehouse
  • Libre
  • Étirer
  • GeneralPurpose
  • BusinessCritical
Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ElasticPoolName

Spécifie le nom du pool élastique créé par cette applet de commande.

Type:String
Alias:Name
Position:2
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-HighAvailabilityReplicaCount

Nombre total de réplicas à haute disponibilité associés au pool élastique.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-LicenseType

Type de licence pour la base de données Azure Sql.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MaintenanceConfigurationId

ID de configuration de maintenance pour le pool élastique SQL.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PreferredEnclaveType

Type d’enclave préféré pour le pool élastique Azure SQL. Les valeurs possibles sont Default et VBS.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ResourceGroupName

Spécifie le nom du groupe de ressources auquel cette applet de commande affecte le pool élastique.

Type:String
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ServerName

Spécifie le nom du serveur qui héberge le pool élastique.

Type:String
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-StorageMB

Spécifie la limite de stockage, en mégaoctets, pour le pool élastique. Si vous ne spécifiez pas ce paramètre, cette applet de commande calcule une valeur qui dépend de la valeur du paramètre Dtu. Consultez limites d’eDTU et de stockage pour connaître les valeurs possibles.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Tags

Spécifie un dictionnaire de paires clé-valeur sous la forme d’une table de hachage que cette applet de commande associe au pool élastique. Par exemple : @{key0="value0 » ; key1=$null ; key2="value2"}

Type:Hashtable
Alias:Tag
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-VCore

Nombre total de Vcores partagés pour le pool élastique Sql Azure.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ZoneRedundant

Redondance de zone à associer au pool élastique Azure Sql

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

Sorties