Share via


Set-AzureSqlDatabase

Azure SQL Database のプロパティを設定します。

注意

このドキュメントで参照されているコマンドレットは、Service Management API を使用するレガシ Azure リソースを管理するためのものです。 Azure Resource Manager リソースを管理するためのコマンドレットについては、Az PowerShell モジュールを参照してください。

構文

Set-AzureSqlDatabase
   -ConnectionContext <IServerDataServiceContext>
   -DatabaseName <String>
   [-NewDatabaseName <String>]
   [-Edition <DatabaseEdition>]
   [-MaxSizeGB <Int32>]
   [-MaxSizeBytes <Int64>]
   [-ServiceObjective <ServiceObjective>]
   [-PassThru]
   [-Force]
   [-Sync]
   [-Profile <AzureSMProfile>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzureSqlDatabase
   -ConnectionContext <IServerDataServiceContext>
   -Database <Database>
   [-NewDatabaseName <String>]
   [-Edition <DatabaseEdition>]
   [-MaxSizeGB <Int32>]
   [-MaxSizeBytes <Int64>]
   [-ServiceObjective <ServiceObjective>]
   [-PassThru]
   [-Force]
   [-Sync]
   [-Profile <AzureSMProfile>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzureSqlDatabase
   -ServerName <String>
   -DatabaseName <String>
   [-NewDatabaseName <String>]
   [-Edition <DatabaseEdition>]
   [-MaxSizeGB <Int32>]
   [-MaxSizeBytes <Int64>]
   [-ServiceObjective <ServiceObjective>]
   [-PassThru]
   [-Force]
   [-Sync]
   [-Profile <AzureSMProfile>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzureSqlDatabase
   -ServerName <String>
   -Database <Database>
   [-NewDatabaseName <String>]
   [-Edition <DatabaseEdition>]
   [-MaxSizeGB <Int32>]
   [-MaxSizeBytes <Int64>]
   [-ServiceObjective <ServiceObjective>]
   [-PassThru]
   [-Force]
   [-Sync]
   [-Profile <AzureSMProfile>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

Set-AzureSqlDatabase コマンドレットは、Azure SQL Database のプロパティを設定します。 名前でデータベースを指定するか、パイプラインを介して Azure SQL Database オブジェクトを渡すことができます。 サーバーを名前で指定するか、Azure SQL Database サーバー接続コンテキストを渡すことができます。 New-AzureSqlDatabaseServerContext コマンドレットを 実行して、接続コンテキストを 作成します。 サーバーを名前で指定した場合、コマンドレットは現在の Azure サブスクリプション情報を使用して要求を認証します。

例 1: 接続コンテキストを使用してデータベースのサイズを変更する

PS C:\> $Database01 = Get-AzureSqlDatabase -ConnectionContext $Context -DatabaseName "Database01"
PS C:\> Set-AzureSqlDatabase -ConnectionContext $Context -Database $Database01 -MaxSizeGB 20

この例では、Azure SQL Database サーバー接続コンテキストで Database01 という名前のデータベースのサイズを 20 GB に変更$Context。

例 2: サーバー名を使用してデータベースのサイズを変更する

PS C:\> $Database01 = Get-AzureSqlDatabase -ServerName "lpqd0zbr8y" -DatabaseName "Database01"
PS C:\> Set-AzureSqlDatabase -ServerName "lpqd0zbr8y" -Database $Database01 -MaxSizeGB 20

次の使用例は、lpqd0zbr8y という名前のサーバーの Database01 という名前のデータベースのサイズを 20 GB に変更します。

パラメーター

-Confirm

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

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

-ConnectionContext

サーバーの接続コンテキストを指定します。

Type:IServerDataServiceContext
Aliases:Context
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Database

このコマンドレットが変更する Azure SQL Database を表すオブジェクトを指定します。

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

-DatabaseName

このコマンドレットが変更するデータベースの名前を指定します。

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

-Edition

Azure SQL Database の新しいエディションを指定します。 有効な値は次のとおりです。

  • なし
  • Web
  • Business
  • Basic
  • Standard
  • Premium
Type:DatabaseEdition
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

確認を求めずにアクションを完了できるようにします。

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

-MaxSizeBytes

データベースの新しい最大サイズをバイト単位で指定します。 このパラメーターまたは MaxSizeGB パラメーターを指定できます。 エディションに 基づく許容値については、MaxSizeGB パラメーターを参照してください。

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

-MaxSizeGB

データベースの新しい最大サイズをギガバイト単位で指定します。 このパラメーターまたは MaxSizeBytes パラメーターを指定できます。 許容される値は、エディションによって異なります。

基本エディションの値: 1 または 2

Standard Edition の値: 1、2、5、10、20、30、40、50、100、150、200、または 250

Premium Edition の値: 1、2、5、10、20、30、40、50、100、150、200、250、300、400、または 500

Web エディションの値: 1 または 5

Business Edition の値: 10、20、30、40、50、100、または 150

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

-NewDatabaseName

データベースの新しい名前を指定します。

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

-PassThru

更新された Azure SQL Database を返します。

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

-Profile

このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。

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

-ServerName

このコマンドレットが変更するデータベースを含むサーバーの名前を指定します。

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

-ServiceObjective

このデータベースの新しいサービス目標 (パフォーマンス レベル) を表すオブジェクトを指定します。 有効な値は次のとおりです。

  • Basic: dd6d99bb-f193-4ec1-86f2-43d3bccbc49c
  • Standard (S0): f1173c43-91bd-4aaa-973c-54e79e15235b
  • Standard (S1): 1b1ebd4d-d903-4baa-97f9-4ea675f5e928
  • Standard (S2): 455330e1-00cd-488b-b5fa-177c226f28b7
  • *Standard (S3): 789681b8-ca10-4eb0-bdf2-e0b050601b40
  • Premium (P1): 7203483a-c4fb-4304-9e9f-17c71c904f5d
  • Premium (P2): a7d1b92d-c987-4375-b54d-2b1d0e0f5bb0
  • Premium (P3): a7c4c615-cfb1-464b-b252-925be0a19446

*Standard (S3) は、最新の SQL Database Update V12 (プレビュー) の一部です。 詳細については、「Azure SQL Database V12 プレビューの新機能」を参照してください。https://azure.microsoft.com/documentation/articles/sql-database-preview-whats-new/.

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

-Sync

Type:SwitchParameter
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

入力

Microsoft.WindowsAzure.Commands.SqlDatabase.Services.Server.Database

出力

Microsoft.WindowsAzure.Commands.SqlDatabase.Services.Server.Database