你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Remove-AzureSqlDatabase

删除Azure SQL 数据库。

注意

本文档中引用的 cmdlet 用于管理使用 Azure Service Manager (ASM) API 的旧 Azure 资源。 创建新的资源时,不建议使用此旧版 PowerShell 模块,因为 ASM 计划停用。 有关详细信息,请参阅 Azure Service Manager 停用

Az PowerShell 模块是推荐的 PowerShell 模块,用于使用 PowerShell 管理 Azure 资源管理器 (ARM) 资源。

语法

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>]

说明

Remove-AzureSqlDatabase cmdlet 通过服务器连接上下文或服务器名称删除Azure SQL 数据库。 可以使用 New-AzureSqlDatabaseServerContext cmdlet 创建Azure SQL 数据库服务器连接上下文,然后将其用于此 cmdlet。

通过指定Azure SQL 数据库服务器名称删除数据库时,Remove-AzureSqlDatabase cmdlet 使用名称和当前的 Azure 订阅信息来执行该操作。

示例

示例 1:删除数据库

PS C:\> Remove-AzureSqlDatabase -ConnectionContext $Context -DatabaseName "Database01"

此命令从Azure SQL 数据库服务器连接上下文中删除名为 Database01 的数据库$Context。

示例 2:使用服务器名称删除数据库

PS C:\> Remove-AzureSqlDatabase -ServerName "lpqd0zbr8y" -DatabaseName "Database01"

此命令从名为 lpqd0zbr8y 的 Azure SQL 数据库 服务器中删除名为 Database01 的数据库。

示例 3:使用管道删除数据库

PS C:\> $Database01 | Remove-AzureSqlDatabase -ConnectionContext $Context
PS C:\> $Database01 | Remove-AzureSqlDatabase -ServerName "lpqd0zbr8y"

此示例演示了通过管道传递数据库对象的替代方法。

参数

-Confirm

提示你在运行 cmdlet 之前进行确认。

类型:SwitchParameter
Aliases:cf
Position:Named
默认值:False
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-ConnectionContext

指定此 cmdlet 从中删除数据库的服务器的连接上下文。

类型:IServerDataServiceContext
Aliases:Context
Position:Named
默认值:None
必需:True
Accept pipeline input:True
Accept wildcard characters:False

-Database

指定一个对象,该对象表示此 cmdlet 删除的数据库。

类型:Database
Aliases:InputObject
Position:Named
默认值:None
必需:True
Accept pipeline input:True
Accept wildcard characters:False

-DatabaseName

指定此 cmdlet 删除的数据库的名称。

类型:String
Position:Named
默认值:None
必需:True
Accept pipeline input:False
Accept wildcard characters:False

-Force

允许操作完成,而无需提示用户进行确认。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-Profile

指定此 cmdlet 从中读取的 Azure 配置文件。 如果未指定配置文件,此 cmdlet 将从本地默认配置文件中读取。

类型:AzureSMProfile
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-ServerName

指定此 cmdlet 删除数据库的服务器的名称。

类型:String
Position:Named
默认值:None
必需:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

类型:SwitchParameter
Aliases:wi
Position:Named
默认值:False
必需:False
Accept pipeline input:False
Accept wildcard characters:False

输入

Microsoft.WindowsAzure.Commands.SqlDatabase.Services.Server.Database

备注

  • 由于操作的严重性,默认情况下,此 cmdlet 会提示你进行确认。 若要跳过确认,请指定 Force 参数。