New-AzSqlElasticPool

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

Syntax

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>]
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

L’applet de commande 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 standard 100 eDTU 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 les pools élastiques.

Exemples

Exemple 1 : Créer un pool élastique DTU

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

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)

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

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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ComputeGeneration

Génération de calcul à affecter.

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

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 :

  • De base. 5 DTU
  • Standard. 100 DTU
  • Premium. 125 DTU Pour plus d’informations sur les valeurs valides, consultez le tableau de votre pool de tailles spécifique dans les pools élastiques
Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 les pools élastiques.

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

-DatabaseVCoreMax

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

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

-DatabaseVCoreMin

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

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

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 :

  • De base. 100 DTU
  • Standard. 100 DTU
  • Premium. 125 DTU Pour plus d’informations sur les valeurs valides, consultez le tableau de votre pool de tailles spécifique dans les pools élastiques.
Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Edition

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

  • Aucun
  • De base
  • standard
  • Premium
  • Datawarehouse
  • Gratuit
  • Étirer
  • GeneralPurpose
  • BusinessCritical
Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ElasticPoolName

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

Type:String
Aliases:Name
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-HighAvailabilityReplicaCount

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

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

-LicenseType

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

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

-MaintenanceConfigurationId

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

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

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

-ServerName

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

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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 la section Limites relatives aux eDTU et au stockage pour connaître les valeurs acceptées.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Aliases:Tag
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VCore

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

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

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

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

-ZoneRedundant

Redondance de zone à associer au pool élastique Azure Sql

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

Entrées

String

Sorties

AzureSqlElasticPoolModel