New-AzureSqlDatabase
Crée une base de données Azure SQL.
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
New-AzureSqlDatabase
-ConnectionContext <IServerDataServiceContext>
-DatabaseName <String>
[-Collation <String>]
[-Edition <DatabaseEdition>]
[-ServiceObjective <ServiceObjective>]
[-MaxSizeGB <Int32>]
[-MaxSizeBytes <Int64>]
[-Force]
[-Profile <AzureSMProfile>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzureSqlDatabase
-ServerName <String>
-DatabaseName <String>
[-Collation <String>]
[-Edition <DatabaseEdition>]
[-ServiceObjective <ServiceObjective>]
[-MaxSizeGB <Int32>]
[-MaxSizeBytes <Int64>]
[-Force]
[-Profile <AzureSMProfile>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
L’applet de commande New-AzureSqlDatabase crée une base de données Azure SQL. Vous pouvez spécifier le serveur à l’aide d’un contexte de connexion de serveur Azure SQL Database que vous créez à l’aide de l’applet de commande New-AzureSqlDatabaseServerContext . Ou, si vous spécifiez le nom du serveur, l’applet de commande utilise les informations d’abonnement Azure actuelles pour authentifier la demande d’accès au serveur.
Lorsque vous créez une base de données en spécifiant un serveur Azure SQL Database, l’applet de commande New-AzureSqlDatabase crée un contexte de connexion temporaire à l’aide du nom de serveur spécifié et des informations d’abonnement Azure actuelles pour effectuer l’opération.
Exemples
Exemple 1 : Créer une base de données
PS C:\> $Database01 = New-AzureSqlDatabase -ConnectionContext $Context -DatabaseName "Database01" -Edition "Business" -MaxSizeGB 50 -Collation "SQL_Latin1_General_CP1_CI_AS"Cette commande crée une base de données Azure SQL nommée Database1, pour le contexte de connexion au serveur Azure SQL Database $Context.
Exemple 2 : Créer une base de données dans l’abonnement actuel
PS C:\> $Database01 = New-AzureSqlDatabase -ServerName "lpqd0zbr8y" -DatabaseName "Database01" -Edition "Business" -MaxSizeGB 50 -Collation "SQL_Latin1_General_CP1_CI_AS"Cet exemple crée une base de données nommée Database1, dans le serveur Azure SQL Database spécifié nommé lpqd0zbr8y. L’applet de commande utilise les informations d’abonnement Azure actuelles pour authentifier la demande d’accès au serveur.
Paramètres
-Collation
Spécifie un classement pour la nouvelle base de données.
| 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 |
-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 où cette applet de commande crée une base de données.
| 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 |
-DatabaseName
Spécifie le nom de la nouvelle base de données.
| 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 l’édition pour la nouvelle base de données Azure SQL. Les valeurs valides sont :
- Aucune
- web
- Métier
- De base
- standard
- Premium
La valeur par défaut est Web.
| 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 inviter l’utilisateur à 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 taille maximale de la base de données en octets. Vous pouvez spécifier ce paramètre ou le paramètre MaxSizeGB . Consultez la description du 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 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 |
-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 Azure SQL Database pour contenir la nouvelle base de données.
| 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 qui représente le nouvel objectif de service (niveau de performance) pour cette base de données. Cette valeur représente le niveau de ressources affectées à cette base de données. Les valeurs valides sont :
Basic : 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 (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 |
-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 |
Sorties
Microsoft.WindowsAzure.Commands.SqlDatabase.Services.Server.Database
Notes
- Pour supprimer une base de données créée par New-AzureSqlDatabase, utilisez l’applet de commande Remove-AzureSqlDatabase.