共用方式為


New-AzSqlDatabase

建立資料庫或彈性資料庫。

語法

DtuBasedDatabase (預設值)

New-AzSqlDatabase
    [-ServerName] <String>
    [-ResourceGroupName] <String>
    -DatabaseName <String>
    [-CollationName <String>]
    [-CatalogCollation <String>]
    [-MaxSizeBytes <Int64>]
    [-Edition <String>]
    [-RequestedServiceObjectiveName <String>]
    [-ElasticPoolName <String>]
    [-ReadScale <DatabaseReadScale>]
    [-Tags <Hashtable>]
    [-SampleName <String>]
    [-ZoneRedundant]
    [-AsJob]
    [-Force]
    [-LicenseType <String>]
    [-AutoPauseDelayInMinutes <Int32>]
    [-MinimumCapacity <Double>]
    [-HighAvailabilityReplicaCount <Int32>]
    [-BackupStorageRedundancy <String>]
    [-SecondaryType <String>]
    [-MaintenanceConfigurationId <String>]
    [-EnableLedger]
    [-PreferredEnclaveType <String>]
    [-AssignIdentity]
    [-EncryptionProtector <String>]
    [-UserAssignedIdentityId <String[]>]
    [-KeyList <String[]>]
    [-FederatedClientId <Guid>]
    [-EncryptionProtectorAutoRotation]
    [-UseFreeLimit]
    [-FreeLimitExhaustionBehavior <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

VcoreBasedDatabase

New-AzSqlDatabase
    [-ServerName] <String>
    [-ResourceGroupName] <String>
    -DatabaseName <String>
    -Edition <String>
    -VCore <Int32>
    -ComputeGeneration <String>
    [-CollationName <String>]
    [-CatalogCollation <String>]
    [-MaxSizeBytes <Int64>]
    [-ReadScale <DatabaseReadScale>]
    [-Tags <Hashtable>]
    [-SampleName <String>]
    [-ZoneRedundant]
    [-AsJob]
    [-Force]
    [-LicenseType <String>]
    [-ComputeModel <String>]
    [-AutoPauseDelayInMinutes <Int32>]
    [-MinimumCapacity <Double>]
    [-HighAvailabilityReplicaCount <Int32>]
    [-BackupStorageRedundancy <String>]
    [-SecondaryType <String>]
    [-MaintenanceConfigurationId <String>]
    [-EnableLedger]
    [-PreferredEnclaveType <String>]
    [-AssignIdentity]
    [-EncryptionProtector <String>]
    [-UserAssignedIdentityId <String[]>]
    [-KeyList <String[]>]
    [-FederatedClientId <Guid>]
    [-EncryptionProtectorAutoRotation]
    [-UseFreeLimit]
    [-FreeLimitExhaustionBehavior <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

New-AzSqlDatabase Cmdlet 會建立 Azure SQL 資料庫。 您也可以將 ElasticPoolName 參數設定為現有的彈性集區,以建立彈性資料庫。

範例

範例 1:在指定的伺服器上建立資料庫

New-AzSqlDatabase -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DatabaseName "Database01"
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     : f1173c43-91bd-4aaa-973c-54e79e15235b
CurrentServiceObjectiveName   : S0
RequestedServiceObjectiveId   : f1173c43-91bd-4aaa-973c-54e79e15235b
RequestedServiceObjectiveName :
ElasticPoolName               :
EarliestRestoreDate           :
LicenseType                   :
Tags                          :
EnableLedger                  : False

此指令在伺服器 Server01 上建立名為 Database01 的資料庫。

範例 2:在指定的伺服器上建立彈性資料庫

New-AzSqlDatabase -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DatabaseName "Database02" -ElasticPoolName "ElasticPool01"
ResourceGroupName             : ResourceGroup01
ServerName                    : Server01
DatabaseName                  : Database02
Location                      : Central US
DatabaseId                    : 7bd9d561-42a7-484e-bf05-62ddef8015ab
Edition                       : Standard
CollationName                 : SQL_Latin1_General_CP1_CI_AS
CatalogCollation              :
MaxSizeBytes                  : 268435456000
Status                        : Online
CreationDate                  : 8/26/2015 10:04:29 PM
CurrentServiceObjectiveId     : d1737d22-a8ea-4de7-9bd0-33395d2a7419
CurrentServiceObjectiveName   : ElasticPool
RequestedServiceObjectiveId   : d1737d22-a8ea-4de7-9bd0-33395d2a7419
RequestedServiceObjectiveName :
ElasticPoolName               : ElasticPool01
EarliestRestoreDate           :
LicenseType                   :
Tags                          :
EnableLedger                  : False

此命令會在伺服器 Server01 上名為 ElasticPool01 的彈性集區中建立名為 Database02 的資料庫。

範例 3:在指定的伺服器上建立虛擬核心資料庫

New-AzSqlDatabase -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DatabaseName "Database03" -Edition "GeneralPurpose" -Vcore 2 -ComputeGeneration "Gen4"
ResourceGroupName             : ResourceGroup01
ServerName                    : Server01
DatabaseName                  : Database03
Location                      : Central US
DatabaseId                    : 34d9d561-42a7-484e-bf05-62ddef8000ab
Edition                       : GeneralPurpose
CollationName                 : SQL_Latin1_General_CP1_CI_AS
CatalogCollation              :
MaxSizeBytes                  : 268435456000
Status                        : Online
CreationDate                  : 8/26/2015 10:04:29 PM
CurrentServiceObjectiveName   : GP_Gen4_2
RequestedServiceObjectiveName :
ElasticPoolName               :
EarliestRestoreDate           :
LicenseType                   : LicenseIncluded
Tags                          :
EnableLedger                  : False

此命令會在伺服器 Server01 上建立名為 Database03 的虛擬核心資料庫。

範例 4:在指定的伺服器上建立無伺服器資料庫

New-AzSqlDatabase -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DatabaseName "Database04" -Edition "GeneralPurpose" -Vcore 2 -ComputeGeneration "Gen5" -ComputeModel Serverless
ResourceGroupName             : ResourceGroup01
ServerName                    : Server01
DatabaseName                  : Database04
Location                      : Central US
DatabaseId                    : ef5a9698-012c-4def-8d94-7f6bfb7b4f04
Edition                       : GeneralPurpose
CollationName                 : SQL_Latin1_General_CP1_CI_AS
CatalogCollation              :
MaxSizeBytes                  : 34359738368
Status                        : Online
CreationDate                  : 4/12/2019 11:20:29 PM
CurrentServiceObjectiveName   : GP_S_Gen5_2
RequestedServiceObjectiveName : GP_S_Gen5_2
ElasticPoolName               :
EarliestRestoreDate           : 4/12/2019 11:50:29 PM
Tags                          :
CreateMode                    :
ReadScale                     : Disabled
ZoneRedundant                 : False
Capacity                      : 2
Family                        : Gen5
SkuName                       : GP_S_Gen5
LicenseType                   : LicenseIncluded
AutoPauseDelayInMinutes       : 360
EnableLedger                  : False
MinimumCapacity          : 0.5

此命令在伺服器 Server01 上建立名為 Database04 的無伺服器資料庫。

範例 5:建立設定慣用記憶體保護區類型為 VBS 的資料庫

New-AzSqlDatabase -ResourceGroupName "ResourceGroup01" -DatabaseName "Database01" -ServerName "Server01" -Edition "GeneralPurpose" -Vcore 2 -ComputeGeneration "Gen5" -PreferredEnclaveType "VBS"
ResourceGroupName             : ResourceGroup01
ServerName                    : Server01
DatabaseName                  : Database01
Location                      : Central US
DatabaseId                    : 34d9d561-42a7-484e-bf05-62ddef8000ab
Edition                       : GeneralPurpose
CollationName                 : SQL_Latin1_General_CP1_CI_AS
CatalogCollation              :
MaxSizeBytes                  : 268435456000
Status                        : Online
CreationDate                  : 8/26/2015 10:04:29 PM
CurrentServiceObjectiveName   : GP_Gen5_2
RequestedServiceObjectiveName :
ElasticPoolName               :
EarliestRestoreDate           :
LicenseType                   : LicenseIncluded
Tags                          :
EnableLedger                  : False
PreferredEnclaveType          : VBS

此命令會建立設定 VBS 記憶體保護區的資料庫

參數

-AsJob

在背景執行 Cmdlet

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-AssignIdentity

產生並指派此資料庫的 Microsoft Entra 身分識別,以與 Azure KeyVault 等金鑰管理服務搭配使用。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-AutoPauseDelayInMinutes

資料庫 (僅限無伺服器) 的自動暫停延遲 (以分鐘為單位),-1 選擇退出

參數屬性

類型:Int32
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-BackupStorageRedundancy

用來儲存 SQL 資料庫備份的備份儲存備援。 選項包括:本地、區域和地理。

參數屬性

類型:String
預設值:None
接受的值:Local, Zone, Geo, GeoZone
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-CatalogCollation

指定 SQL 資料庫目錄定序的名稱。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-CollationName

指定 SQL 資料庫定序的名稱。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ComputeGeneration

要指派的計算產生。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False
別名:家庭

參數集

VcoreBasedDatabase
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ComputeModel

Azure SQL 資料庫的計算模型。 無伺服器或佈建

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

VcoreBasedDatabase
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Confirm

在執行 Cmdlet 之前,提示您進行確認。

參數屬性

類型:SwitchParameter
預設值:False
支援萬用字元:False
不要顯示:False
別名:參見

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-DatabaseName

指定資料庫的名稱。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False
別名:名稱

參數集

(All)
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-DefaultProfile

用來與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶

參數屬性

類型:IAzureContextContainer
預設值:None
支援萬用字元:False
不要顯示:False
別名:AzContext, AzureRmContext, AzureCredential

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Edition

指定要指派給資料庫的版本。 此參數可接受的值為:

  • None
  • 基本
  • 標準
  • 進階
  • 資料倉儲
  • 免費
  • Stretch
  • 通用目的
  • 關鍵業務

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

DtuBasedDatabase
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ElasticPoolName

指定要放置資料庫的彈性集區名稱。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

DtuBasedDatabase
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-EnableLedger

建立分類帳資料庫,其中所有資料的完整性都受到分類帳功能的保護。 總賬資料庫中的所有數據表都必須是總賬數據表。 注意:建立資料庫之後,就無法變更此屬性的值。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-EncryptionProtector

SQL Database 的加密保護程式金鑰。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-EncryptionProtectorAutoRotation

AKV 鑰匙自動旋轉狀態

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-FederatedClientId

SQL Database 的同盟用戶端標識碼。 它用於跨租使用者 CMK 案例。

參數屬性

類型:

Nullable<T>[Guid]

預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Force

略過執行動作的確認訊息

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-FreeLimitExhaustionBehavior

自由限度資料庫的耗盡行為。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-HighAvailabilityReplicaCount

與可路由傳送只讀應用程式意圖連接之資料庫的唯讀次要複本數目。 此屬性僅適用於超大規模資料庫。

參數屬性

類型:Int32
預設值:None
支援萬用字元:False
不要顯示:False
別名:讀取複本計數

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-KeyList

SQL Database 的 AKV 金鑰清單。

參數屬性

類型:

String[]

預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-LicenseType

Azure Sql 資料庫的授權類型。 可能的值為:

  • BasePrice - 套用現有 SQL Server 授權擁有者的 Azure Hybrid Benefit (AHB) 折扣定價。 現有 SQL Server 授權擁有者的資料庫價格將打折。
  • LicenseIncluded - 不會套用現有 SQL Server 授權擁有者的 Azure 混合式權益 (AHB) 折扣定價。 資料庫價格將包含新的 SQL Server 授權費用。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-MaintenanceConfigurationId

SQL 資料庫的維護組態識別碼。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-MaxSizeBytes

指定資料庫的大小上限 (以位元組為單位)。

參數屬性

類型:Int64
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-MinimumCapacity

資料庫將一律配置的最小容量 (如果未暫停)。 僅適用於無伺服器 Azure SQL 資料庫。

參數屬性

類型:Double
預設值:None
支援萬用字元:False
不要顯示:False
別名:MinV可, 最小容量

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-PreferredEnclaveType

Azure Sql 資料庫的慣用記憶體保護區類型。 可能的值為 Default 和 VBS。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ReadScale

如果啟用,將應用程式意圖設定為其連接字串中的唯讀連線,可能會路由傳送至唯讀次要複本。 此屬性僅適用於 Premium 和 Business Critical 資料庫。

參數屬性

類型:DatabaseReadScale
預設值:None
接受的值:Disabled, Enabled
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-RequestedServiceObjectiveName

指定要指派給資料庫的服務目標名稱。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

DtuBasedDatabase
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ResourceGroupName

指定指派伺服器的資源群組名稱。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:0
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-SampleName

建立這個資料庫時要套用的範例架構名稱。

參數屬性

類型:String
預設值:None
接受的值:AdventureWorksLT
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-SecondaryType

如果資料庫是輔助資料庫,則為次要類型。 有效值為 Geo 和 Named。

參數屬性

類型:String
預設值:None
接受的值:Named, Geo
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ServerName

指定裝載資料庫之伺服器名稱。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:1
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-Tags

以雜湊表的形式指定索引鍵/值組的字典,此 Cmdlet 會與新資料庫產生關聯。 例如:@{key0=“value0”;key1=$null;key2=“值2”}

參數屬性

類型:Hashtable
預設值:None
支援萬用字元:False
不要顯示:False
別名:標記

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-UseFreeLimit

在此資料庫上使用免費限制。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-UserAssignedIdentityId

SQL Database 的使用者指派身分識別清單。

參數屬性

類型:

String[]

預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-VCore

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

參數屬性

類型:Int32
預設值:None
支援萬用字元:False
不要顯示:False
別名:容量, 最大V更, 最大容量

參數集

VcoreBasedDatabase
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 指令未執行。

參數屬性

類型:SwitchParameter
預設值:False
支援萬用字元:False
不要顯示:False
別名:威斯康辛

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ZoneRedundant

要與 Azure SQL 資料庫相關聯的區域備援

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

CommonParameters

此 cmdlet 支援常見參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters

輸入

String

輸出

AzureSqlDatabaseModel