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 de Gerenciamento de Serviços. Consulte o módulo Az PowerShell para cmdlets para gerenciar recursos do Azure Resource Manager.
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>]
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.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ConnectionContext
Especifica o contexto de conexão de um servidor do qual esse cmdlet remove um banco de dados.
Type: | IServerDataServiceContext |
Aliases: | Context |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Database
Especifica um objeto que representa o banco de dados removido por esse cmdlet.
Type: | Database |
Aliases: | InputObject |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DatabaseName
Especifica o nome do banco de dados que esse cmdlet remove.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Permite que a ação seja concluída sem solicitar a confirmação do usuário.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | AzureSMProfile |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ServerName
Especifica o nome do servidor no qual esse cmdlet exclui o banco de dados.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 .