Remove-AzureSqlDatabase
Exclui um Banco de Dados SQL do Azure.
Nota
Os cmdlets mencionados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs do Azure Service Manager (ASM). Este módulo do PowerShell herdado não é recomendado ao criar novos recursos, uma vez que o ASM está agendado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.
O módulo Az PowerShell é o módulo PowerShell recomendado para gerenciar recursos do Azure Resource Manager (ARM) com o PowerShell.
Sintaxe
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
O cmdlet Remove-AzureSqlDatabase exclui um Banco de Dados SQL do Azure por contexto de conexão de servidor ou nome de servidor. Você pode criar um contexto de conexão de servidor do Banco de Dados SQL do Azure usando o cmdlet New-AzureSqlDatabaseServerContext e usá-lo com esse cmdlet.
Quando você exclui um banco de dados especificando um nome de servidor do Banco de Dados SQL do Azure, o cmdlet Remove-AzureSqlDatabase usa o nome e as informações de assinatura atuais do Azure para executar a operação.
Exemplos
Exemplo 1: Remover um banco de dados
PS C:\> Remove-AzureSqlDatabase -ConnectionContext $Context -DatabaseName "Database01"Este comando remove o banco de dados chamado Database01 do $Context de contexto de conexão do servidor do Banco de Dados SQL do Azure.
Exemplo 2: Remover um banco de dados usando um nome de servidor
PS C:\> Remove-AzureSqlDatabase -ServerName "lpqd0zbr8y" -DatabaseName "Database01"Este comando remove o banco de dados chamado Database01 do servidor do Banco de Dados SQL do Azure chamado lpqd0zbr8y.
Exemplo 3: Remover um banco de dados usando o pipeline
PS C:\> $Database01 | Remove-AzureSqlDatabase -ConnectionContext $Context
PS C:\> $Database01 | Remove-AzureSqlDatabase -ServerName "lpqd0zbr8y"Este exemplo demonstra o método alternativo de passar o objeto de banco de dados pelo pipeline.
Parâmetros
-Confirm
Solicita a sua confirmação antes de executar o cmdlet.
| Tipo: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-ConnectionContext
Especifica o contexto de conexão de um servidor do qual esse cmdlet remove um banco de dados.
| Tipo: | IServerDataServiceContext |
| Aliases: | Context |
| Position: | Named |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-Database
Especifica um objeto que representa o banco de dados removido por esse cmdlet.
| Tipo: | Database |
| Aliases: | InputObject |
| Position: | Named |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-DatabaseName
Especifica o nome do banco de dados que esse cmdlet remove.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-Force
Permite que a ação seja concluída sem solicitar a confirmação do usuário.
| Tipo: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-Profile
Especifica o perfil do Azure a partir do qual este cmdlet é lido. Se você não especificar um perfil, esse cmdlet será lido a partir do perfil padrão local.
| Tipo: | AzureSMProfile |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-ServerName
Especifica o nome do servidor no qual esse cmdlet exclui o banco de dados.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-WhatIf
Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.
| Tipo: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
Entradas
Microsoft.WindowsAzure.Commands.SqlDatabase.Services.Server.Database
Notas
- Devido à gravidade da operação, por padrão, esse cmdlet solicita a confirmação. Para ignorar a confirmação, especifique o parâmetro Force .