Set-AzSqlElasticPool

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

構文

Set-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>]
Set-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>]

説明

Set-AzSqlElasticPool コマンドレットは、Azure SQL Database のエラスティック プールのプロパティを設定します。 このコマンドレットでは、プールあたりの eDTU (Dtu)、プールあたりの記憶域の最大サイズ (ストレージMB (メガバイト))、データベースあたりの最大 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 のエラスティック データベース プールのプロパティを変更します。 (自動生成)

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

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ComputeGeneration

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

Type:String
Aliases:Family
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DatabaseDtuMax

プール内の任意の単一データベースが使用できる DTU の最大数を指定します。 有効な値の詳細については、エラスティック プール内の特定のサイズ プールの表を参照してください。 各エディションの既定値は次のとおりです。

  • ベーシック。 5 DTU
  • Standard。 100 DTU
  • Premium。 125 DTU
Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DatabaseDtuMin

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DatabaseVCoreMax

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

Type:Double
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DatabaseVCoreMin

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

Type:Double
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Dtu

エラスティック プールの共有 DTU の合計数を指定します。 有効な値の詳細については、エラスティック プール内の特定のサイズ プールの表を参照してください。 各エディションの既定値は次のとおりです。

  • ベーシック。 100 DTU
  • Standard。 100 DTU
  • Premium。 125 DTU
Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Edition

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

  • なし
  • Basic
  • Standard
  • Premium
  • DataWarehouse
  • Free
  • Stretch
  • GeneralPurpose
  • BusinessCritical
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ElasticPoolName

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

Type:String
Aliases:Name
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-HighAvailabilityReplicaCount

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LicenseType

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaintenanceConfigurationId

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PreferredEnclaveType

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

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

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ServerName

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

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-StorageMB

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Tags

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

Type:Hashtable
Aliases:Tag
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VCore

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ZoneRedundant

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

入力

String

出力

AzureSqlElasticPoolModel