Set-AzSqlElasticPool

  • Référence
Module:
Az.Sql

Modifie les propriétés d’un pool de bases de données élastique dans Azure SQL Database.

Syntaxe

Set-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>]
Set-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 Set-AzSqlElasticPool définit les propriétés d’un pool élastique dans Azure SQL Database. Cette applet de commande peut modifier les eDTU par pool (Dtu), la taille maximale de stockage par pool (StorageMB), le nombre maximal d’eDTU par base de données (DatabaseDtuMax) et le nombre minimal d’eDTU par base de données (DatabaseDtuMin). 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 : Modifier les propriétés d’un pool élastique

Set-AzSqlElasticPool -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -ElasticPoolName "ElasticPool01" -Dtu 1000 -DatabaseDtuMax 100 -DatabaseDtuMin 20

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               : 200
DatabaseDtuMax    : 100
DatabaseDtuMin    : 20
StorageMB         : 204800
Tags              :

Cette commande modifie les propriétés d’un pool élastique nommé elasticpool01. La commande définit le nombre de DTU pour le pool élastique sur 1 000 et définit les DTU minimales et maximales.

Exemple 2 : Modifier la taille maximale de stockage d’un pool élastique

Set-AzSqlElasticPool -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -ElasticPoolName "ElasticPool01" -StorageMB 2097152

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           : Premium
Dtu               : 200
DatabaseDtuMax    : 100
DatabaseDtuMin    : 20
StorageMB         : 2097152
Tags              :

Cette commande modifie les propriétés d’un pool élastique nommé elasticpool01. La commande définit le stockage maximal d’un pool élastique sur 2 To.

Exemple 3

Modifie les propriétés d’un pool de bases de données élastique dans Azure SQL Database. (généré automatiquement)

Set-AzSqlElasticPool -Dtu 1000 -Edition 'GeneralPurpose' -ElasticPoolName 'ElasticPool01' -ResourceGroupName 'ResourceGroup01' -ServerName 'Server01'

Exemple 4 : Modifier le type d’enclave préféré d’un pool élastique en VBS

Set-AzSqlElasticPool -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -ElasticPoolName "ElasticPool01" -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/26/2015 10:00:17 PM
State                 : Ready
Edition               : Premium
Dtu                   : 200
DatabaseDtuMax        : 100
DatabaseDtuMin        : 20
StorageMB             : 2097152
PreferredEnclaveType  : VBS
Tags                  :

Cette commande met à jour un pool élastique pour configurer l’enclave VBS sur celle-ci

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
Alias:Family
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Confirm

Vous demande une confirmation avant d’exécuter la commande cmdlet.

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 de DTU que toute base de données unique du pool peut consommer. Pour plus d’informations sur les valeurs valides, consultez le tableau de votre pool de tailles spécifique dans les pools élastiques. Les valeurs par défaut pour différentes éditions sont les suivantes :

  • De base. 5 DTU
  • Standard. 100 DTU
  • Premium. 125 DTU
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. Pour plus d’informations sur les valeurs valides, consultez le tableau de votre pool de tailles spécifique dans les pools élastiques. La valeur par défaut est zéro (0).

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. Pour plus d’informations sur les valeurs valides, consultez le tableau de votre pool de tailles spécifique dans les pools élastiques. Les valeurs par défaut pour différentes éditions sont les suivantes :

  • De base. 100 DTU
  • Standard. 100 DTU
  • Premium. 125 DTU
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 pour le pool élastique. Vous ne pouvez pas modifier l’édition. Les valeurs valides pour ce paramètre sont :

  • Aucune
  • De base
  • standard
  • Premium
  • DataWarehouse
  • Gratuit
  • Étirer
  • GeneralPurpose
  • BusinessCritical
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

-ElasticPoolName

Spécifie le nom du pool élastique.

Type:String
Alias:Name
Position:2
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
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 le pool élastique est affecté.

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. Pour plus d’informations, consultez l’applet de commande New-AzSqlElasticPool.

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 que cette applet de commande associe au pool élastique sous la forme d’une table de hachage. Par exemple : @{key0="value0";"key 1"=$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:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
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

String

Sorties

AzureSqlElasticPoolModel