Set-AzureSqlDatabase

Module:

Azure

Définit les propriétés d’une base de données Azure SQL Database.

Remarque

Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Azure Service Manager (ASM). Ce module PowerShell hérité n’est pas recommandé lors de la création de ressources, car ASM est planifié pour la mise hors service. Pour plus d’informations, consultez la mise hors service d’Azure Service Manager.

Le module Az PowerShell est le module PowerShell recommandé pour la gestion des ressources Azure Resource Manager (ARM) avec PowerShell.

Syntaxe

Set-AzureSqlDatabase
   -ConnectionContext <IServerDataServiceContext>
   -DatabaseName <String>
   [-NewDatabaseName <String>]
   [-Edition <DatabaseEdition>]
   [-MaxSizeGB <Int32>]
   [-MaxSizeBytes <Int64>]
   [-ServiceObjective <ServiceObjective>]
   [-PassThru]
   [-Force]
   [-Sync]
   [-Profile <AzureSMProfile>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzureSqlDatabase
   -ConnectionContext <IServerDataServiceContext>
   -Database <Database>
   [-NewDatabaseName <String>]
   [-Edition <DatabaseEdition>]
   [-MaxSizeGB <Int32>]
   [-MaxSizeBytes <Int64>]
   [-ServiceObjective <ServiceObjective>]
   [-PassThru]
   [-Force]
   [-Sync]
   [-Profile <AzureSMProfile>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzureSqlDatabase
   -ServerName <String>
   -DatabaseName <String>
   [-NewDatabaseName <String>]
   [-Edition <DatabaseEdition>]
   [-MaxSizeGB <Int32>]
   [-MaxSizeBytes <Int64>]
   [-ServiceObjective <ServiceObjective>]
   [-PassThru]
   [-Force]
   [-Sync]
   [-Profile <AzureSMProfile>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzureSqlDatabase
   -ServerName <String>
   -Database <Database>
   [-NewDatabaseName <String>]
   [-Edition <DatabaseEdition>]
   [-MaxSizeGB <Int32>]
   [-MaxSizeBytes <Int64>]
   [-ServiceObjective <ServiceObjective>]
   [-PassThru]
   [-Force]
   [-Sync]
   [-Profile <AzureSMProfile>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

L’applet de commande Set-AzureSqlDatabase définit les propriétés d’une base de données Azure SQL. Vous pouvez spécifier la base de données par nom ou passer un objet Azure SQL Database via le pipeline. Vous pouvez spécifier le serveur par nom ou passer un contexte de connexion au serveur Azure SQL Database. Créez un contexte de connexion en exécutant l’applet de commande New-AzureSqlDatabaseServerContext . Si vous spécifiez le serveur par nom, l’applet de commande utilise les informations d’abonnement Azure actuelles pour authentifier la demande.

Exemples

Exemple 1 : Modifier la taille d’une base de données à l’aide d’un contexte de connexion

PS C:\> $Database01 = Get-AzureSqlDatabase -ConnectionContext $Context -DatabaseName "Database01"
PS C:\> Set-AzureSqlDatabase -ConnectionContext $Context -Database $Database01 -MaxSizeGB 20

Cet exemple montre comment modifier la taille de la base de données nommée Database01 à 20 Go dans le contexte de connexion du serveur Azure SQL Database $Context.

Exemple 2 : Modifier la taille d’une base de données à l’aide d’un nom de serveur

PS C:\> $Database01 = Get-AzureSqlDatabase -ServerName "lpqd0zbr8y" -DatabaseName "Database01"
PS C:\> Set-AzureSqlDatabase -ServerName "lpqd0zbr8y" -Database $Database01 -MaxSizeGB 20

Cet exemple modifie la taille de la base de données nommée Database01 à 20 Go dans le serveur nommé lpqd0zbr8y.

Paramètres

-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

-ConnectionContext

Spécifie le contexte de connexion d’un serveur.

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

-Database

Spécifie un objet qui représente Azure SQL Database que cette applet de commande modifie.

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

-DatabaseName

Spécifie le nom de la base de données que cette applet de commande modifie.

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

-Edition

Spécifie la nouvelle édition d’Azure SQL Database. Les valeurs valides sont :

• Aucune
• web
• Métier
• De base
• standard
• Premium

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

-Force

Permet à l’action de se terminer sans vous inviter à confirmer.

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

-MaxSizeBytes

Spécifie la nouvelle taille maximale de la base de données en octets. Vous pouvez spécifier ce paramètre ou le paramètre MaxSizeGB . Consultez le paramètre MaxSizeGB pour connaître les valeurs acceptables en fonction de l’édition.

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

-MaxSizeGB

Spécifie la nouvelle taille maximale de la base de données en gigaoctets. Vous pouvez spécifier ce paramètre ou le paramètre MaxSizeBytes . Les valeurs acceptables diffèrent selon l’édition.

Valeurs d’édition de base : 1 ou 2

Édition Standard valeurs : 1, 2, 5, 10, 20, 30, 40, 50, 100, 150, 200 ou 250

Valeurs Premium Edition : 1, 2, 5, 10, 20, 30, 40, 50, 100, 150, 200, 250, 300, 400 ou 500

Valeurs web Edition : 1 ou 5

Valeurs business Edition : 10, 20, 30, 40, 50, 100 ou 150

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

-NewDatabaseName

Spécifie le nouveau nom de la base de données.

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

-PassThru

Retourne la base de données Azure SQL mise à jour.

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

-Profile

Spécifie le profil Azure à partir duquel cette applet de commande lit. Si vous ne spécifiez pas de profil, cette applet de commande lit le profil par défaut local.

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

-ServerName

Spécifie le nom du serveur qui contient la base de données que cette applet de commande modifie.

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

-ServiceObjective

Spécifie un objet représentant le nouvel objectif de service (niveau de performance) pour cette base de données. Les valeurs valides sont :

• De base : dd6d99bb-f193-4ec1-86f2-43d3bccbc49c
• Standard (S0) : f1173c43-91bd-4aaa-973c-54e79e15235b
• Standard (S1) : 1b1ebd4d-d903-4baa-97f9-4ea675f5e928
• Standard (S2) : 455330e1-00cd-488b-b5fa-177c226f28b7
• *Standard (S3) : 789681b8-ca10-4eb0-bdf2-e0b050601b40
• Premium (P1) : 7203483a-c4fb-4304-9e9f-17c71c904f5d
• Premium (P2) : a7d1b92d-c987-4375-b54d-2b1d0e0f5bb0
• Premium (P3) : a7c4c615-cfb1-464b-b252-925be0a19446

*Standard (S3) fait partie de la dernière mise à jour sql Database V12 (préversion). Pour plus d’informations, consultez Nouveautés de la préversion d’Azure SQL Database V12https://azure.microsoft.com/documentation/articles/sql-database-preview-whats-new/.

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

-Sync

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

-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

Entrées

Microsoft.WindowsAzure.Commands.SqlDatabase.Services.Server.Database

Sorties

Microsoft.WindowsAzure.Commands.SqlDatabase.Services.Server.Database

Liens associés

• Azure SQL Database
• Opérations des bases de données Azure SQL
• Mettre à jour la base de données
• Get-AzureSqlDatabase
• New-AzureSqlDatabase
• Remove-AzureSqlDatabase
• New-AzureSqlDatabaseServerContext