Share via


BackupDevice Object

This feature will be removed in a future version of Microsoft SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature.

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

SQL-DMO object model that shows the current object

Properties

DeviceNumber Property

Status Property (BackupDevice)

Name Property

SystemObject Property

PhysicalLocation Property

Type Property (BackupDevice)

SkipTapeLabel Property

 

Methods

ReadBackupHeader Method (BackupDevice)

Remove Method (Objects)

ReadMediaHeader Method (BackupDevice)

Script Method (BackupDevice Object)

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.