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

Set-AzSqlElasticPool

修改Azure SQL 数据库中弹性数据库池的属性。

语法

DtuBasedPool (默认值)

Set-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

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

说明

Set-AzSqlElasticPool cmdlet 在 Azure SQL 数据库 中设置弹性池的属性。 此 cmdlet 可以修改每个池的 eDTU(Dtu)、每个池的存储最大大小(StorageMB)、每个数据库的最大 eDTU(DatabaseDtuMax)和每个数据库的最小 eDTU(DatabaseDtuMin)。 多个参数(-Dtu、-DatabaseDtuMin 和 -DatabaseDtuMax)要求设置的值来自该参数的有效值列表。 例如,标准 100 eDTU 池的 -DatabaseDtuMax 只能设置为 10、20、50 或 100。 有关哪些值有效的详细信息,请参阅弹性池中特定大小池表。

示例

示例 1:修改弹性池的属性

Set-AzSqlElasticPool -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -ElasticPoolName "ElasticPool01" -Dtu 1000 -DatabaseDtuMax 100 -DatabaseDtuMin 20
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               : 200
DatabaseDtuMax    : 100
DatabaseDtuMin    : 20
StorageMB         : 204800
Tags              :

此命令修改名为 elasticpool01 的弹性池的属性。 该命令将弹性池的 DTU 数设置为 1000,并设置最小和最大 DTU。

示例 2:修改弹性池的存储最大大小

Set-AzSqlElasticPool -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -ElasticPoolName "ElasticPool01" -StorageMB 2097152
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           : Premium
Dtu               : 200
DatabaseDtuMax    : 100
DatabaseDtuMin    : 20
StorageMB         : 2097152
Tags              :

此命令修改名为 elasticpool01 的弹性池的属性。 该命令将弹性池的最大存储设置为 2 TB。

示例 3

修改Azure SQL 数据库中弹性数据库池的属性。 (autogenerated)

Set-AzSqlElasticPool -Dtu 1000 -Edition 'GeneralPurpose' -ElasticPoolName 'ElasticPool01' -ResourceGroupName 'ResourceGroup01' -ServerName 'Server01'

示例 4:将弹性池的首选 enclave 类型修改为 VBS

Set-AzSqlElasticPool -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -ElasticPoolName "ElasticPool01" -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/26/2015 10:00:17 PM
State                 : Ready
Edition               : Premium
Dtu                   : 200
DatabaseDtuMax        : 100
DatabaseDtuMin        : 20
StorageMB             : 2097152
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
必需:False
来自管道的值: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 数据库版本。 无法更改版本。 此参数的可接受值为:

  • 没有
  • 基本
  • 标准
  • 高级
  • DataWarehouse
  • 免费
  • Stretch
  • 常规用途
  • 关键业务

参数属性

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

参数集

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

-ElasticPoolName

指定弹性池的名称。

参数属性

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

参数集

(All)
Position:2
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值: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

指定为其分配弹性池的资源组的名称。

参数属性

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

参数集

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

-ServerName

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

参数属性

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

参数集

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

-StorageMB

指定弹性池的存储限制(以兆字节为单位)。 有关详细信息,请参阅 New-AzSqlElasticPool cmdlet。

参数属性

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

参数集

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

-Tags

指定此 cmdlet 以哈希表的形式与弹性池关联的键值对字典。 例如:@{key0="value0";"key 1"=$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
必需:False
来自管道的值: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

输入

String

输出

AzureSqlElasticPoolModel