New-AzSqlDatabase

Modul:

Az.Sql

Skapar en databas eller en elastisk databas.

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 <String[]>]
   [-KeyList <String[]>]
   [-FederatedClientId <Guid>]
   [-EncryptionProtectorAutoRotation]
   [-UseFreeLimit]
   [-FreeLimitExhaustionBehavior <String>]
   [-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 <String[]>]
   [-KeyList <String[]>]
   [-FederatedClientId <Guid>]
   [-EncryptionProtectorAutoRotation]
   [-UseFreeLimit]
   [-FreeLimitExhaustionBehavior <String>]
   [-ServerName] <String>
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Cmdleten New-AzSqlDatabase skapar en Azure SQL-databas. Du kan också skapa en elastisk databas genom att ange parametern ElasticPoolName till en befintlig elastisk pool.

Exempel

Exempel 1: Skapa en databas på en angiven server

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

Det här kommandot skapar en databas med namnet Database01 på server Server01.

Exempel 2: Skapa en elastisk databas på en angiven server

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

Det här kommandot skapar en databas med namnet Database02 i den elastiska poolen med namnet ElasticPool01 på server Server01.

Exempel 3: Skapa en virtuell kärna-databas på en angiven server

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

Det här kommandot skapar en virtuell kärndatabas med namnet Database03 på server Server01.

Exempel 4: Skapa en serverlös databas på den angivna servern

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

Det här kommandot skapar en serverlös databas med namnet Database04 på server Server01.

Exempel 5: Skapa en databas som konfigurerats med önskad enklavtyp som 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

Det här kommandot skapar en databas som konfigurerats med VBS-enklaven

Parametrar

-AsJob

Kör cmdlet i bakgrunden

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-AssignIdentity

Generera och tilldela en Microsoft Entra-identitet för den här databasen för användning med viktiga hanteringstjänster som Azure KeyVault.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-AutoPauseDelayInMinutes

Den automatiska pausfördröjningen i minuter för databas (endast serverlös), -1 att välja bort

Typ:	Int32
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-BackupStorageRedundancy

Redundans för säkerhetskopieringslagring som används för att lagra säkerhetskopior för SQL Database. Alternativen är: Lokal, Zon och Geo.

Typ:	String
Godkända värden:	Local, Zone, Geo, GeoZone
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-CatalogCollation

Anger namnet på sql-databaskatalogsorteringen.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-CollationName

Anger namnet på SQL-databassortering.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-ComputeGeneration

Den beräkningsgenerering som ska tilldelas.

Typ:	String
Alias:	Family
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-ComputeModel

Beräkningsmodellen för Azure Sql-databasen. Serverlös eller etablerad

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:	SwitchParameter
Alias:	cf
Position:	Named
Standardvärde:	False
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-DatabaseName

Anger namnet på databasen.

Typ:	String
Alias:	Name
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure

Typ:	IAzureContextContainer
Alias:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Edition

Anger vilken utgåva som ska tilldelas till databasen. De godtagbara värdena för den här parametern är:

• Ingen
• Grundläggande
• Standard
• Premie
• DataWarehouse
• Gratis
• Tänja
• GeneralPurpose
• BusinessCritical

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-ElasticPoolName

Anger namnet på den elastiska pool som databasen ska placeras i.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-EnableLedger

Skapar en transaktionsregisterdatabas där integriteten för alla data skyddas av transaktionsregisterfunktionen. Alla tabeller i transaktionsregisterdatabasen måste vara transaktionsregistertabeller. Obs! Värdet för den här egenskapen kan inte ändras när databasen har skapats.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-EncryptionProtector

Krypteringsskyddsnyckeln för SQL Database.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-EncryptionProtectorAutoRotation

Status för automatisk rotation av AKV-nyckel

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-FederatedClientId

Det federerade klient-ID:t för SQL Database. Det används för cmk-scenario mellan klientorganisationer.

Typ:	Nullable<T>[Guid]
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Force

Hoppa över bekräftelsemeddelandet för att utföra åtgärden

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-FreeLimitExhaustionBehavior

Överbelastningsbeteende för databasen med fri gräns.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-HighAvailabilityReplicaCount

Antalet skrivskyddade sekundära repliker som är associerade med databasen till vilka readonly-program avsiktsanslutningar kan dirigeras. Den här egenskapen kan endast anges för Hyperskala-databasversioner.

Typ:	Int32
Alias:	ReadReplicaCount
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-KeyList

Listan över AKV-nycklar för SQL Database.

Typ:	String[]
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-LicenseType

Licenstypen för Azure Sql-databasen. Möjliga värden är:

• BasePrice – rabatterade priser för Azure Hybrid Benefit (AHB) för befintliga SQL Server-licensägare tillämpas. Databaspriset kommer att rabatteras för befintliga SQL Server-licensägare.
• LicenseIncluded – Rabattpriser för Azure Hybrid-förmån (AHB) för befintliga SQL Server-licensägare tillämpas inte. Databaspriset inkluderar en ny SQL Server-licenskostnad.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-MaintenanceConfigurationId

Underhållskonfigurations-ID för SQL Database.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-MaxSizeBytes

Anger den maximala storleken på databasen i byte.

Typ:	Int64
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-MinimumCapacity

Den minimala kapacitet som databasen alltid har allokerat, om den inte har pausats. Endast för serverlösa Azure Sql-databaser.

Typ:	Double
Alias:	MinVCore, MinCapacity
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-PreferredEnclaveType

Önskad enklavtyp för Azure Sql-databasen. Möjliga värden är Standard och VBS.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-ReadScale

Om det här alternativet är aktiverat kan anslutningar som har programmets avsikt inställd på skrivskyddad i anslutningssträngen dirigeras till en skrivskyddad sekundär replik. Den här egenskapen kan endast användas för Premium- och affärskritiska databaser.

Typ:	DatabaseReadScale
Godkända värden:	Disabled, Enabled
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-RequestedServiceObjectiveName

Anger namnet på tjänstmålet som ska tilldelas till databasen.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-ResourceGroupName

Anger namnet på den resursgrupp som servern har tilldelats.

Typ:	String
Position:	0
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-SampleName

Namnet på exempelschemat som ska tillämpas när du skapar den här databasen.

Typ:	String
Godkända värden:	AdventureWorksLT
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-SecondaryType

Den sekundära typen av databas om den är sekundär. Giltiga värden är Geo och Named.

Typ:	String
Godkända värden:	Named, Geo
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-ServerName

Anger namnet på den server som är värd för databasen.

Typ:	String
Position:	1
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-Tags

Anger en ordlista med nyckel/värde-par i form av en hash-tabell som den här cmdleten associerar med den nya databasen. Exempel: @{key0="value0"; key1=$null; key2="value2"}

Typ:	Hashtable
Alias:	Tag
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-UseFreeLimit

Använd den kostnadsfria gränsen för den här databasen.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-UserAssignedIdentityId

Listan över användartilldelade identiteter för SQL Database.

Typ:	String[]
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-VCore

Det virtuella kärnnumret för Azure Sql-databasen

Typ:	Int32
Alias:	Capacity, MaxVCore, MaxCapacity
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-WhatIf

Visar vad som skulle hända om cmdleten körs. Cmdleten körs inte.

Typ:	SwitchParameter
Alias:	wi
Position:	Named
Standardvärde:	False
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-ZoneRedundant

Zonredundans som ska associeras med Azure Sql Database

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

Indata

String

Utdata

AzureSqlDatabaseModel

Relaterade länkar

• Get-AzSqlDatabase
• New-AzSqlElasticPool
• New-AzSqlServer
• Remove-AzSqlDatabase
• Resume-AzSqlDatabase
• Set-AzSqlDatabase
• Suspend-AzSqlDatabase
• Dokumentation om SQL Database