Backup.ExpirationDate Property

Gets or sets the date and time when the backup set expires and the backup data is no longer considered relevant.

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

Syntax

'Declaration
Public Property ExpirationDate As DateTime 
    Get 
    Set
'Usage
Dim instance As Backup 
Dim value As DateTime 

value = instance.ExpirationDate

instance.ExpirationDate = value
public DateTime ExpirationDate { get; set; }
public:
property DateTime ExpirationDate {
    DateTime get ();
    void set (DateTime value);
}
member ExpirationDate : DateTime with get, set
function get ExpirationDate () : DateTime 
function set ExpirationDate (value : DateTime)

Property Value

Type: System.DateTime
A DateTime object value that specifies the expiration date. By default, the value is unspecified.

Remarks

The ExpirationDate property is valid only for backup data stored on disk or tape devices. Backup sets older than the expiration date can be overwritten by a later backup.

Examples

VB

'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")
Dim bk As New Backup
bk.Action = BackupActionType.Database
bk.Database = "AdventureWorks2012"
Dim backupdate As New Date
backupdate = New Date(2006, 10, 5)
bk.ExpirationDate = backupdate

PowerShell

$srv = new-Object Microsoft.SqlServer.Management.Smo.Server("(local)")
$db = New-Object Microsoft.SqlServer.Management.Smo.Database
$db = $srv.Databases.Item("AdventureWorks2012")
$bk = new-object Microsoft.SqlServer.Management.Smo.Backup
$bk.Action = [Microsoft.SqlServer.Management.Smo.BackupActionType]::Database
$bk.Database = "AdventureWorks2012"
$backupDate = new-object System.DateTime(2006, 10, 5)
$bk.ExpirationDate = $backupDate

See Also

Reference

Backup Class

Microsoft.SqlServer.Management.Smo Namespace

Other Resources

BACKUP (Transact-SQL)

Backing Up and Restoring Databases and Transaction Logs