New-AzSqlElasticPool
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 |
入力
出力
関連リンク
Azure PowerShell