Set-AzureRmSqlElasticPool

リファレンス

モジュール:: AzureRM.Sql

Azure SQL Database のエラスティックデータベースプールのプロパティを変更します。

警告

AzureRM PowerShell モジュールは、2024 年 2 月 29 日の時点で正式に非推奨になりました。引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。

AzureRM モジュールは引き続き機能する可能性がありますが、メインが維持またはサポートされなくなり、ユーザーの判断とリスクで引き続き使用できます。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。

構文

Set-AzureRmSqlElasticPool
   [-ElasticPoolName] <String>
   [-Edition <String>]
   [-Dtu <Int32>]
   [-StorageMB <Int32>]
   [-DatabaseDtuMin <Int32>]
   [-DatabaseDtuMax <Int32>]
   [-Tags <Hashtable>]
   [-ZoneRedundant]
   [-LicenseType <String>]
   [-AsJob]
   [-ServerName] <String>
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzureRmSqlElasticPool
   [-ElasticPoolName] <String>
   [-Edition <String>]
   [-StorageMB <Int32>]
   [-VCore <Int32>]
   [-ComputeGeneration <String>]
   [-DatabaseVCoreMin <Double>]
   [-DatabaseVCoreMax <Double>]
   [-Tags <Hashtable>]
   [-ZoneRedundant]
   [-LicenseType <String>]
   [-AsJob]
   [-ServerName] <String>
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

Set-AzureRmSqlElasticPool コマンドレットは、Azure SQL Database のエラスティックプールのプロパティを設定します。このコマンドレットは、プールあたりの eDTU (Dtu)、プールあたりの記憶域の最大サイズ (ストレージMB (メガバイト))、データベースあたりの最大 eDTU (DatabaseDtuMax)、およびデータベースあたりの最小 eDTU (DatqabaseDtuMin) を変更できます。いくつかのパラメーター (-Dtu、-DatabaseDtuMin、および -DatabaseDtuMax) では、設定する値がそのパラメーターの有効な値の一覧から取得されている必要があります。たとえば、Standard 100 eDTU プールの -DatabaseDtuMax は、10、20、50、または 100 にのみ設定できます。有効な値の詳細については、エラスティックプール内の特定のサイズプールの表を参照してください。

例

例 1: エラスティックプールのプロパティを変更する

PS C:\>Set-AzureRmSqlDatabaseElasticPool -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: エラスティックプールのストレージの最大サイズを変更する

PS C:\>Set-AzureRmSqlDatabaseElasticPool -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 (テラバイト)に設定します。

パラメーター

-AsJob

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

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

-ComputeGeneration

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

型:	String
Aliases:	Family
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	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 データベースの最大仮想コア数。

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

-DatabaseVCoreMin

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

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

-DefaultProfile

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

型:	IAzureContextContainer
Aliases:	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
引き伸ばし
GeneralPurpose
BusinessCritical

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

-ElasticPoolName

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

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

-LicenseType

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

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

-ResourceGroupName

エラスティックプールが割り当てられているリソースグループの名前を指定します。

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

-ServerName

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

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

-StorageMB

エラスティックプールの記憶域の制限をメガバイト単位で指定します。詳細については、New-AzureRmSqlElasticPool コマンドレットを参照してください。

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

-Tags

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

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

-VCore

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

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

-WhatIf

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

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

-ZoneRedundant

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

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

入力

String

次の方法で共有

Set-AzureRmSqlElasticPool

構文

説明

例

例 1: エラスティックプールのプロパティを変更する

例 2: エラスティックプールのストレージの最大サイズを変更する

パラメーター

-AsJob

-ComputeGeneration

-Confirm

-DatabaseDtuMax

-DatabaseDtuMin

-DatabaseVCoreMax

-DatabaseVCoreMin

-DefaultProfile

-Dtu

-Edition

-ElasticPoolName

-LicenseType

-ResourceGroupName

-ServerName

-StorageMB

-Tags

-VCore

-WhatIf

-ZoneRedundant

入力

出力

その他のリソース

次の方法で共有

Set-AzureRmSqlElasticPool

構文

説明

例

例 1: エラスティック プールのプロパティを変更する

例 2: エラスティック プールのストレージの最大サイズを変更する

パラメーター

-AsJob

-ComputeGeneration

-Confirm

-DatabaseDtuMax

-DatabaseDtuMin

-DatabaseVCoreMax

-DatabaseVCoreMin

-DefaultProfile

-Dtu

-Edition

-ElasticPoolName

-LicenseType

-ResourceGroupName

-ServerName

-StorageMB

-Tags

-VCore

-WhatIf

-ZoneRedundant

入力

出力

関連リンク

その他のリソース

例 1: エラスティックプールのプロパティを変更する

例 2: エラスティックプールのストレージの最大サイズを変更する