共用方式為


New-AzureSqlDatabase

建立 Azure SQL 資料庫。

注意

本文件中參考的 Cmdlet 用於管理使用 Azure Service Manager(ASM) API 的舊版 Azure 資源。 建立新的資源時,不建議使用此舊版 PowerShell 模組,因為 ASM 已排定淘汰。 如需詳細資訊,請參閱 Azure Service Manager 淘汰

Az PowerShell 模組是使用 PowerShell 管理 Azure Resource Manager (ARM) 資源的建議 PowerShell 模組。

語法

New-AzureSqlDatabase
   -ConnectionContext <IServerDataServiceContext>
   -DatabaseName <String>
   [-Collation <String>]
   [-Edition <DatabaseEdition>]
   [-ServiceObjective <ServiceObjective>]
   [-MaxSizeGB <Int32>]
   [-MaxSizeBytes <Int64>]
   [-Force]
   [-Profile <AzureSMProfile>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzureSqlDatabase
   -ServerName <String>
   -DatabaseName <String>
   [-Collation <String>]
   [-Edition <DatabaseEdition>]
   [-ServiceObjective <ServiceObjective>]
   [-MaxSizeGB <Int32>]
   [-MaxSizeBytes <Int64>]
   [-Force]
   [-Profile <AzureSMProfile>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

New-AzureSqlDatabase Cmdlet 會建立 Azure SQL 資料庫。 您可以使用使用 New-AzureSqlDatabaseServerContext Cmdlet 建立的 Azure SQL 資料庫 伺服器連線內容來指定伺服器。 或者,如果您指定伺服器名稱,Cmdlet 會使用目前的 Azure 訂用帳戶資訊來驗證存取伺服器的要求。

當您藉由指定 Azure SQL 資料庫 伺服器來建立新的資料庫時,New-AzureSqlDatabase Cmdlet 會使用指定的伺服器名稱和目前的 Azure 訂用帳戶資訊來建立暫時連接內容,以執行作業。

範例

範例 1:建立資料庫

PS C:\> $Database01 = New-AzureSqlDatabase -ConnectionContext $Context -DatabaseName "Database01" -Edition "Business" -MaxSizeGB 50 -Collation "SQL_Latin1_General_CP1_CI_AS"

此命令會針對 Azure SQL 資料庫 伺服器連線內容建立名為 Database1 的 Azure SQL 資料庫 $Context。

範例 2:在目前的訂用帳戶中建立資料庫

PS C:\> $Database01 = New-AzureSqlDatabase -ServerName "lpqd0zbr8y" -DatabaseName "Database01" -Edition "Business" -MaxSizeGB 50 -Collation "SQL_Latin1_General_CP1_CI_AS"

此範例會在名為 lpqd0zbr8y 的指定 Azure SQL 資料庫 伺服器中,建立名為 Database1 的資料庫。 Cmdlet 會使用目前的 Azure 訂用帳戶資訊來驗證存取伺服器的要求。

參數

-Collation

指定新資料庫的定序。

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

-Confirm

執行 Cmdlet 之前先提示您確認。

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

-ConnectionContext

指定此 Cmdlet 建立資料庫之伺服器的連接內容。

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

-DatabaseName

指定新資料庫的名稱。

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

-Edition

指定新 Azure SQL 資料庫 的版本。 有效值為:

  • Web
  • 業務
  • 基本
  • Standard
  • Premium

預設值為 Web。

類型: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

-Profile

指定此 Cmdlet 從中讀取的 Azure 設定檔。 如果您未指定設定檔,此 Cmdlet 會從本機預設配置檔讀取。

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

-ServerName

指定要包含新資料庫的 Azure SQL 資料庫 伺服器名稱。

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

-ServiceObjective

指定物件,表示這個資料庫的新服務目標(效能等級)。 此值代表指派給此資料庫的資源層級。 有效值為:

基本:dd6d99bb-f193-4ec1-86f2-43d3bccbc49c Standard (S0): f1173c43-91bd-4aaa-973c-54e79e15235b 標準 (S1): 1b1ebd4d-1d903-4baa-97f9-4ea675f5e928 Standard (S2): 455330e1-00cd-488b-b5fa-177c226f28b7 *Standard (S3): 789681b8-ca10-4eb0-bdf2-e0b050601b40 Premium (P1): 7203483a-c4fb-4304-9e9f-17c71c904f5d 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

-WhatIf

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

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

輸出

Microsoft.WindowsAzure.Commands.SqlDatabase.Services.Server.Database

備註

  • 若要刪除 New-AzureSqlDatabase建立的資料庫,請使用 Remove-AzureSqlDatabase Cmdlet。