你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

New-AzSqlDatabase

模块:: Az.Sql Module

创建数据库或弹性数据库。

语法

DtuBasedDatabase （默认值）

New-AzSqlDatabase
    [-ServerName] <String>
    [-ResourceGroupName] <String>
    -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>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

VcoreBasedDatabase

New-AzSqlDatabase
    [-ServerName] <String>
    [-ResourceGroupName] <String>
    -DatabaseName <String>
    -Edition <String>
    -VCore <Int32>
    -ComputeGeneration <String>
    [-CollationName <String>]
    [-CatalogCollation <String>]
    [-MaxSizeBytes <Int64>]
    [-ReadScale <DatabaseReadScale>]
    [-Tags <Hashtable>]
    [-SampleName <String>]
    [-ZoneRedundant]
    [-AsJob]
    [-Force]
    [-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>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

New-AzSqlDatabase cmdlet 创建 Azure SQL 数据库。还可以通过将 ElasticPoolName 参数设置为现有弹性池来创建弹性数据库。

示例

示例 1：在指定的服务器上创建数据库

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

此命令在 Server01 上创建名为 Database01 的数据库。

示例 2：在指定的服务器上创建弹性数据库

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

此命令在服务器 Server01 上名为 ElasticPool01 的弹性池中创建名为 Database02 的数据库。

示例 3：在指定的服务器上创建 Vcore 数据库

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

此命令在服务器 Server01 上创建名为 Database03 的 Vcore 数据库。

示例 4：在指定的服务器上创建无服务器数据库

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

此命令在 Server01 上创建名为 Database04 的无服务器数据库。

示例 5：创建配置为 VBS 的首选 enclave 类型的数据库

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

此命令创建配置了 VBS enclave 的数据库

参数

-AsJob

在后台运行 cmdlet

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-AssignIdentity

为此数据库生成并分配一个Microsoft Entra 标识，以用于 Azure KeyVault 等密钥管理服务。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-AutoPauseDelayInMinutes

自动暂停延迟（仅限无服务器），-1 选择退出

参数属性

类型:	Int32
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-BackupStorageRedundancy

用于存储 SQL 数据库的备份的备份存储冗余。选项包括：本地、区域和地理位置。

参数属性

类型:	String
默认值:	None
接受的值:	Local, Zone, Geo, GeoZone
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-CatalogCollation

指定 SQL 数据库目录排序规则的名称。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-CollationName

指定 SQL 数据库排序规则的名称。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ComputeGeneration

要分配的计算生成。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False
别名:	家庭

参数集

VcoreBasedDatabase

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ComputeModel

Azure Sql 数据库的计算模型。无服务器或预配

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

VcoreBasedDatabase

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Confirm

在运行 cmdlet 之前，提示你进行确认。

参数属性

类型:	SwitchParameter
默认值:	False
支持通配符:	False
不显示:	False
别名:	cf

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-DatabaseName

指定数据库的名称。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False
别名:	Name

参数集

(All)

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-DefaultProfile

用于与 azure 通信的凭据、帐户、租户和订阅

参数属性

类型:	IAzureContextContainer
默认值:	None
支持通配符:	False
不显示:	False
别名:	AzContext, AzureRmContext, AzureCredential

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Edition

指定要分配给数据库的版本。此参数的可接受值为：

None
基本
标准
高级
DataWarehouse
免费
Stretch
GeneralPurpose
BusinessCritical

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

DtuBasedDatabase

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ElasticPoolName

指定要在其中放置数据库的弹性池的名称。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

DtuBasedDatabase

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-EnableLedger

创建一个账本数据库，其中所有数据的完整性受账本功能保护。账本数据库中的所有表必须是账本表。注意：创建数据库后，无法更改此属性的值。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-EncryptionProtector

SQL 数据库的加密保护程序密钥。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-EncryptionProtectorAutoRotation

AKV 密钥自动轮换状态

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-FederatedClientId

SQL 数据库的联合客户端 ID。它用于跨租户 CMK 方案。

参数属性

类型:	Nullable<T>[Guid]
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Force

跳过执行操作的确认消息

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-FreeLimitExhaustionBehavior

免费限制数据库的耗尽行为。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-HighAvailabilityReplicaCount

与可路由只读应用程序意向连接的数据库关联的只读次要副本数。此属性仅适用于超大规模版本数据库。

参数属性

类型:	Int32
默认值:	None
支持通配符:	False
不显示:	False
别名:	ReadReplicaCount

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-KeyList

SQL 数据库的 AKV 密钥列表。

参数属性

类型:	String[]
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-LicenseType

Azure Sql 数据库的许可证类型。可能的值为：

BasePrice - 应用现有 SQL Server 许可证所有者的 Azure 混合权益（AHB）折扣定价。现有 SQL Server 许可证所有者的数据库价格将折扣。
LicenseIncluded - 未应用现有 SQL Server 许可证所有者的 Azure 混合权益（AHB）折扣定价。数据库价格将包括新的 SQL Server 许可证成本。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-MaintenanceConfigurationId

SQL 数据库的维护配置 ID。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-MaxSizeBytes

指定数据库的最大大小（以字节为单位）。

参数属性

类型:	Int64
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-MinimumCapacity

数据库始终分配的最小容量（如果未暂停）。仅适用于无服务器 Azure Sql 数据库。

参数属性

类型:	Double
默认值:	None
支持通配符:	False
不显示:	False
别名:	MinVCore, MinCapacity

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-PreferredEnclaveType

Azure Sql 数据库的首选 enclave 类型。可能的值为 Default 和 VBS。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ReadScale

如果启用，其连接字符串中将应用程序意向设置为只读的连接可能会路由到只读次要副本。此属性仅适用于高级数据库和业务关键数据库。

参数属性

类型:	DatabaseReadScale
默认值:	None
接受的值:	Disabled, Enabled
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-RequestedServiceObjectiveName

指定要分配给数据库的服务目标的名称。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

DtuBasedDatabase

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ResourceGroupName

指定为其分配服务器的资源组的名称。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	0
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-SampleName

创建此数据库时要应用的示例架构的名称。

参数属性

类型:	String
默认值:	None
接受的值:	AdventureWorksLT
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-SecondaryType

数据库的辅助类型（如果是辅助数据库）。有效值为 Geo 和 Named。

参数属性

类型:	String
默认值:	None
接受的值:	Named, Geo
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ServerName

指定承载数据库的服务器的名称。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	1
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-Tags

指定此 cmdlet 与新数据库关联的哈希表形式的键值对字典。例如：@{key0=“value0”;key1=$null;key2=“value2”}

参数属性

类型:	Hashtable
默认值:	None
支持通配符:	False
不显示:	False
别名:	标记

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-UseFreeLimit

对此数据库使用免费限制。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-UserAssignedIdentityId

SQL 数据库的用户分配标识列表。

参数属性

类型:	String[]
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-VCore

Azure Sql 数据库的 Vcore 数

参数属性

类型:	Int32
默认值:	None
支持通配符:	False
不显示:	False
别名:	Capacity, MaxVCore, MaxCapacity

参数集

VcoreBasedDatabase

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-WhatIf

显示 cmdlet 运行时会发生什么情况。命令脚本未运行。

参数属性

类型:	SwitchParameter
默认值:	False
支持通配符:	False
不显示:	False
别名:	无线

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ZoneRedundant

要与 Azure Sql 数据库关联的区域冗余

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CommonParameters

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。有关详细信息，请参阅 about_CommonParameters。