Restore.ReplaceDatabase Restore.ReplaceDatabase Restore.ReplaceDatabase Property

Definition

Gets or sets a Boolean value that specifies whether a restore operation creates a new image of the restored database.

public:
 property bool ReplaceDatabase { bool get(); void set(bool value); };
public bool ReplaceDatabase { get; set; }
Public Property ReplaceDatabase As Boolean
Property Value

A Boolean value that specifies whether a new image of the restored database will be created.

If True, a new image of the database is created. The image is created regardless of the presence of an existing database with the same name.

If False (default), a new image of the database is not created by the restore operation. The database that is targeted by the restore operation must exist on an instance of SQL Server.

Examples

The following code example sets the restore operation to create a new image of the restored database.

VB

Dim rs As Restore  
rs = New Restore  
rs.ReplaceDatabase = true  

PowerShell

$rs = new-object Microsoft.SqlServer.Management.Smo.Restore  
$rs.ReplaceDatabast = $TRUE  

Applies to