New-AzureSqlDatabase
Azure SQL Database を作成します。
Note
このドキュメントで参照されているコマンドレットは、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
- 事業
- Basic
- Standard
- Premium
既定値は 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 (プレビュー) の一部です。 詳細については、「Azure SQL Database V12 プレビューの新機能」を参照してください。https://azure.microsoft.com/documentation/articles/sql-database-preview-whats-new/.
| 型: | 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 コマンドレットを使用します。