Server.DeleteBackupHistory Method (DateTime)

Deletes the backup history for this instance of SQL Server up until the specified date and time.

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

Syntax

'Declaration
Public Sub DeleteBackupHistory ( _
    oldestDate As DateTime _
)
'Usage
Dim instance As Server 
Dim oldestDate As DateTime

instance.DeleteBackupHistory(oldestDate)
public void DeleteBackupHistory(
    DateTime oldestDate
)
public:
void DeleteBackupHistory(
    DateTime oldestDate
)
member DeleteBackupHistory : 
        oldestDate:DateTime -> unit
public function DeleteBackupHistory(
    oldestDate : DateTime
)

Parameters

  • oldestDate
    Type: System.DateTime
    A DateTime system object value that specifies the date and time before which to delete the backup history.

Remarks

Use this method to remove old backup history logs from the instance of SQL Server. Backup history that is older than the date specified will be removed from the instance of SQL Server.

Examples

Visual Basic

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

'Delete the backup history before the date specified.
Dim odt As DateTime
odt = New DateTime(2005, 12, 12)
srv1.DeleteBackupHistory(odt)

PowerShell

$srv1 = new-object Microsoft.SqlServer.Management.Smo.Server("(local)")
$odt = new-object System.DateTime(2005, 12, 12)
$srv1.DeleteBackupHistory($odt)

See Also

Reference

Server Class

DeleteBackupHistory Overload

Microsoft.SqlServer.Management.Smo Namespace

Other Resources

Back Up and Restore of SQL Server Databases

Calling Methods

Managing Servers