This topic has not yet been rated - Rate this topic

Database.Rename Method

SQL Server 2012

Renames the database.

Namespace: Microsoft.SqlServer.Management.Smo
Assembly: Microsoft.SqlServer.Smo (in Microsoft.SqlServer.Smo.dll)

Syntax

C++

JScript

public void Rename(
	string newName
)

Parameters

newName: Type: System.String
A string value that specifies the new name of the database.

Implements

IRenamable.Rename(String)

Remarks

Note: An alternative to renaming the database is to create a synonym for the database.

Examples

'Connect to the local, default instance of SQL Server.
Dim srv As Server
srv = New Server

'Reference the AdventureWorks2012 database.
Dim db As Database
db = srv.Databases("AdventureWorks2012")

'Rename the database
db.Rename("AdventureWorks2012")

'Refresh the properties on the database.
db.Refresh()
db.Rename("AdventureWorks2012")

PowerShell

$srv = new-Object Microsoft.SqlServer.Management.Smo.Server("(local)")
$db = New-Object Microsoft.SqlServer.Management.Smo.Database
$db = $srv.Databases.Item("AdventureWorks2012")

$db.Rename("AdventureWorks2012")

$db.Refresh()
$db.Rename("AdventureWorks2012")

Reference

Database Class

Microsoft.SqlServer.Management.Smo Namespace

Other Resources

Working with Database Objects

Creating, Altering, and Removing Databases

ALTER DATABASE (Transact-SQL)

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

Community Additions

ADD