Remove-AzureSqlDatabase
Azure SQL Database を削除します。
注意
このドキュメントで参照されているコマンドレットは、Service Management API を使用するレガシ Azure リソースを管理するためのものです。 Azure Resource Manager リソースを管理するためのコマンドレットについては、Az 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
コマンドレットの実行前に確認を求めるメッセージが表示されます。
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
このコマンドレットが削除するデータベースを表すオブジェクトを指定します。
Type: | Database |
Aliases: | InputObject |
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 |
-Force
ユーザーに確認を求めずにアクションを完了できるようにします。
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 |
-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
メモ
- 操作の重大度のため、既定では、このコマンドレットは確認を求めるメッセージを表示します。 確認をスキップするには、Force パラメーターを指定します。