Partager via

New-AzSqlElasticPool

Module:
Az.Sql Module

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

Syntaxe

DtuBasedPool (Par défaut) 

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

VcoreBasedPool 

New-AzSqlElasticPool
    [-ElasticPoolName] <String>
    [-ServerName] <String>
    [-ResourceGroupName] <String>
    -Edition <String>
    -VCore <Int32>
    -ComputeGeneration <String>
    [-StorageMB <Int32>]
    [-DatabaseVCoreMin <Double>]
    [-DatabaseVCoreMax <Double>]
    [-Tags <Hashtable>]
    [-ZoneRedundant]
    [-LicenseType <String>]
    [-MaintenanceConfigurationId <String>]
    [-HighAvailabilityReplicaCount <Int32>]
    [-PreferredEnclaveType <String>]
    [-AsJob]
    [-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 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 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 GeneralPurpose 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. (autogenerated)

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

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ComputeGeneration

Génération de calcul à affecter.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

VcoreBasedPool
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Confirm

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

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False
Alias:cf

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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
  • Norme. 100 DTU
  • Prime. 125 DTU Pour plus d’informations sur les valeurs valides, consultez le tableau de votre pool de tailles spécifique dans les pools élastiques

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

DtuBasedPool
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

DtuBasedPool
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DatabaseVCoreMax

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

Propriétés du paramètre

Type:Double
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

VcoreBasedPool
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DatabaseVCoreMin

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

Propriétés du paramètre

Type:Double
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

VcoreBasedPool
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DefaultProfile

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

Propriétés du paramètre

Type:IAzureContextContainer
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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
  • Norme. 100 DTU
  • Prime. 125 DTU Pour plus d’informations sur les valeurs valides, consultez le tableau de votre pool de tailles spécifique dans les pools élastiques.

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

DtuBasedPool
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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
  • Élémentaire
  • Norme
  • Premium
  • DataWarehouse
  • Libre
  • Échelle
  • Usage Général
  • Critique pour l’entreprise

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

DtuBasedPool
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ElasticPoolName

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Nom

Jeux de paramètres

(All)
Position:2
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-HighAvailabilityReplicaCount

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

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-LicenseType

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-MaintenanceConfigurationId

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-PreferredEnclaveType

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ResourceGroupName

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-ServerName

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:1
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants: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 les limites d’eDTU et de stockage pour connaître les valeurs possibles.

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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"}

Propriétés du paramètre

Type:Hashtable
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Tag

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-VCore

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

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

VcoreBasedPool
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False
Alias:Wi

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ZoneRedundant

Redondance de zone à associer au pool élastique Azure Sql

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

String

Sorties

AzureSqlElasticPoolModel