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

New-AzSqlElasticPool

模块:: Az.Sql Module

为 SQL 数据库创建弹性数据库池。

语法

DtuBasedPool （默认值）

New-AzSqlElasticPool
    [-ElasticPoolName] <String>
    [-ServerName] <String>
    [-ResourceGroupName] <String>
    [-Edition <String>]
    [-Dtu <Int32>]
    [-StorageMB <Int32>]
    [-DatabaseDtuMin <Int32>]
    [-DatabaseDtuMax <Int32>]
    [-Tags <Hashtable>]
    [-ZoneRedundant]
    [-LicenseType <String>]
    [-MaintenanceConfigurationId <String>]
    [-HighAvailabilityReplicaCount <Int32>]
    [-PreferredEnclaveType <String>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

VcoreBasedPool

New-AzSqlElasticPool
    [-ElasticPoolName] <String>
    [-ServerName] <String>
    [-ResourceGroupName] <String>
    -Edition <String>
    -VCore <Int32>
    -ComputeGeneration <String>
    [-StorageMB <Int32>]
    [-DatabaseVCoreMin <Double>]
    [-DatabaseVCoreMax <Double>]
    [-Tags <Hashtable>]
    [-ZoneRedundant]
    [-LicenseType <String>]
    [-MaintenanceConfigurationId <String>]
    [-HighAvailabilityReplicaCount <Int32>]
    [-PreferredEnclaveType <String>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

New-AzSqlElasticPool cmdlet 为 Azure SQL 数据库创建弹性数据库池。多个参数（-Dtu、-DatabaseDtuMin 和 -DatabaseDtuMax）要求设置的值来自该参数的有效值列表。例如，标准 100 eDTU 池的 -DatabaseDtuMax 只能设置为 10、20、50 或 100。有关哪些值有效的详细信息，请参阅弹性池中特定大小池的表。

示例

示例 1：创建 DTU 弹性池

New-AzSqlElasticPool -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -ElasticPoolName "ElasticPool01" -Edition "Standard" -Dtu 400 -DatabaseDtuMin 10 -DatabaseDtuMax 100

ResourceId        : /subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/resourcegroup01/providers/Microsoft.Sql/servers/server01/elasticPools/elasticpool01
ResourceGroupName : resourcegroup01
ServerName        : server01
ElasticPoolName   : elasticpool01
Location          : Central US
CreationDate      : 8/26/2015 10:00:17 PM
State             : Ready
Edition           : Standard
Dtu               : 400
DatabaseDtuMax    : 100
DatabaseDtuMin    : 10
StorageMB         : 409600
Tags              :

此命令在名为 ElasticPool01 的标准服务层中创建弹性池。分配给名为 ResourceGroup01 的 Azure 资源组的服务器托管弹性池。该命令为池和池中的数据库指定 DTU 属性值。

示例 2：创建 vCore 弹性池

New-AzSqlElasticPool -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -ElasticPoolName "ElasticPool01" -Edition "GeneralPurpose" -vCore 2 -ComputeGeneration Gen5

ResourceId          : /subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/ResourceGroup01/providers/Microsoft.Sql/servers/server01/elasticPools/ElasticPool01
ResourceGroupName   : ResourceGroup01
ServerName          : Server01
ElasticPoolName     : ElasticPool01
Location            : Central US
CreationDate        : 8/29/2019 2:16:40 AM
State               : Ready
Edition             : GeneralPurpose
SkuName             : GP_Gen5
Dtu                 : 2
DatabaseDtuMax      : 2
DatabaseDtuMin      : 0
Capacity            : 2
DatabaseCapacityMin : 0
DatabaseCapacityMax : 2
Family              : Gen5
MaxSizeBytes        : 34359738368
StorageMB           : 32768
Tags                :

此命令在名为 ElasticPool01 的 GeneralPurpose 服务层级中创建弹性池。分配给名为 ResourceGroup01 的 Azure 资源组的服务器托管弹性池。该命令指定池和池中的数据库的 vCore 属性值。

示例 3

为 SQL 数据库创建弹性数据库池。 (autogenerated)

New-AzSqlElasticPool -ComputeGeneration Gen5 -Edition 'GeneralPurpose' -ElasticPoolName 'ElasticPool01' -ResourceGroupName 'ResourceGroup01' -ServerName 'Server01' -StorageMB 2097152 -VCore 2

示例 4：创建具有首选 enclave 类型的弹性池作为 VBS

New-AzSqlElasticPool -ComputeGeneration Gen5 -Edition 'GeneralPurpose' -ElasticPoolName 'ElasticPool01' -ResourceGroupName 'ResourceGroup01' -ServerName 'Server01' -VCore 2 -PreferredEnclaveType 'VBS'

ResourceId          : /subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/ResourceGroup01/providers/Microsoft.Sql/servers/server01/elasticPools/ElasticPool01
ResourceGroupName   : ResourceGroup01
ServerName          : Server01
ElasticPoolName     : ElasticPool01
Location            : Central US
CreationDate        : 8/29/2019 2:16:40 AM
State               : Ready
Edition             : GeneralPurpose
SkuName             : GP_Gen5
Dtu                 : 2
DatabaseDtuMax      : 2
DatabaseDtuMin      : 0
Capacity            : 2
DatabaseCapacityMin : 0
DatabaseCapacityMax : 2
Family              : Gen5
MaxSizeBytes        : 34359738368
StorageMB           : 32768
PreferredEnclaveType: VBS
Tags                :

此命令创建配置了 VBS enclave 的弹性池

参数

-AsJob

在后台运行 cmdlet

参数属性

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

参数集

(All)

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

-ComputeGeneration

要分配的计算生成。

参数属性

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

参数集

VcoreBasedPool

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

-Confirm

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

参数属性

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

参数集

(All)

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

-DatabaseDtuMax

指定池中任何单一数据库可以使用的数据库吞吐量单位（DTU）的最大数目。不同版本的默认值如下所示：

基本。 5 个 DTU
标准。 100 个 DTU
奖赏。 125 DTU 有关哪些值有效的详细信息，请参阅弹性池中特定大小池的表

参数属性

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

参数集

DtuBasedPool

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

-DatabaseDtuMin

指定弹性池向池中的所有数据库保证的最小 DTU 数。默认值为零 (0)。有关哪些值有效的详细信息，请参阅弹性池中特定大小池的表。

参数属性

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

参数集

DtuBasedPool

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

-DatabaseVCoreMax

任何 SqlAzure 数据库可以在池中使用的最大 VCore 数。

参数属性

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

参数集

VcoreBasedPool

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

-DatabaseVCoreMin

任何 SqlAzure 数据库都可以在池中使用的最低 VCore 数。

参数属性

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

参数集

VcoreBasedPool

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

-DefaultProfile

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

参数属性

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

参数集

(All)

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

-Dtu

指定弹性池的共享 DTU 总数。不同版本的默认值如下所示：

基本。 100 个 DTU
标准。 100 个 DTU
奖赏。 125 DTU 有关哪些值有效的详细信息，请参阅弹性池中特定大小池的表。

参数属性

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

参数集

DtuBasedPool

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

-Edition

指定用于弹性池的 Azure SQL 数据库的版本。此参数的可接受值为：

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

参数属性

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

参数集

DtuBasedPool

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

-ElasticPoolName

指定此 cmdlet 创建的弹性池的名称。

参数属性

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

参数集

(All)

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

-HighAvailabilityReplicaCount

与弹性池关联的高可用性副本总数。

参数属性

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

参数集

(All)

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

-LicenseType

Azure Sql 数据库的许可证类型。

参数属性

类型:	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

-PreferredEnclaveType

Azure SQL 弹性池的首选 enclave 类型。可能的值为 Default 和 VBS。

参数属性

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

参数集

(All)

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

-ResourceGroupName

指定此 cmdlet 向其分配弹性池的资源组的名称。

参数属性

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

参数集

(All)

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

-ServerName

指定托管弹性池的服务器的名称。

参数属性

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

参数集

(All)

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

-StorageMB

指定弹性池的存储限制（以兆字节为单位）。如果未指定此参数，此 cmdlet 将计算一个值，该值取决于 Dtu 参数的值。有关可能的值，请参阅 eDTU 和存储限制。

参数属性

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

参数集

(All)

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

-Tags

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

参数属性

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

参数集

(All)

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

-VCore

Sql Azure 弹性池的 Vcore 总数。

参数属性

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

参数集

VcoreBasedPool

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。

通过

New-AzSqlElasticPool

语法

DtuBasedPool （默认值）

VcoreBasedPool

说明

示例

示例 1：创建 DTU 弹性池

示例 2：创建 vCore 弹性池

示例 3

示例 4：创建具有首选 enclave 类型的弹性池作为 VBS

参数

-AsJob

参数属性

参数集

-ComputeGeneration

参数属性

参数集

-Confirm

参数属性

参数集

-DatabaseDtuMax

参数属性

参数集

-DatabaseDtuMin

参数属性

参数集

-DatabaseVCoreMax

参数属性

参数集

-DatabaseVCoreMin

参数属性

参数集

-DefaultProfile

参数属性

参数集

-Dtu

参数属性

参数集

-Edition

参数属性

参数集

-ElasticPoolName

参数属性

参数集

-HighAvailabilityReplicaCount

参数属性

参数集

-LicenseType

参数属性

参数集

-MaintenanceConfigurationId

参数属性

参数集

-PreferredEnclaveType

参数属性

参数集

-ResourceGroupName

参数属性

参数集

-ServerName

参数属性

参数集

-StorageMB

参数属性

参数集

-Tags

参数属性

参数集

-VCore

参数属性

参数集

-WhatIf

参数属性

参数集

-ZoneRedundant

参数属性

参数集

CommonParameters

输入