Set-AzureRmSqlElasticPool
修改 Azure SQL 資料庫 中彈性資料庫集區的屬性。
警告
自 2024 年 2 月 29 日起,AzureRM PowerShell 模組已正式淘汰。 建議使用者從 AzureRM 遷移至 Az PowerShell 模組,以確保持續支援和更新。
雖然 AzureRM 模組可能仍可運作,但不再維護或支援它,但會根據用戶的判斷權和風險放置任何繼續使用。 如需轉換至 Az 模組的指引,請參閱我們的 移轉資源 。
語法
Set-AzureRmSqlElasticPool
[-ElasticPoolName] <String>
[-Edition <String>]
[-Dtu <Int32>]
[-StorageMB <Int32>]
[-DatabaseDtuMin <Int32>]
[-DatabaseDtuMax <Int32>]
[-Tags <Hashtable>]
[-ZoneRedundant]
[-LicenseType <String>]
[-AsJob]
[-ServerName] <String>
[-ResourceGroupName] <String>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-AzureRmSqlElasticPool
[-ElasticPoolName] <String>
[-Edition <String>]
[-StorageMB <Int32>]
[-VCore <Int32>]
[-ComputeGeneration <String>]
[-DatabaseVCoreMin <Double>]
[-DatabaseVCoreMax <Double>]
[-Tags <Hashtable>]
[-ZoneRedundant]
[-LicenseType <String>]
[-AsJob]
[-ServerName] <String>
[-ResourceGroupName] <String>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Set-AzureRmSqlElasticPool Cmdlet 會設定 Azure SQL 資料庫 中彈性集區的屬性。 此 Cmdlet 可以修改每個集區的 eDTU (Dtu)、每個集區的記憶體大小上限 (儲存體 MB)、每個資料庫的 eDTU 上限 (DatabaseDtuMax),以及每個資料庫的最小 eDTU (DatqabaseDtuMin)。 數個參數 (-Dtu、-DatabaseDtuMin 和 -DatabaseDtuMax) 需要設定的值來自該參數的有效值清單。 例如,標準 100 eDTU 集區的 -DatabaseDtuMax 只能設定為 10、20、50 或 100。 如需哪些值有效的詳細資訊,請參閱彈性集區中特定大小集區的數據表。
範例
範例 1:修改彈性集區的屬性
PS C:\>Set-AzureRmSqlDatabaseElasticPool -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:修改彈性集區的記憶體大小上限
PS C:\>Set-AzureRmSqlDatabaseElasticPool -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。
參數
-AsJob
在背景執行 Cmdlet
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ComputeGeneration
要指派的計算產生。
類型: | String |
別名: | Family |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Confirm
執行 Cmdlet 之前先提示您確認。
類型: | SwitchParameter |
別名: | cf |
Position: | Named |
預設值: | False |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-DatabaseDtuMax
指定集區中任何單一資料庫可以取用的最大 DTU 數目。 如需哪些值有效的詳細資訊,請參閱彈性集區中特定大小集區的數據表。 不同版本的預設值如下所示:
- 基本。 5 DTU
- 標準。 100 個 DTU
- 進階。 125 DTU
類型: | Int32 |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-DatabaseDtuMin
指定彈性集區保證給集區中所有資料庫的最低 DTU 數目。 如需哪些值有效的詳細資訊,請參閱彈性集區中特定大小集區的數據表。 預設值為零 (0)。
類型: | Int32 |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-DatabaseVCoreMax
任何 SqlAzure Database 都可以在集區中取用的最大值 VCore 數目。
類型: | Double |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-DatabaseVCoreMin
任何 SqlAzure Database 都可以在集區中取用的最小 VCore 數目。
類型: | Double |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-DefaultProfile
用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶
類型: | IAzureContextContainer |
別名: | AzureRmContext, AzureCredential |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Dtu
指定彈性集區的共用 DTU 總數。 如需哪些值有效的詳細資訊,請參閱彈性集區中特定大小集區的數據表。 不同版本的預設值如下所示:
- 基本。 100 個 DTU
- 標準。 100 個 DTU
- 進階。 125 DTU
類型: | Int32 |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Edition
指定彈性集區的 Azure SQL 資料庫 版本。 您無法變更版本。 此參數可接受的值為:
- 無
- 基本
- Standard
- Premium
- DataWarehouse
- 免費
- 延展
- GeneralPurpose
- BusinessCritical
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ElasticPoolName
指定彈性集區的名稱。
類型: | String |
別名: | Name |
Position: | 2 |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-LicenseType
Azure Sql 資料庫的授權類型。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ResourceGroupName
指定指派彈性集區的資源群組名稱。
類型: | String |
Position: | 0 |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-ServerName
指定裝載彈性集區的伺服器名稱。
類型: | String |
Position: | 1 |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-StorageMB
指定彈性集區的記憶體限制,以 MB 為單位。 如需詳細資訊,請參閱 New-AzureRmSqlElasticPool Cmdlet。
類型: | Int32 |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Tags
指定索引鍵/值組的字典,此 Cmdlet 會以哈希表的形式與彈性集區產生關聯。 例如:@{key0="value0";"key 1"=$null;key2="value2"}
類型: | Hashtable |
別名: | Tag |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-VCore
Sql Azure 彈性集區的虛擬核心總數。
類型: | Int32 |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-WhatIf
顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。
類型: | SwitchParameter |
別名: | wi |
Position: | Named |
預設值: | False |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ZoneRedundant
要與 Azure Sql 彈性集區建立關聯的區域備援
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |