New-AzSqlDatabase

Référence

Module:: Az.Sql

Crée une base de données ou une base de données élastique.

Syntax

New-AzSqlDatabase
   -DatabaseName <String>
   [-CollationName <String>]
   [-CatalogCollation <String>]
   [-MaxSizeBytes <Int64>]
   [-Edition <String>]
   [-RequestedServiceObjectiveName <String>]
   [-ElasticPoolName <String>]
   [-ReadScale <DatabaseReadScale>]
   [-Tags <Hashtable>]
   [-SampleName <String>]
   [-ZoneRedundant]
   [-AsJob]
   [-Force]
   [-LicenseType <String>]
   [-AutoPauseDelayInMinutes <Int32>]
   [-MinimumCapacity <Double>]
   [-HighAvailabilityReplicaCount <Int32>]
   [-BackupStorageRedundancy <String>]
   [-SecondaryType <String>]
   [-MaintenanceConfigurationId <String>]
   [-EnableLedger]
   [-PreferredEnclaveType <String>]
   [-AssignIdentity]
   [-EncryptionProtector <String>]
   [-UserAssignedIdentityId <System.Collections.Generic.List`1[System.String]>]
   [-KeyList <System.Collections.Generic.List`1[System.String]>]
   [-FederatedClientId <Guid>]
   [-ServerName] <String>
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzSqlDatabase
   -DatabaseName <String>
   [-CollationName <String>]
   [-CatalogCollation <String>]
   [-MaxSizeBytes <Int64>]
   -Edition <String>
   [-ReadScale <DatabaseReadScale>]
   [-Tags <Hashtable>]
   [-SampleName <String>]
   [-ZoneRedundant]
   [-AsJob]
   [-Force]
   -VCore <Int32>
   -ComputeGeneration <String>
   [-LicenseType <String>]
   [-ComputeModel <String>]
   [-AutoPauseDelayInMinutes <Int32>]
   [-MinimumCapacity <Double>]
   [-HighAvailabilityReplicaCount <Int32>]
   [-BackupStorageRedundancy <String>]
   [-SecondaryType <String>]
   [-MaintenanceConfigurationId <String>]
   [-EnableLedger]
   [-PreferredEnclaveType <String>]
   [-AssignIdentity]
   [-EncryptionProtector <String>]
   [-UserAssignedIdentityId <System.Collections.Generic.List`1[System.String]>]
   [-KeyList <System.Collections.Generic.List`1[System.String]>]
   [-FederatedClientId <Guid>]
   [-ServerName] <String>
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

L’applet de commande New-AzSqlDatabase crée une base de données Azure SQL. Vous pouvez également créer une base de données élastique en définissant le paramètre ElasticPoolName sur un pool élastique existant.

Exemples

Exemple 1 : Créer une base de données sur un serveur spécifié

New-AzSqlDatabase -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DatabaseName "Database01"

ResourceGroupName             : ResourceGroup01
ServerName                    : Server01
DatabaseName                  : Database01
Location                      : Central US
DatabaseId                    : a1e6bd1a-735a-4d48-8b98-afead5ef1218
Edition                       : Standard
CollationName                 : SQL_Latin1_General_CP1_CI_AS
CatalogCollation              :
MaxSizeBytes                  : 268435456000
Status                        : Online
CreationDate                  : 7/3/2015 7:33:37 AM
CurrentServiceObjectiveId     : f1173c43-91bd-4aaa-973c-54e79e15235b
CurrentServiceObjectiveName   : S0
RequestedServiceObjectiveId   : f1173c43-91bd-4aaa-973c-54e79e15235b
RequestedServiceObjectiveName :
ElasticPoolName               :
EarliestRestoreDate           :
LicenseType                   :
Tags                          :
EnableLedger                  : False

Cette commande crée une base de données nommée Database01 sur le serveur Server01.

Exemple 2 : Créer une base de données élastique sur un serveur spécifié

New-AzSqlDatabase -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DatabaseName "Database02" -ElasticPoolName "ElasticPool01"

ResourceGroupName             : ResourceGroup01
ServerName                    : Server01
DatabaseName                  : Database02
Location                      : Central US
DatabaseId                    : 7bd9d561-42a7-484e-bf05-62ddef8015ab
Edition                       : Standard
CollationName                 : SQL_Latin1_General_CP1_CI_AS
CatalogCollation              :
MaxSizeBytes                  : 268435456000
Status                        : Online
CreationDate                  : 8/26/2015 10:04:29 PM
CurrentServiceObjectiveId     : d1737d22-a8ea-4de7-9bd0-33395d2a7419
CurrentServiceObjectiveName   : ElasticPool
RequestedServiceObjectiveId   : d1737d22-a8ea-4de7-9bd0-33395d2a7419
RequestedServiceObjectiveName :
ElasticPoolName               : ElasticPool01
EarliestRestoreDate           :
LicenseType                   :
Tags                          :
EnableLedger                  : False

Cette commande crée une base de données nommée Database02 dans le pool élastique nommé ElasticPool01 sur le serveur Server01.

Exemple 3 : Créer une base de données Vcore sur un serveur spécifié

New-AzSqlDatabase -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DatabaseName "Database03" -Edition "GeneralPurpose" -Vcore 2 -ComputeGeneration "Gen4"

ResourceGroupName             : ResourceGroup01
ServerName                    : Server01
DatabaseName                  : Database03
Location                      : Central US
DatabaseId                    : 34d9d561-42a7-484e-bf05-62ddef8000ab
Edition                       : GeneralPurpose
CollationName                 : SQL_Latin1_General_CP1_CI_AS
CatalogCollation              :
MaxSizeBytes                  : 268435456000
Status                        : Online
CreationDate                  : 8/26/2015 10:04:29 PM
CurrentServiceObjectiveName   : GP_Gen4_2
RequestedServiceObjectiveName :
ElasticPoolName               :
EarliestRestoreDate           :
LicenseType                   : LicenseIncluded
Tags                          :
EnableLedger                  : False

Cette commande crée une base de données Vcore nommée Database03 sur le serveur Server01.

Exemple 4 : Créer une base de données serverless sur le serveur spécifié

New-AzSqlDatabase -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DatabaseName "Database04" -Edition "GeneralPurpose" -Vcore 2 -ComputeGeneration "Gen5" -ComputeModel Serverless

ResourceGroupName             : ResourceGroup01
ServerName                    : Server01
DatabaseName                  : Database04
Location                      : Central US
DatabaseId                    : ef5a9698-012c-4def-8d94-7f6bfb7b4f04
Edition                       : GeneralPurpose
CollationName                 : SQL_Latin1_General_CP1_CI_AS
CatalogCollation              :
MaxSizeBytes                  : 34359738368
Status                        : Online
CreationDate                  : 4/12/2019 11:20:29 PM
CurrentServiceObjectiveName   : GP_S_Gen5_2
RequestedServiceObjectiveName : GP_S_Gen5_2
ElasticPoolName               :
EarliestRestoreDate           : 4/12/2019 11:50:29 PM
Tags                          :
CreateMode                    :
ReadScale                     : Disabled
ZoneRedundant                 : False
Capacity                      : 2
Family                        : Gen5
SkuName                       : GP_S_Gen5
LicenseType                   : LicenseIncluded
AutoPauseDelayInMinutes       : 360
EnableLedger                  : False
MinimumCapacity          : 0.5

Cette commande crée une base de données serverless nommée Database04 sur le serveur Server01.

Exemple 5 : Créer une base de données configurée avec le type d’enclave préféré en tant que VBS

New-AzSqlDatabase -ResourceGroupName "ResourceGroup01" -DatabaseName "Database01" -ServerName "Server01" -Edition "GeneralPurpose" -Vcore 2 -ComputeGeneration "Gen5" -PreferredEnclaveType "VBS"

ResourceGroupName             : ResourceGroup01
ServerName                    : Server01
DatabaseName                  : Database01
Location                      : Central US
DatabaseId                    : 34d9d561-42a7-484e-bf05-62ddef8000ab
Edition                       : GeneralPurpose
CollationName                 : SQL_Latin1_General_CP1_CI_AS
CatalogCollation              :
MaxSizeBytes                  : 268435456000
Status                        : Online
CreationDate                  : 8/26/2015 10:04:29 PM
CurrentServiceObjectiveName   : GP_Gen5_2
RequestedServiceObjectiveName :
ElasticPoolName               :
EarliestRestoreDate           :
LicenseType                   : LicenseIncluded
Tags                          :
EnableLedger                  : False
PreferredEnclaveType          : VBS

Cette commande crée une base de données configurée avec une enclave VBS

Paramètres

-AsJob

Exécuter l’applet de commande en arrière-plan

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AssignIdentity

Générez et affectez une identité Azure Active Directory pour cette base de données à utiliser avec des services de gestion de clés comme Azure KeyVault.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AutoPauseDelayInMinutes

Délai de pause automatique en minutes pour la base de données (serverless uniquement), -1 pour refuser

Type:	Int32
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-BackupStorageRedundancy

Redondance du stockage de sauvegarde utilisée pour stocker les sauvegardes pour le SQL Database. Les options sont les suivantes : Local, Zone et Geo.

Type:	String
Accepted values:	Local, Zone, Geo, GeoZone
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-CatalogCollation

Spécifie le nom du classement du catalogue de bases de données SQL.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-CollationName

Spécifie le nom du classement de la base de données SQL.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ComputeGeneration

Génération de calcul à affecter.

Type:	String
Aliases:	Family
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ComputeModel

Modèle de calcul pour Azure Sql Database. Serverless ou Provisioned

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DatabaseName

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

Type:	String
Aliases:	Name
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

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

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Edition

Spécifie l’édition à affecter à la base de données. Les valeurs valides pour ce paramètre sont :

None
De base
standard
Premium
DataWarehouse
Gratuit
Stretch
Usage général
BusinessCritical

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ElasticPoolName

Spécifie le nom du pool élastique dans lequel placer la base de données.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableLedger

Crée une base de données de registre, dans laquelle l’intégrité de toutes les données est protégée par la fonctionnalité de registre. Toutes les tables de la base de données de registre doivent être des tables de registre. Remarque : la valeur de cette propriété ne peut pas être modifiée une fois la base de données créée.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-EncryptionProtector

Clé de protection de chiffrement pour SQL Database.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-FederatedClientId

ID client fédéré pour le SQL Database. Il est utilisé pour le scénario de clé CMK interlocataire.

Type:	Nullable<T>[Guid]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

Ignorer le message de confirmation pour l’exécution de l’action

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-HighAvailabilityReplicaCount

Nombre de réplicas secondaires en lecture seule associés à la base de données vers lesquels les connexions d’intention d’application en lecture seule peuvent être routées. Cette propriété ne peut être définie que pour les bases de données hyperscale.

Type:	Int32
Aliases:	ReadReplicaCount
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-KeyList

Liste des clés AKV pour le SQL Database.

Type:	List<T>[String]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-LicenseType

Type de licence pour la base de données Azure Sql. Les valeurs possibles sont les suivantes :

BasePrice : la tarification Azure Hybrid Benefit (AHB) pour les propriétaires de licences SQL Server existants est appliquée. Le prix de la base de données sera réduit pour les propriétaires de licences SQL Server existants.
LicenseIncluded : la tarification Azure Hybrid Benefit (AHB) pour les propriétaires de licences SQL Server existants n’est pas appliquée. Le prix de la base de données inclut une nouvelle SQL Server coûts de licence.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-MaintenanceConfigurationId

ID de configuration de maintenance pour le SQL Database.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-MaxSizeBytes

Spécifie la taille maximale de la base de données en octets.

Type:	Int64
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-MinimumCapacity

Capacité minimale que la base de données aura toujours allouée, si elle n’est pas suspendue. Pour les bases de données Azure Sql serverless uniquement.

Type:	Double
Aliases:	MinVCore, MinCapacity
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PreferredEnclaveType

Type d’enclave préféré pour la base de données Azure Sql. Les valeurs possibles sont Default et VBS.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ReadScale

Si cette option est activée, les connexions dont l’intention d’application est définie sur readonly dans leur chaîne de connexion peuvent être routées vers un réplica secondaire en lecture seule. Cette propriété ne peut être définie que pour les bases de données Premium et critique pour l'entreprise.

Type:	DatabaseReadScale
Accepted values:	Disabled, Enabled
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RequestedServiceObjectiveName

Spécifie le nom de l’objectif de service à affecter à la base de données.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

Spécifie le nom du groupe de ressources auquel le serveur est affecté.

Type:	String
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-SampleName

Nom de l’exemple de schéma à appliquer lors de la création de cette base de données.

Type:	String
Accepted values:	AdventureWorksLT
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SecondaryType

Type secondaire de la base de données s’il s’agit d’une base de données secondaire. Les valeurs valides sont Geo et Named.

Type:	String
Accepted values:	Named, Geo
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ServerName

Spécifie le nom du serveur qui héberge la base de données.

Type:	String
Position:	1
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Tags

Spécifie un dictionnaire de paires clé-valeur sous la forme d’une table de hachage que cette applet de commande associe à la nouvelle base de données. Par exemple : @{key0="value0 »;key1=$null;key2="value2"}

Type:	Hashtable
Aliases:	Tag
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-UserAssignedIdentityId

Liste des identités affectées par l’utilisateur pour le SQL Database.

Type:	List<T>[String]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-VCore

Numéro de Vcore pour la base de données Azure Sql

Type:	Int32
Aliases:	Capacity, MaxVCore, MaxCapacity
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	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
Aliases:	wi
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ZoneRedundant

Redondance de zone à associer à Azure Sql Database

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

Entrées

String

Sorties

AzureSqlDatabaseModel