Set-AzureSqlDatabase

  • リファレンス
モジュール:
Azure

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

Note

このドキュメントで参照されているコマンドレットは、Azure Service Manager (ASM) API を使用する従来の Azure リソースを管理するためのものです。 ASM の提供終了が予定されているため、新しいリソースを作成する場合、このレガシ PowerShell モジュールは推奨されません。 詳細については、Azure Service Manager の提供終了に関するページを参照してください。

Az PowerShell モジュールは、PowerShell を使用して Azure Resource Manager (ARM) リソースを管理するために推奨される 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

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

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

-ConnectionContext

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

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

-Database

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

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

-DatabaseName

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

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

-Edition

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

  • なし
  • Web
  • ビジネス
  • Basic
  • Standard
  • Premium
型:DatabaseEdition
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Force

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

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

-MaxSizeBytes

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

型:Int64
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る: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

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

-NewDatabaseName

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

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

-PassThru

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

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

-Profile

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

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

-ServerName

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

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る: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/.

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

-Sync

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

-WhatIf

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

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

入力

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

出力

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