Partager via


Set-AzSqlElasticPool

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

Syntaxe

DtuBasedPool (Par défaut)

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

Set-AzSqlElasticPool
    [-ElasticPoolName] <String>
    [-ServerName] <String>
    [-ResourceGroupName] <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]
    [-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 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 : 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. (autogenerated)

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

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
Alias:Famille

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

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

  • Basique. 5 DTU
  • Norme. 100 DTU
  • Prime. 125 DTU

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. 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).

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

  • Basique. 100 DTU
  • Norme. 100 DTU
  • Prime. 125 DTU

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 pour le pool élastique. Vous ne pouvez pas modifier l’édition. 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

(All)
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.

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é:True
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 le pool élastique est affecté.

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

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 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"}

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:False
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