New-AzureSqlDatabase

モジュール:

Azure

Azure SQL Database を作成します。

注

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

Az PowerShell モジュールは、PowerShell を使用して Azure Resource Manager (ARM) リソースを管理するための推奨される PowerShell モジュールです。

構文

New-AzureSqlDatabase
   -ConnectionContext <IServerDataServiceContext>
   -DatabaseName <String>
   [-Collation <String>]
   [-Edition <DatabaseEdition>]
   [-ServiceObjective <ServiceObjective>]
   [-MaxSizeGB <Int32>]
   [-MaxSizeBytes <Int64>]
   [-Force]
   [-Profile <AzureSMProfile>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureSqlDatabase
   -ServerName <String>
   -DatabaseName <String>
   [-Collation <String>]
   [-Edition <DatabaseEdition>]
   [-ServiceObjective <ServiceObjective>]
   [-MaxSizeGB <Int32>]
   [-MaxSizeBytes <Int64>]
   [-Force]
   [-Profile <AzureSMProfile>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

New-AzureSqlDatabase コマンドレットは、Azure SQL Database を作成します。 New-AzureSqlDatabaseServerContext コマンドレットを使用して作成する Azure SQL Database サーバー接続コンテキストを使用して、サーバーを指定できます。 または、サーバー名を指定した場合、コマンドレットは現在の Azure サブスクリプション情報を使用して、サーバーへのアクセス要求を認証します。

Azure SQL Database サーバーを指定して新しいデータベースを作成すると、New-AzureSqlDatabase コマンドレットは、指定したサーバー名と現在の Azure サブスクリプション情報を使用して一時的な接続コンテキストを作成して操作を実行します。

例

例 1: データベースを作成する

PS C:\> $Database01 = New-AzureSqlDatabase -ConnectionContext $Context -DatabaseName "Database01" -Edition "Business" -MaxSizeGB 50 -Collation "SQL_Latin1_General_CP1_CI_AS"

このコマンドは、Azure SQL Database サーバー接続コンテキスト $Context用に、Database1 という名前の Azure SQL Database を作成します。

例 2: 現在のサブスクリプションにデータベースを作成する

PS C:\> $Database01 = New-AzureSqlDatabase -ServerName "lpqd0zbr8y" -DatabaseName "Database01" -Edition "Business" -MaxSizeGB 50 -Collation "SQL_Latin1_General_CP1_CI_AS"

この例では、指定された lpqd0zbr8y という名前の Azure SQL Database サーバーに Database1 という名前のデータベースを作成します。 このコマンドレットは、現在の Azure サブスクリプション情報を使用して、サーバーにアクセスするための要求を認証します。

パラメーター

-Collation

新しいデータベースの照合順序を指定します。

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

-Confirm

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

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

-ConnectionContext

このコマンドレットがデータベースを作成するサーバーの接続コンテキストを指定します。

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

-DatabaseName

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

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

-Edition

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

• なし
• ウェブ
• 事業
• ベーシック
• スタンダード
• プレミアム

既定値は Web です。

型:	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

-Profile

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

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

-ServerName

新しいデータベースを格納する Azure SQL Database サーバーの名前を指定します。

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

-ServiceObjective

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

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

*Standard (S3) は、最新の SQL Database Update V12 (プレビュー) の一部です。

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

-WhatIf

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

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

出力

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

メモ

• New-AzureSqlDatabase によって作成されたデータベースを削除するには、Remove-AzureSqlDatabase コマンドレットを使用します。

関連リンク

• Azure SQL データベース
• データベースの作成
• Azure SQL データベースの操作
• Get-AzureSqlDatabase
• New-AzureSqlDatabaseServerContext
• Remove-AzureSqlDatabase
• Set-AzureSqlDatabase