Remove-AzureSqlDatabase

Löscht eine Azure SQL-Datenbank.

Hinweis

Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Dienstverwaltungs-APIs verwenden. Cmdlets zum Verwalten von Azure Ressource Manager-Ressourcen finden Sie im Az PowerShell-Modul.

Syntax

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>]

Beschreibung

Das Cmdlet Remove-AzureSqlDatabase löscht eine Azure SQL-Datenbank nach Serververbindungskontext oder Servername. Sie können einen Azure SQL-Datenbankserververbindungskontext mit dem Cmdlet New-AzureSqlDatabaseServerContext erstellen und dann mit diesem Cmdlet verwenden.

Wenn Sie eine Datenbank löschen, indem Sie einen Azure SQL-Datenbankservernamen angeben, verwendet das Cmdlet Remove-AzureSqlDatabase den Namen und die aktuellen Azure-Abonnementinformationen, um den Vorgang auszuführen.

Beispiele

Beispiel 1: Entfernen einer Datenbank

PS C:\> Remove-AzureSqlDatabase -ConnectionContext $Context -DatabaseName "Database01"

Mit diesem Befehl wird die Datenbank namens "Database01" aus dem Azure SQL-Datenbankserververbindungskontext $Context entfernt.

Beispiel 2: Entfernen einer Datenbank mithilfe eines Servernamens

PS C:\> Remove-AzureSqlDatabase -ServerName "lpqd0zbr8y" -DatabaseName "Database01"

Mit diesem Befehl wird die Datenbank namens "Database01" vom Azure SQL-Datenbankserver mit dem Namen "lpqd0zbr8y" entfernt.

Beispiel 3: Entfernen einer Datenbank mithilfe der Pipeline

PS C:\> $Database01 | Remove-AzureSqlDatabase -ConnectionContext $Context
PS C:\> $Database01 | Remove-AzureSqlDatabase -ServerName "lpqd0zbr8y"

In diesem Beispiel wird die alternative Methode zum Übergeben des Datenbankobjekts durch die Pipeline veranschaulicht.

Parameter

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ConnectionContext

Gibt den Verbindungskontext eines Servers an, von dem dieses Cmdlet eine Datenbank entfernt.

Type:IServerDataServiceContext
Aliases:Context
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Database

Gibt ein Objekt an, das die Datenbank darstellt, die dieses Cmdlet entfernt.

Type:Database
Aliases:InputObject
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DatabaseName

Gibt den Namen der Datenbank an, die dieses Cmdlet entfernt.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Force

Ermöglicht die Ausführung der Aktion, ohne den Benutzer zur Bestätigung aufzufordern.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Profile

Gibt das Azure-Profil an, aus dem dieses Cmdlet liest. Wenn Sie kein Profil angeben, liest dieses Cmdlet aus dem lokalen Standardprofil.

Type:AzureSMProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServerName

Gibt den Namen des Servers an, auf dem dieses Cmdlet die Datenbank löscht.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

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

Hinweise

  • Aufgrund des Schweregrads des Vorgangs werden Sie standardmäßig von diesem Cmdlet zur Bestätigung aufgefordert. Um die Bestätigung zu überspringen, geben Sie den Force-Parameter an.