BackupDevice Object (SQL-DMO)

The BackupDevice object represents the properties of a Microsoft® SQL Server™ backup device.

Remarks

SQL Server backup devices specify the behavior of specific backup media, usually tape. Backup devices are not required when issuing a BACKUP or RESTORE statement and are not required by the Backup object.

With the BackupDevice object, you can:

• Define a new backup device for a server running SQL Server.
• Change the definition of an existing SQL Server backup device.

The Name property of the BackupDevice object must match the definition of the sysname SQL Server data type.

To create a backup device

1. Create a BackupDevice object.
2. Set the Name property.
3. Set properties that define the behavior or use of the device, such as the tape label skip parameter or the physical location.
4. Add the BackupDevice object to the BackupDevices collection of a connected SQLServer object.

To change the definition of an existing backup device

1. Get the appropriate BackupDevice object from the BackupDevices collection of a connected SQLServer object.
2. Set properties to reflect changes in behavior or use. Changes to property values are applied to the referenced SQL Server backup device as they are made.

Methods

Properties