Set-AzureSqlDatabase
設定 Azure SQL 資料庫 的屬性。
注意
本文件中參考的 Cmdlet 用於管理使用 Azure Service Manager(ASM) API 的舊版 Azure 資源。 建立新的資源時,不建議使用此舊版 PowerShell 模組,因為 ASM 已排定淘汰。 如需詳細資訊,請參閱 Azure Service Manager 淘汰。
Az PowerShell 模組是使用 PowerShell 管理 Azure Resource Manager (ARM) 資源的建議 PowerShell 模組。
語法
Set-AzureSqlDatabase
-ConnectionContext <IServerDataServiceContext>
-DatabaseName <String>
[-NewDatabaseName <String>]
[-Edition <DatabaseEdition>]
[-MaxSizeGB <Int32>]
[-MaxSizeBytes <Int64>]
[-ServiceObjective <ServiceObjective>]
[-PassThru]
[-Force]
[-Sync]
[-Profile <AzureSMProfile>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-AzureSqlDatabase
-ConnectionContext <IServerDataServiceContext>
-Database <Database>
[-NewDatabaseName <String>]
[-Edition <DatabaseEdition>]
[-MaxSizeGB <Int32>]
[-MaxSizeBytes <Int64>]
[-ServiceObjective <ServiceObjective>]
[-PassThru]
[-Force]
[-Sync]
[-Profile <AzureSMProfile>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-AzureSqlDatabase
-ServerName <String>
-DatabaseName <String>
[-NewDatabaseName <String>]
[-Edition <DatabaseEdition>]
[-MaxSizeGB <Int32>]
[-MaxSizeBytes <Int64>]
[-ServiceObjective <ServiceObjective>]
[-PassThru]
[-Force]
[-Sync]
[-Profile <AzureSMProfile>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-AzureSqlDatabase
-ServerName <String>
-Database <Database>
[-NewDatabaseName <String>]
[-Edition <DatabaseEdition>]
[-MaxSizeGB <Int32>]
[-MaxSizeBytes <Int64>]
[-ServiceObjective <ServiceObjective>]
[-PassThru]
[-Force]
[-Sync]
[-Profile <AzureSMProfile>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Set-AzureSqlDatabase Cmdlet 會設定 Azure SQL 資料庫 的屬性。 您可以依名稱指定資料庫,或透過管線傳遞 Azure SQL 資料庫 物件。 您可以依名稱指定伺服器,或傳遞 Azure SQL 資料庫 伺服器連線內容。 執行 New-AzureSqlDatabaseServerContext Cmdlet 來建立連線內容。 如果您依名稱指定伺服器,Cmdlet 會使用目前的 Azure 訂用帳戶資訊來驗證要求。
範例
範例 1:使用連接內容變更資料庫的大小
PS C:\> $Database01 = Get-AzureSqlDatabase -ConnectionContext $Context -DatabaseName "Database01"
PS C:\> Set-AzureSqlDatabase -ConnectionContext $Context -Database $Database01 -MaxSizeGB 20
本範例會將 Azure SQL 資料庫 伺服器連線內容$Context中名為 Database01 的資料庫大小變更為 20 GB。
範例 2:使用伺服器名稱變更資料庫的大小
PS C:\> $Database01 = Get-AzureSqlDatabase -ServerName "lpqd0zbr8y" -DatabaseName "Database01"
PS C:\> Set-AzureSqlDatabase -ServerName "lpqd0zbr8y" -Database $Database01 -MaxSizeGB 20
此範例會將名為 Database01 的資料庫大小變更為 lpqd0zbr8y 伺服器中的 20 GB。
參數
-Confirm
執行 Cmdlet 之前先提示您確認。
類型: | SwitchParameter |
別名: | cf |
Position: | Named |
預設值: | False |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ConnectionContext
指定伺服器的連接內容。
類型: | IServerDataServiceContext |
別名: | Context |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-Database
指定物件,表示此 Cmdlet 修改的 Azure SQL 資料庫。
類型: | Database |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-DatabaseName
指定這個 Cmdlet 修改的資料庫名稱。
類型: | String |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-Edition
指定 Azure SQL 資料庫 的新版本。 有效值為:
- 無
- Web
- 業務
- 基本
- Standard
- Premium
類型: | DatabaseEdition |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Force
允許動作完成,而不提示您進行確認。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-MaxSizeBytes
以位元組為單位指定資料庫的新大小上限。 您可以指定此參數或 MaxSizeGB 參數。 如需以版本為基礎的可接受值,請參閱 MaxSizeGB 參數。
類型: | Int64 |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-MaxSizeGB
指定以 GB 為單位之資料庫的新大小上限。 您可以指定此參數或 MaxSizeBytes 參數。 可接受的值會根據版本而有所不同。
基本版本值:1 或 2
Standard Edition 值:1、2、5、10、20、30、40、50、100、150、200 或 250
Premium Edition 值:1、2、5、10、20、30、40、50、100、150、200、250、300、400 或 500
Web 版本值:1 或 5
Business Edition 值:10、20、30、40、50、100 或 150
類型: | Int32 |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-NewDatabaseName
指定資料庫的新名稱。
類型: | String |
別名: | NewName |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-PassThru
傳回更新的 Azure SQL 資料庫。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Profile
指定此 Cmdlet 從中讀取的 Azure 設定檔。 如果您未指定設定檔,此 Cmdlet 會從本機預設配置檔讀取。
類型: | AzureSMProfile |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ServerName
指定包含此 Cmdlet 修改之資料庫的伺服器名稱。
類型: | String |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-ServiceObjective
指定物件,表示這個資料庫的新服務目標(效能等級)。 有效值為:
- 基本:dd6d99bb-f193-4ec1-86f2-43d3bccbc49c
- 標準 (S0): f1173c43-91bd-4aaa-973c-54e79e15235b
- 標準 (S1): 1b1ebd4d-d903-4baa-97f9-4ea675f5e928
- 標準 (S2): 455330e1-00cd-488b-b5fa-177c226f28b7
- *標準 (S3): 789681b8-ca10-4eb0-bdf2-e0b050601b40
- Premium (P1): 7203483a-c4fb-4304-9e9f-17c71c904f5d
- Premium (P2): a7d1b92d-c987-4375-b54d-2b1d0e0f5bb0
- Premium (P3):a7c4c615-cfb1-464b-b252-925be0a19446
*標準 (S3) 是最新 SQL 資料庫 更新 V12 (預覽) 的一部分。 如需詳細資訊,請參閱 Azure SQL 資料庫 V12 預覽版的新功能https://azure.microsoft.com/documentation/articles/sql-database-preview-whats-new/.
類型: | ServiceObjective |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Sync
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-WhatIf
顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。
類型: | SwitchParameter |
別名: | wi |
Position: | Named |
預設值: | False |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
輸入
Microsoft.WindowsAzure.Commands.SqlDatabase.Services.Server.Database
輸出
Microsoft.WindowsAzure.Commands.SqlDatabase.Services.Server.Database