Remove-AzureSqlDatabase
Exclui um Banco de Dados SQL do Azure.
Observação
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 herdado do PowerShell não é recomendado ao criar novos recursos, já que o ASM está programado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.
O módulo Az PowerShell é o módulo do 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"
Esse comando remove o banco de dados chamado Database01 do contexto de conexão do servidor do Banco de Dados SQL do Azure $Context.
Exemplo 2: Remover um banco de dados usando um nome de servidor
PS C:\> Remove-AzureSqlDatabase -ServerName "lpqd0zbr8y" -DatabaseName "Database01"
Esse 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 sua confirmação antes de executar o cmdlet.
Tipo: | SwitchParameter |
Aliases: | cf |
Cargo: | Named |
Valor padrão: | False |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ConnectionContext
Especifica o contexto de conexão de um servidor do qual esse cmdlet remove um banco de dados.
Tipo: | IServerDataServiceContext |
Aliases: | Context |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-Database
Especifica um objeto que representa o banco de dados que esse cmdlet remove.
Tipo: | Database |
Aliases: | InputObject |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-DatabaseName
Especifica o nome do banco de dados que esse cmdlet remove.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Force
Permite que a ação seja concluída sem solicitar confirmação ao usuário.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Profile
Especifica o perfil do Azure a partir do qual este cmdlet lê. Se você não especificar um perfil, esse cmdlet será lido a partir do perfil padrão local.
Tipo: | AzureSMProfile |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ServerName
Especifica o nome do servidor no qual esse cmdlet exclui o banco de dados.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Tipo: | SwitchParameter |
Aliases: | wi |
Cargo: | Named |
Valor padrão: | False |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Entradas
Microsoft.WindowsAzure.Commands.SqlDatabase.Services.Server.Database
Observações
- Devido à gravidade da operação, por padrão, esse cmdlet solicita a confirmação. Para ignorar a confirmação, especifique o parâmetro Force .