New-AzSqlElasticPool

リファレンス

モジュール:: Az.Sql

SQL Database のエラスティックデータベースプールを作成します。

構文

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

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

説明

New-AzSqlElasticPool コマンドレットは、Azure SQL Database 用のエラスティックデータベースプールを作成します。複数のパラメーター (-Dtu、-DatabaseDtuMin、および -DatabaseDtuMax) では、そのパラメーターの有効な値の一覧から値を設定する必要があります。たとえば、Standard 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 という名前の Standard サービスレベルにエラスティックプールを作成します。 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 という名前の GengeralPurpose サービスレベルにエラスティックプールを作成します。 ResourceGroup01 という名前の Azure リソースグループに割り当てられた server01 という名前のサーバーは、エラスティックプールをホストします。このコマンドは、プールとプール内のデータベースの仮想コアプロパティ値を指定します。

例 3

SQL Database のエラスティックデータベースプールを作成します。 (自動生成)

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

バックグラウンドでコマンドレットを実行する

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ComputeGeneration

割り当てるコンピューティング世代。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

型:	SwitchParameter
Aliases:	cf
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DatabaseDtuMax

プール内の任意の単一データベースが使用できるデータベーススループットユニット (DTU) の最大数を指定します。各エディションの既定値は次のとおりです。

ベーシック。 5 DTU
Standard。 100 DTU
Premium。 125 DTU 有効な値の詳細については、エラスティックプール内の特定のサイズプールの表を参照してください

型:	Int32
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DatabaseDtuMin

エラスティックプールがプール内のすべてのデータベースに対して保証する DTU の最小数を指定します。既定値は 0 です。有効な値の詳細については、弾性プール内の特定のサイズプールの表を参照してください。

型:	Int32
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DatabaseVCoreMax

プール内で SqlAzure Database が使用できる仮想コアの最大数。

型:	Double
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DatabaseVCoreMin

プール内で使用できる SqlAzure データベースの仮想コアの最小数。

型:	Double
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DefaultProfile

Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション

型:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Dtu

エラスティックプールの共有 DTU の合計数を指定します。各エディションの既定値は次のとおりです。

ベーシック。 100 DTU
Standard。 100 DTU
Premium。 125 DTU 有効な値の詳細については、弾性プール内の特定のサイズプールの表を参照してください。

型:	Int32
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Edition

エラスティックプールに使用される Azure SQL Database のエディションを指定します。このパラメーターの有効値は、次のとおりです。

なし
Basic
Standard
Premium
DataWarehouse
Free
Stretch
GeneralPurpose
BusinessCritical

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ElasticPoolName

このコマンドレットで作成するエラスティックプールの名前を指定します。

型:	String
Aliases:	Name
配置:	2
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-HighAvailabilityReplicaCount

エラスティックプールに関連付けられている高可用性レプリカの合計数。

型:	Int32
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-LicenseType

Azure Sql データベースのライセンスの種類。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-MaintenanceConfigurationId

SQL エラスティックプールのメンテナンス構成 ID。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PreferredEnclaveType

Azure SQL エラスティックプールに推奨されるエンクレーブの種類。使用できる値は Default と VBS です。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ResourceGroupName

このコマンドレットがエラスティックプールを割り当てるリソースグループの名前を指定します。

型:	String
配置:	0
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-ServerName

エラスティックプールをホストするサーバーの名前を指定します。

型:	String
配置:	1
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-StorageMB

エラスティックプールの記憶域の制限をメガバイト単位で指定します。このパラメーターを指定しない場合、このコマンドレットは、 Dtu パラメーターの値に依存する値を計算します。使用可能な値については、eDTU とストレージの制限に関するセクションをご覧ください。

型:	Int32
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Tags

キーと値のペアのディクショナリを、このコマンドレットがエラスティックプールに関連付けるハッシュテーブルの形式で指定します。例: @{key0="value0";key1=$null;key2="value2"}

型:	Hashtable
Aliases:	Tag
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-VCore

Sql Azure エラスティックプールの仮想コアの合計共有数。

型:	Int32
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-WhatIf

コマンドレットの実行時に発生する内容を示します。このコマンドレットは実行されません。

型:	SwitchParameter
Aliases:	wi
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ZoneRedundant

Azure Sql エラスティックプールに関連付けるゾーン冗長性

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

入力

String

次の方法で共有

New-AzSqlElasticPool

構文

説明

例

例 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

入力

出力

その他のリソース

次の方法で共有

New-AzSqlElasticPool

構文

説明

例

例 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

入力

出力

関連リンク

その他のリソース

例 1: DTU エラスティックプールを作成する

例 2: 仮想コアエラスティックプールを作成する

例 4: 優先エンクレーブの種類を VBS として使用してエラスティックプールを作成する