Remove-AzureSqlDatabase

Referência

Módulo:: Azure

Exclui um Banco de Dados SQL do Azure.

Observação

Os cmdlets mostrados nesta documentação são usados para gerenciar recursos herdados do Azure que usam APIs de Gerenciamento de Serviços. Confira o módulo Az PowerShell para usar cmdlets a fim de 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"

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.

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 que esse cmdlet remove.

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 confirmação ao 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 lê. 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

Mostra o que aconteceria se o cmdlet fosse executado. 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

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 .