Set-AzSqlElasticPool
Azure SQL Database のエラスティック データベース プールのプロパティを変更します。
構文
DtuBasedPool (既定)
Set-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
Set-AzSqlElasticPool
[-ElasticPoolName] <String>
[-ServerName] <String>
[-ResourceGroupName] <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]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Set-AzSqlElasticPool コマンドレットは、Azure SQL Database のエラスティック プールのプロパティを設定します。 このコマンドレットは、プールあたりの eDTU (Dtu)、プールあたりの記憶域の最大サイズ (StorageMB)、データベースあたりの最大 eDTU (DatabaseDtuMax)、およびデータベースあたりの最小 eDTU (DatabaseDtuMin) を変更できます。
複数のパラメーター (-Dtu、-DatabaseDtuMin、および -DatabaseDtuMax) では、そのパラメーターの有効な値の一覧から値を設定する必要があります。 たとえば、Standard 100 eDTU プールの -DatabaseDtuMax は、10、20、50、または 100 にのみ設定できます。 有効な値の詳細については、 弾性プール内の特定のサイズ プールの表を参照してください。
例
例 1: エラスティック プールのプロパティを変更する
Set-AzSqlElasticPool -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -ElasticPoolName "ElasticPool01" -Dtu 1000 -DatabaseDtuMax 100 -DatabaseDtuMin 20
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 : 200
DatabaseDtuMax : 100
DatabaseDtuMin : 20
StorageMB : 204800
Tags :
このコマンドは、elasticpool01 という名前のエラスティック プールのプロパティを変更します。 このコマンドは、エラスティック プールの DTU の数を 1000 に設定し、最小 DTU と最大 DTU を設定します。
例 2: エラスティック プールのストレージの最大サイズを変更する
Set-AzSqlElasticPool -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -ElasticPoolName "ElasticPool01" -StorageMB 2097152
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 : Premium
Dtu : 200
DatabaseDtuMax : 100
DatabaseDtuMin : 20
StorageMB : 2097152
Tags :
このコマンドは、elasticpool01 という名前のエラスティック プールのプロパティを変更します。 このコマンドは、エラスティック プールの最大ストレージを 2 TB に設定します。
例 3
Azure SQL Database のエラスティック データベース プールのプロパティを変更します。 (autogenerated)
Set-AzSqlElasticPool -Dtu 1000 -Edition 'GeneralPurpose' -ElasticPoolName 'ElasticPool01' -ResourceGroupName 'ResourceGroup01' -ServerName 'Server01'
例 4: エラスティック プールの優先エンクレーブの種類を VBS に変更する
Set-AzSqlElasticPool -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -ElasticPoolName "ElasticPool01" -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/26/2015 10:00:17 PM
State : Ready
Edition : Premium
Dtu : 200
DatabaseDtuMax : 100
DatabaseDtuMin : 20
StorageMB : 2097152
PreferredEnclaveType : VBS
Tags :
このコマンドは、エラスティック プールを更新して、その上に VBS エンクレーブを構成します
パラメーター
-AsJob
バックグラウンドでコマンドレットを実行する
パラメーターのプロパティ
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-ComputeGeneration
割り当てるコンピューティング世代。
パラメーターのプロパティ
型: | String
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
Aliases: | ファミリ |
パラメーター セット
VcoreBasedPool
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
パラメーターのプロパティ
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-DatabaseDtuMax
プール内の任意の単一データベースが使用できる DTU の最大数を指定します。
有効な値の詳細については、 弾性プール内の特定のサイズ プールの表を参照してください。
各エディションの既定値は次のとおりです。
- 基本。 5 DTU
- Standard。 100 DTU
- Premium。 125 DTU
パラメーターのプロパティ
型: | Int32
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
DtuBasedPool
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-DatabaseDtuMin
エラスティック プールがプール内のすべてのデータベースに対して保証する DTU の最小数を指定します。
有効な値の詳細については、 弾性プール内の特定のサイズ プールの表を参照してください。
既定値は 0 です。
パラメーターのプロパティ
型: | Int32
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
DtuBasedPool
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-DatabaseVCoreMax
プール内で SqlAzure Database が使用できる仮想コアの最大数。
パラメーターのプロパティ
型: | Double
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
VcoreBasedPool
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-DatabaseVCoreMin
プール内で使用できる SqlAzure データベースの仮想コアの最小数。
パラメーターのプロパティ
型: | Double
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
VcoreBasedPool
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション
パラメーターのプロパティ
型: | IAzureContextContainer
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
Aliases: | AzContext, AzureRmContext, AzureCredential |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Dtu
エラスティック プールの共有 DTU の合計数を指定します。
有効な値の詳細については、 弾性プール内の特定のサイズ プールの表を参照してください。
各エディションの既定値は次のとおりです。
- 基本。 100 DTU
- Standard。 100 DTU
- Premium。 125 DTU
パラメーターのプロパティ
型: | Int32
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
DtuBasedPool
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Edition
エラスティック プールの Azure SQL Database のエディションを指定します。 エディションを変更することはできません。 このパラメーターに使用できる値は次のとおりです。
- 無し
- Basic
- Standard
- Premium
- DataWarehouse
- Free
- Stretch
- GeneralPurpose
- ビジネスクリティカル
パラメーターのプロパティ
型: | String
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-ElasticPoolName
エラスティック プールの名前を指定します。
パラメーターのプロパティ
型: | String
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
Aliases: | 名前 |
パラメーター セット
(All)
配置: | 2 |
必須: | True |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | True |
残りの引数からの値: | False |
-HighAvailabilityReplicaCount
エラスティック プールに関連付けられている高可用性レプリカの合計数。
パラメーターのプロパティ
型: | Int32
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-LicenseType
Azure Sql データベースのライセンスの種類。
パラメーターのプロパティ
型: | String
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-MaintenanceConfigurationId
SQL エラスティック プールのメンテナンス構成 ID。
パラメーターのプロパティ
型: | String
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-PreferredEnclaveType
Azure SQL エラスティック プールに推奨されるエンクレーブの種類。 使用できる値は Default と VBS です。
パラメーターのプロパティ
型: | String
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-ResourceGroupName
エラスティック プールが割り当てられているリソース グループの名前を指定します。
パラメーターのプロパティ
型: | String
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | 0 |
必須: | True |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | True |
残りの引数からの値: | False |
-ServerName
エラスティック プールをホストするサーバーの名前を指定します。
パラメーターのプロパティ
型: | String
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | 1 |
必須: | True |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | True |
残りの引数からの値: | False |
-StorageMB
エラスティック プールの記憶域の制限をメガバイト単位で指定します。 詳細については、New-AzSqlElasticPool コマンドレットを参照してください。
パラメーターのプロパティ
型: | Int32
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
このコマンドレットがエラスティック プールに関連付けるキーと値のペアのディクショナリをハッシュ テーブルの形式で指定します。 例: @{key0="value0";"key 1"=$null;key2="value2"}
型: | Hashtable
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
Aliases: | タグ |
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-VCore
Sql Azure エラスティック プールの仮想コアの合計共有数。
パラメーターのプロパティ
型: | Int32
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
VcoreBasedPool
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。
コマンドレットは実行されません。
パラメーターのプロパティ
型: | SwitchParameter
|
規定値: | False |
ワイルドカードのサポート: | False |
DontShow: | False |
Aliases: | ウィスコンシン |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-ZoneRedundant
Azure Sql エラスティック プールに関連付けるゾーン冗長性
パラメーターのプロパティ
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
出力