Remove-AzureSqlDatabase
Azure SQL Database を削除します。
Note
このドキュメントで参照されているコマンドレットは、Azure Service Manager (ASM) API を使用するレガシ Azure リソースを管理するためのものです。 ASM の廃止が予定されているため、新しいリソースを作成する場合、このレガシ PowerShell モジュールは推奨されません。 詳細については、「Azure Service Manager の廃止」を参照してください。
Az PowerShell モジュールは、PowerShell を使用して Azure Resource Manager (ARM) リソースを管理するための推奨される PowerShell モジュールです。
構文
Remove-AzureSqlDatabase
-ConnectionContext <IServerDataServiceContext>
-DatabaseName <String>
[-Force]
[-Profile <AzureSMProfile>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-AzureSqlDatabase
-ConnectionContext <IServerDataServiceContext>
-Database <Database>
[-Force]
[-Profile <AzureSMProfile>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-AzureSqlDatabase
-ServerName <String>
-DatabaseName <String>
[-Force]
[-Profile <AzureSMProfile>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-AzureSqlDatabase
-ServerName <String>
-Database <Database>
[-Force]
[-Profile <AzureSMProfile>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Remove-AzureSqlDatabase コマンドレットは、サーバー接続コンテキストまたはサーバー名によって Azure SQL Database を削除します。 New-AzureSqlDatabaseServerContext コマンドレットを使用して Azure SQL Database サーバー接続コンテキストを作成し、このコマンドレットで使用できます。
Azure SQL Database サーバー名を指定してデータベースを削除すると、 Remove-AzureSqlDatabase コマンドレットは名前と現在の Azure サブスクリプション情報を使用して操作を実行します。
例
例 1: データベースを削除する
PS C:\> Remove-AzureSqlDatabase -ConnectionContext $Context -DatabaseName "Database01"
このコマンドは、Azure SQL Database サーバー接続コンテキスト $Contextから Database01 という名前のデータベースを削除します。
例 2: サーバー名を使用してデータベースを削除する
PS C:\> Remove-AzureSqlDatabase -ServerName "lpqd0zbr8y" -DatabaseName "Database01"
このコマンドは、lpqd0zbr8y という名前の Azure SQL Database サーバーから Database01 という名前のデータベースを削除します。
例 3: パイプラインを使用してデータベースを削除する
PS C:\> $Database01 | Remove-AzureSqlDatabase -ConnectionContext $Context
PS C:\> $Database01 | Remove-AzureSqlDatabase -ServerName "lpqd0zbr8y"
この例では、パイプラインを介してデータベース オブジェクトを渡す別の方法を示します。
パラメーター
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ConnectionContext
このコマンドレットがデータベースを削除するサーバーの接続コンテキストを指定します。
型: | IServerDataServiceContext |
Aliases: | Context |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Database
このコマンドレットが削除するデータベースを表すオブジェクトを指定します。
型: | Database |
Aliases: | InputObject |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-DatabaseName
このコマンドレットによって削除されるデータベースの名前を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Force
ユーザーに確認を求めずにアクションを完了できるようにします。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Profile
このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。
型: | AzureSMProfile |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ServerName
このコマンドレットがデータベースを削除するサーバーの名前を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
Microsoft.WindowsAzure.Commands.SqlDatabase.Services.Server.Database
メモ
- 操作の重大度のため、既定では、このコマンドレットは確認を求めるメッセージを表示します。 確認をスキップするには、Force パラメーターを指定します。