Set-AzureRmSqlDatabase

參考

模組:: AzureRM.Sql

設定資料庫的屬性，或將現有資料庫移到彈性集區中。

警告

自 2024 年 2 月 29 日起，AzureRM PowerShell 模組已正式淘汰。建議使用者從 AzureRM 遷移至 Az PowerShell 模組，以確保持續支援和更新。

雖然 AzureRM 模組可能仍可運作，但不再維護或支援它，但會根據用戶的判斷權和風險放置任何繼續使用。如需轉換至 Az 模組的指引，請參閱我們的移轉資源。

語法

Set-AzureRmSqlDatabase
   [-DatabaseName] <String>
   [-MaxSizeBytes <Int64>]
   [-Edition <String>]
   [-RequestedServiceObjectiveName <String>]
   [-ElasticPoolName <String>]
   [-ReadScale <DatabaseReadScale>]
   [-Tags <Hashtable>]
   [-ZoneRedundant]
   [-AsJob]
   [-LicenseType <String>]
   [-ServerName] <String>
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzureRmSqlDatabase
   [-DatabaseName] <String>
   [-MaxSizeBytes <Int64>]
   [-Edition <String>]
   [-ReadScale <DatabaseReadScale>]
   [-Tags <Hashtable>]
   [-ZoneRedundant]
   [-AsJob]
   [-VCore <Int32>]
   [-ComputeGeneration <String>]
   [-LicenseType <String>]
   [-ServerName] <String>
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzureRmSqlDatabase
   [-DatabaseName] <String>
   -NewName <String>
   [-AsJob]
   [-ServerName] <String>
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Set-AzureRmSqlDatabase Cmdlet 會設定 Azure SQL 資料庫中資料庫的屬性。此 Cmdlet 可以修改資料庫的服務層級（Edition）、效能等級（RequestedServiceObjectiveName）和記憶體大小上限（MaxSizeBytes）。此外，您可以指定 ElasticPoolName 參數，將資料庫移至彈性集區。如果資料庫已經在彈性集區中，您可以使用 RequestedServiceObjectiveName 參數，將資料庫從彈性集區移出，並進入單一資料庫的效能層級。

範例

範例 1：將資料庫更新為標準 S2 資料庫

PS C:\>Set-AzureRmSqlDatabase -ResourceGroupName "ResourceGroup01" -DatabaseName "Database01" -ServerName "Server01" -Edition "Standard" -RequestedServiceObjectiveName "S2"
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     : 455330e1-00cd-488b-b5fa-177c226f28b7
CurrentServiceObjectiveName   : S2
RequestedServiceObjectiveId   : 455330e1-00cd-488b-b5fa-177c226f28b7
RequestedServiceObjectiveName :
ElasticPoolName               :
EarliestRestoreDate           :
Tags                          :

此命令會將名為 Database01 的資料庫更新為 Server01 伺服器上的標準 S2 資料庫。

範例 2：將資料庫新增至彈性集區

PS C:\>Set-AzureRmSqlDatabase -ResourceGroupName "ResourceGroup01" -DatabaseName "Database01" -ServerName "Server01" -ElasticPoolName "ElasticPool01"
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     : d1737d22-a8ea-4de7-9bd0-33395d2a7419
CurrentServiceObjectiveName   : ElasticPool
RequestedServiceObjectiveId   : d1737d22-a8ea-4de7-9bd0-33395d2a7419
RequestedServiceObjectiveName :
ElasticPoolName               : elasticpool01
EarliestRestoreDate           :
Tags                          :

此命令會將名為 Database01 的資料庫新增至裝載於 Server01 伺服器上名為 ElasticPool01 的彈性集區。

範例 3：修改資料庫的記憶體大小上限

PS C:\>Set-AzureRmSqlDatabase -ResourceGroupName "ResourceGroup01" -DatabaseName "Database01" -ServerName "Server01" -MaxSizeBytes 1099511627776
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                  : 1099511627776
Status                        : Online
CreationDate                  : 8/24/2017 9:00:37 AM
CurrentServiceObjectiveId     : 789681b8-ca10-4eb0-bdf2-e0b050601b40
CurrentServiceObjectiveName   : S3
RequestedServiceObjectiveId   : 789681b8-ca10-4eb0-bdf2-e0b050601b40
RequestedServiceObjectiveName :
ElasticPoolName               :
EarliestRestoreDate           :
Tags                          :

此命令會更新名為 Database01 的資料庫，將其大小上限設定為 1 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

-DatabaseName

指定資料庫的名稱。

類型:	String
別名:	Name
Position:	2
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶

類型:	IAzureContextContainer
別名:	AzureRmContext, AzureCredential
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Edition

指定資料庫的版本。此參數可接受的值為：

無
基本
Standard
Premium
DataWarehouse
免費
延展
GeneralPurpose
BusinessCritical

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ElasticPoolName

指定要在其中移動資料庫之彈性集區的名稱。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-LicenseType

Azure Sql 資料庫的授權類型。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-MaxSizeBytes

以位元組為單位的 Azure SQL 資料庫大小上限。

類型:	Int64
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-NewName

要重新命名資料庫的新名稱。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-ReadScale

要指派給 Azure SQL 資料庫的讀取縮放選項。Enabled/Disabled）

類型:	DatabaseReadScale
接受的值:	Disabled, Enabled
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-RequestedServiceObjectiveName

指定要指派給資料庫的服務目標名稱。如需服務目標的相關信息，請參閱 Microsoft 開發人員網路連結庫中的 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

-Tags

哈希表形式的索引鍵/值組。例如：@{key0=“value0”;key1=$null;key2=“value2”}

類型:	Hashtable
別名:	Tag
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-VCore

Azure Sql 資料庫的虛擬核心號碼

類型:	Int32
別名:	Capacity
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。未執行 Cmdlet。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ZoneRedundant

要與 Azure Sql Database 建立關聯的區域備援

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

String

輸出

AzureSqlDatabaseModel

共用方式為

Set-AzureRmSqlDatabase

語法

Description

範例

範例 1：將資料庫更新為標準 S2 資料庫

範例 2：將資料庫新增至彈性集區

範例 3：修改資料庫的記憶體大小上限

參數

-AsJob

-ComputeGeneration

-Confirm

-DatabaseName

-DefaultProfile

-Edition

-ElasticPoolName

-LicenseType

-MaxSizeBytes

-NewName

-ReadScale

-RequestedServiceObjectiveName

-ResourceGroupName

-ServerName

-Tags

-VCore

-WhatIf

-ZoneRedundant

輸入

輸出

其他資源

共用方式為

Set-AzureRmSqlDatabase

語法

Description

範例

範例 1：將資料庫更新為標準 S2 資料庫

範例 2：將資料庫新增至彈性集區

範例 3：修改資料庫的記憶體大小上限

參數

-AsJob

-ComputeGeneration

-Confirm

-DatabaseName

-DefaultProfile

-Edition

-ElasticPoolName

-LicenseType

-MaxSizeBytes

-NewName

-ReadScale

-RequestedServiceObjectiveName

-ResourceGroupName

-ServerName

-Tags

-VCore

-WhatIf

-ZoneRedundant

輸入

輸出

相關連結

其他資源