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
参数属性
参数集
(All)
Position: | Named |
必需: | False |
来自管道的值: | False |
来自管道的值(按属性名称): | False |
来自剩余参数的值: | False |
-ComputeGeneration
要分配的计算生成。
参数属性
类型: | String
|
默认值: | None |
支持通配符: | False |
不显示: | False |
别名: | 家庭 |
参数集
VcoreBasedPool
Position: | Named |
必需: | False |
来自管道的值: | False |
来自管道的值(按属性名称): | False |
来自剩余参数的值: | False |
-Confirm
在运行 cmdlet 之前,提示你进行确认。
参数属性
参数集
(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 通信的凭据、帐户、租户和订阅
参数属性
参数集
(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 |
指定此 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 运行时会发生什么情况。
命令脚本未运行。
参数属性
参数集
(All)
Position: | Named |
必需: | False |
来自管道的值: | False |
来自管道的值(按属性名称): | False |
来自剩余参数的值: | False |
-ZoneRedundant
要与 Azure Sql 弹性池关联的区域冗余
参数属性
参数集
(All)
Position: | Named |
必需: | False |
来自管道的值: | False |
来自管道的值(按属性名称): | False |
来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters。
输出