New-AzSqlElasticPool

模組:: Az.Sql Module

建立 SQL 資料庫的彈性資料庫集區。

語法

DtuBasedPool (預設值)

New-AzSqlElasticPool
    [-ElasticPoolName] <String>
    [-ServerName] <String>
    [-ResourceGroupName] <String>
    [-Edition <String>]
    [-Dtu <Int32>]
    [-StorageMB <Int32>]
    [-DatabaseDtuMin <Int32>]
    [-DatabaseDtuMax <Int32>]
    [-Tags <Hashtable>]
    [-ZoneRedundant]
    [-LicenseType <String>]
    [-MaintenanceConfigurationId <String>]
    [-HighAvailabilityReplicaCount <Int32>]
    [-PreferredEnclaveType <String>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

VcoreBasedPool

New-AzSqlElasticPool
    [-ElasticPoolName] <String>
    [-ServerName] <String>
    [-ResourceGroupName] <String>
    -Edition <String>
    -VCore <Int32>
    -ComputeGeneration <String>
    [-StorageMB <Int32>]
    [-DatabaseVCoreMin <Double>]
    [-DatabaseVCoreMax <Double>]
    [-Tags <Hashtable>]
    [-ZoneRedundant]
    [-LicenseType <String>]
    [-MaintenanceConfigurationId <String>]
    [-HighAvailabilityReplicaCount <Int32>]
    [-PreferredEnclaveType <String>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

New-AzSqlElasticPool Cmdlet 會建立 Azure SQL 資料庫的彈性資料庫集區。數個參數（-Dtu、-DatabaseDtuMin 和 -DatabaseDtuMax）需要設定的值來自該參數的有效值清單。例如，標準 100 eDTU 集區的 -DatabaseDtuMax 只能設定為 10、20、50 或 100。如需哪些值有效的詳細資訊，請參閱彈性集區中特定大小集區的資料表。

範例

範例 1：建立 DTU 彈性集區

New-AzSqlElasticPool -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -ElasticPoolName "ElasticPool01" -Edition "Standard" -Dtu 400 -DatabaseDtuMin 10 -DatabaseDtuMax 100

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               : 400
DatabaseDtuMax    : 100
DatabaseDtuMin    : 10
StorageMB         : 409600
Tags              :

此命令會在名為 ElasticPool01 的標準服務層級中建立彈性集區。指派給名為 ResourceGroup01 的 Azure 資源群組的名為 server01 的伺服器會裝載彈性集區。此命令會指定集區和集區中資料庫的 DTU 屬性值。

範例 2：建立虛擬核心彈性集區

New-AzSqlElasticPool -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -ElasticPoolName "ElasticPool01" -Edition "GeneralPurpose" -vCore 2 -ComputeGeneration Gen5

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/29/2019 2:16:40 AM
State               : Ready
Edition             : GeneralPurpose
SkuName             : GP_Gen5
Dtu                 : 2
DatabaseDtuMax      : 2
DatabaseDtuMin      : 0
Capacity            : 2
DatabaseCapacityMin : 0
DatabaseCapacityMax : 2
Family              : Gen5
MaxSizeBytes        : 34359738368
StorageMB           : 32768
Tags                :

此命令會在名為 ElasticPool01 的一般用途服務層級中建立彈性集區。指派給名為 ResourceGroup01 的 Azure 資源群組的名為 server01 的伺服器會裝載彈性集區。此命令會指定集區和集區中資料庫的虛擬核心屬性值。

範例 3

建立 SQL 資料庫的彈性資料庫集區。 (autogenerated)

New-AzSqlElasticPool -ComputeGeneration Gen5 -Edition 'GeneralPurpose' -ElasticPoolName 'ElasticPool01' -ResourceGroupName 'ResourceGroup01' -ServerName 'Server01' -StorageMB 2097152 -VCore 2

範例 4：建立彈性集區，並將慣用記憶體保護區類型設為 VBS

New-AzSqlElasticPool -ComputeGeneration Gen5 -Edition 'GeneralPurpose' -ElasticPoolName 'ElasticPool01' -ResourceGroupName 'ResourceGroup01' -ServerName 'Server01' -VCore 2 -PreferredEnclaveType 'VBS'

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/29/2019 2:16:40 AM
State               : Ready
Edition             : GeneralPurpose
SkuName             : GP_Gen5
Dtu                 : 2
DatabaseDtuMax      : 2
DatabaseDtuMin      : 0
Capacity            : 2
DatabaseCapacityMin : 0
DatabaseCapacityMax : 2
Family              : Gen5
MaxSizeBytes        : 34359738368
StorageMB           : 32768
PreferredEnclaveType: VBS
Tags                :

此命令會建立設定有 VBS 記憶體保護區的彈性集區

參數

-AsJob

在背景執行 Cmdlet

參數屬性

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

參數集

(All)

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

-ComputeGeneration

要指派的計算產生。

參數屬性

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

參數集

VcoreBasedPool

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

-Confirm

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

參數屬性

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

參數集

(All)

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

-DatabaseDtuMax

指定集區中任何單一資料庫可取用的資料庫輸送量單位（DTU）數目上限。不同版本的預設值如下：

基本。 5 個 DTU
標準。 100 個 DTU
保險費。 125 個 DTU 如需哪些值有效的詳細資訊，請參閱彈性集區中特定大小集區的資料表

參數屬性

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

參數集

DtuBasedPool

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

-DatabaseDtuMin

指定彈性集區保證集區中所有資料庫的最小 DTU 數目。預設值為零 (0)。如需哪些值有效的詳細資訊，請參閱彈性集區中特定大小集區的資料表。

參數屬性

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

參數集

DtuBasedPool

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

-DatabaseVCoreMax

任何 SqlAzure 資料庫都可以在集區中使用的 VCore 數目上限。

參數屬性

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

參數集

VcoreBasedPool

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

-DatabaseVCoreMin

任何 SqlAzure 資料庫可以在集區中使用的最小 VCore 數目。

參數屬性

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

參數集

VcoreBasedPool

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

-DefaultProfile

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

參數屬性

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

參數集

(All)

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

-Dtu

指定彈性集區的共用 DTU 總數。不同版本的預設值如下：

基本。 100 個 DTU
標準。 100 個 DTU
保險費。 125 個 DTU 如需哪些值有效的詳細資訊，請參閱彈性集區中特定大小集區的資料表。

參數屬性

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

參數集

DtuBasedPool

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

-Edition

指定用於彈性集區的 Azure SQL 資料庫版本。此參數可接受的值為：

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

參數屬性

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

參數集

DtuBasedPool

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

-ElasticPoolName

指定此 Cmdlet 所建立的彈性集區名稱。

參數屬性

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

參數集

(All)

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

-HighAvailabilityReplicaCount

與彈性集區相關聯的高可用性複本總數。

參數屬性

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

參數集

(All)

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

-LicenseType

Azure Sql 資料庫的授權類型。

參數屬性

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

參數集

(All)

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

-MaintenanceConfigurationId

SQL 彈性集區的維護組態識別碼。

參數屬性

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

參數集

(All)

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

-PreferredEnclaveType

Azure SQL 彈性集區的慣用記憶體保護區類型。可能的值為 Default 和 VBS。

參數屬性

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

參數集

(All)

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

-ResourceGroupName

指定此 Cmdlet 指派彈性集區之資源群組名稱。

參數屬性

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

參數集

(All)

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

-ServerName

指定裝載彈性集區之伺服器名稱。

參數屬性

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

參數集

(All)

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

-StorageMB

指定彈性集區的儲存體限制（以 MB 為單位）。如果您未指定此參數，此 Cmdlet 會計算相依於 Dtu 參數值的值。如需可能的值，請參閱 eDTU 和儲存體限制。

參數屬性

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

參數集

(All)

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

-Tags

以雜湊表的形式指定索引鍵值組的字典，此 Cmdlet 會與彈性集區產生關聯。例如：@{key0=“value0”;key1=$null;key2=“值2”}

參數屬性

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

參數集

(All)

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

-VCore

Sql Azure 彈性集區的共用虛擬核心總數。

參數屬性

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

參數集

VcoreBasedPool

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。

共用方式為

New-AzSqlElasticPool

語法

DtuBasedPool (預設值)

VcoreBasedPool

Description

範例

範例 1：建立 DTU 彈性集區

範例 2：建立虛擬核心彈性集區

範例 3

範例 4：建立彈性集區，並將慣用記憶體保護區類型設為 VBS

參數

-AsJob

參數屬性

參數集

-ComputeGeneration

參數屬性

參數集

-Confirm

參數屬性

參數集

-DatabaseDtuMax

參數屬性

參數集

-DatabaseDtuMin

參數屬性

參數集

-DatabaseVCoreMax

參數屬性

參數集

-DatabaseVCoreMin

參數屬性

參數集

-DefaultProfile

參數屬性

參數集

-Dtu

參數屬性

參數集

-Edition

參數屬性

參數集

-ElasticPoolName

參數屬性

參數集

-HighAvailabilityReplicaCount

參數屬性

參數集

-LicenseType

參數屬性

參數集

-MaintenanceConfigurationId

參數屬性

參數集

-PreferredEnclaveType

參數屬性

參數集

-ResourceGroupName

參數屬性

參數集

-ServerName

參數屬性

參數集

-StorageMB

參數屬性

參數集

-Tags

參數屬性

參數集

-VCore

參數屬性

參數集

-WhatIf

參數屬性

參數集

-ZoneRedundant

參數屬性

參數集

CommonParameters

輸入