Share via


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 パラメーターを指定します。