Server.DeleteBackupHistory Method (DateTime)

Deletes the backup history for this instance of Microsoft 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 _
)
public void DeleteBackupHistory (
    DateTime oldestDate
)
public:
void DeleteBackupHistory (
    DateTime oldestDate
)
public void DeleteBackupHistory (
    DateTime oldestDate
)
public function DeleteBackupHistory (
    oldestDate : DateTime
)

Parameters

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

Remarks

Updated text:

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.

This namespace, class, or member is supported only in version 2.0 of the Microsoft .NET Framework.

Example

'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)

Thread Safety

Any public static (Shared in Microsoft Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.

Target Platforms

For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.

See Also

Reference

Server Class
Server Members
Microsoft.SqlServer.Management.Smo Namespace

Other Resources

How to: Use an SMO Method with a Parameter in Visual Basic .NET
Backing Up and Restoring Databases in SQL Server
Calling Methods
Managing Servers

Change History

Release

History

New content:
  • Added code sample to the Example section.

  • Added to the description in the Remarks section.