Remove-AzureSqlDatabase
Elimina una base de datos de Azure SQL.
Nota:
Los cmdlets a los que se hace referencia en esta documentación son para administrar recursos de Azure heredados que usan las API de Azure Service Management (ASM). Este módulo heredado de PowerShell no se recomienda al crear nuevos recursos, ya que ASM está programado para la retirada. Para más información, consulte Retirada de Azure Service Manager.
El módulo Az de PowerShell es el módulo de PowerShell recomendado para administrar recursos de Azure Resource Manager (ARM) con PowerShell.
Sintaxis
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>] Description
El cmdlet Remove-AzureSqlDatabase elimina una instancia de Azure SQL Database por contexto de conexión del servidor o nombre del servidor. Puede crear un contexto de conexión del servidor de Azure SQL Database mediante el cmdlet New-AzureSqlDatabaseServerContext y, a continuación, usarlo con este cmdlet.
Al eliminar una base de datos especificando un nombre de servidor de Azure SQL Database, el cmdlet Remove-AzureSqlDatabase usa el nombre y la información actual de la suscripción de Azure para realizar la operación.
Ejemplos
Ejemplo 1: Quitar una base de datos
PS C:\> Remove-AzureSqlDatabase -ConnectionContext $Context -DatabaseName "Database01"Este comando quita la base de datos denominada Database01 del contexto de conexión del servidor de Azure SQL Database $Context.
Ejemplo 2: Quitar una base de datos mediante un nombre de servidor
PS C:\> Remove-AzureSqlDatabase -ServerName "lpqd0zbr8y" -DatabaseName "Database01"Este comando quita la base de datos denominada Database01 del servidor de Azure SQL Database denominado lpqd0zbr8y.
Ejemplo 3: Eliminación de una base de datos mediante la canalización
PS C:\> $Database01 | Remove-AzureSqlDatabase -ConnectionContext $Context
PS C:\> $Database01 | Remove-AzureSqlDatabase -ServerName "lpqd0zbr8y"En este ejemplo se muestra el método alternativo de pasar el objeto de base de datos a través de la canalización.
Parámetros
-Confirm
Le solicita su confirmación antes de ejecutar el cmdlet.
| Tipo: | SwitchParameter |
| Alias: | cf |
| Posición: | Named |
| Valor predeterminado: | False |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-ConnectionContext
Especifica el contexto de conexión de un servidor del que este cmdlet quita una base de datos.
| Tipo: | IServerDataServiceContext |
| Alias: | Context |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-Database
Especifica un objeto que representa la base de datos que quita este cmdlet.
| Tipo: | Database |
| Alias: | InputObject |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-DatabaseName
Especifica el nombre de la base de datos que quita este cmdlet.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Force
Permite que la acción se complete sin pedir confirmación al usuario.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Profile
Especifica el perfil de Azure del que lee este cmdlet. Si no especifica un perfil, este cmdlet lee del perfil predeterminado local.
| Tipo: | AzureSMProfile |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-ServerName
Especifica el nombre del servidor en el que este cmdlet elimina la base de datos.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-WhatIf
Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.
| Tipo: | SwitchParameter |
| Alias: | wi |
| Posición: | Named |
| Valor predeterminado: | False |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
Entradas
Microsoft.WindowsAzure.Commands.SqlDatabase.Services.Server.Database
Notas
- Debido a la gravedad de la operación, de forma predeterminada, este cmdlet le pide confirmación. Para omitir la confirmación, especifique el parámetro Force .