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 Azure Dienst-Manager (ASM) APIs verwenden. Dieses ältere PowerShell-Modul wird beim Erstellen neuer Ressourcen nicht empfohlen, da ASM für den Ruhestand geplant ist. Weitere Informationen finden Sie unter Einstellung des Azure Service Manager.
Das Az PowerShell-Modul ist das empfohlene PowerShell-Modul zum Verwalten von Azure Resource Manager (ARM)-Ressourcen mit PowerShell.
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-Datenbank Serververbindungskontext mit dem Cmdlet New-AzureSqlDatabaseServerContext erstellen und dann mit diesem Cmdlet verwenden.
Wenn Sie eine Datenbank löschen, indem Sie einen Azure SQL-Datenbank Servernamen 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 "Database01" aus dem Azure SQL-Datenbank Serververbindungskontext $Context entfernt.
Beispiel 2: Entfernen einer Datenbank mithilfe eines Servernamens
PS C:\> Remove-AzureSqlDatabase -ServerName "lpqd0zbr8y" -DatabaseName "Database01"Mit diesem Befehl wird die Datenbank "Database01" aus dem Azure SQL-Datenbank Server 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.
| Typ: | SwitchParameter |
| Aliase: | cf |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ConnectionContext
Gibt den Verbindungskontext eines Servers an, von dem dieses Cmdlet eine Datenbank entfernt.
| Typ: | IServerDataServiceContext |
| Aliase: | Context |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-Database
Gibt ein Objekt an, das die Datenbank darstellt, die dieses Cmdlet entfernt.
| Typ: | Database |
| Aliase: | InputObject |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-DatabaseName
Gibt den Namen der Datenbank an, die dieses Cmdlet entfernt.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Force
Ermöglicht die Ausführung der Aktion, ohne den Benutzer zur Bestätigung aufzufordern.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Profile
Gibt das Azure-Profil an, aus dem dieses Cmdlet liest. Wenn Sie kein Profil angeben, liest dieses Cmdlet aus dem lokalen Standardprofil.
| Typ: | AzureSMProfile |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ServerName
Gibt den Namen des Servers an, auf dem dieses Cmdlet die Datenbank löscht.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-WhatIf
Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
| Typ: | SwitchParameter |
| Aliase: | wi |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | 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.