• Artículo

Clase BackupDevice

The BackupDevice object provides programmatic access to SQL Server backup devices.

Espacio de nombres:  Microsoft.SqlServer.Management.Smo
Ensamblado:  Microsoft.SqlServer.Smo (en Microsoft.SqlServer.Smo.dll)

Sintaxis

'Declaración
<PhysicalFacetAttribute> _
<EvaluationModeAttribute(AutomatedPolicyEvaluationMode.CheckOnSchedule)> _
Public NotInheritable Class BackupDevice _
    Inherits ScriptNameObjectBase _
    Implements ICreatable, IDroppable, IScriptable
'Uso
Dim instance As BackupDevice

[PhysicalFacetAttribute]
[EvaluationModeAttribute(AutomatedPolicyEvaluationMode.CheckOnSchedule)]
public sealed class BackupDevice : ScriptNameObjectBase, 
    ICreatable, IDroppable, IScriptable

[PhysicalFacetAttribute]
[EvaluationModeAttribute(AutomatedPolicyEvaluationMode::CheckOnSchedule)]
public ref class BackupDevice sealed : public ScriptNameObjectBase, 
    ICreatable, IDroppable, IScriptable

[<SealedAttribute>]
[<PhysicalFacetAttribute>]
[<EvaluationModeAttribute(AutomatedPolicyEvaluationMode.CheckOnSchedule)>]
type BackupDevice =  
    class
        inherit ScriptNameObjectBase
        interface ICreatable
        interface IDroppable
        interface IScriptable
    end

public final class BackupDevice extends ScriptNameObjectBase implements ICreatable, IDroppable, IScriptable

El tipo BackupDevice expone los siguientes miembros.

Constructores

  Nombre Descripción
Método público BackupDevice() () () () Initializes a new instance of the BackupDevice class.
Método público BackupDevice(Server, String) Initializes a new instance of the BackupDevice class with the specified name and on the specified instance of SQL Server.

Arriba

Propiedades

  Nombre Descripción
Propiedad pública BackupDeviceType Gets or sets the type of backup device of the backup device.
Propiedad protegida ExecuteForScalar Obtiene o establece el valor de propiedad Boolean que especifica si el objeto está establecido para que se ejecute para la opción escalar. (Se hereda de SqlSmoObject.)
Propiedad protegida IsTouched Obtiene el valor de propiedad Boolean que especifica si las propiedades del objeto se han actualizado pero todavía no son persistentes en el servidor. (Se hereda de SqlSmoObject.)
Propiedad pública Name Gets or sets the name of the object. (Se hereda de NamedSmoObject.)
Propiedad protegida ObjectInSpace Obtiene el valor de propiedad Boolean que especifica si el objeto existe en aislamiento, o si está conectado directa o indirectamente con la instancia de SQL Server. (Se hereda de SqlSmoObject.)
Propiedad pública Parent Gets the Server object that owns the BackupDevice object.
Propiedad pública PhysicalLocation Gets or sets the path to the device or operating system file that represents the physical backup location.
Propiedad pública Properties Obtiene una colección de objetos Property que representa las propiedades del objeto. (Se hereda de SqlSmoObject.)
Propiedad protegida ScalarResult Obtiene el resultado escalar para el objeto al que se hace referencia. (Se hereda de SqlSmoObject.)
Propiedad pública SkipTapeLabel Gets or sets a Boolean property value that specifies whether to check that the tape label is correct or not.
Propiedad pública State Gets the state of the referenced object. (Se hereda de SmoObjectBase.)
Propiedad pública Urn Obtiene el valor de la dirección URN (nombre de recursos uniforme) que identifica de forma única el objeto. (Se hereda de SqlSmoObject.)
Propiedad pública UserData Gets or sets user-defined data associated with the referenced object. (Se hereda de SmoObjectBase.)

Arriba

Métodos

  Nombre Descripción
Método protegido AddDatabaseContext(StringCollection) Agrega el contexto de la base de datos a la colección de consultas identificada por el parámetro queries. (Se hereda de SqlSmoObject.)
Método protegido AddDatabaseContext(StringCollection, ScriptingOptions) Agrega el contexto de la base de datos a la colección de consultas identificada por el parámetro queries usando las opciones de scripting especificadas. (Se hereda de SqlSmoObject.)
Método protegido AlterImpl Activa el evento de objeto modificado. (Se hereda de SqlSmoObject.)
Método protegido AlterImplFinish Método al que se llama cuando finaliza el evento de objeto modificado. (Se hereda de SqlSmoObject.)
Método protegido AlterImplInit Método al que se llama cuando se inicializa el evento de objeto modificado. (Se hereda de SqlSmoObject.)
Método protegido AlterImplWorker Llama a los métodos Alter. (Se hereda de SqlSmoObject.)
Método protegido AppendCommaText Appends text, optionally separated by a comma. (Se hereda de ScriptNameObjectBase.)
Método protegido AppendWithCommaText Appends text, optionally separated by a comma. (Se hereda de ScriptNameObjectBase.)
Método protegido AppendWithOption Appends text and option text separated from the main text with a “WITH” string and optionally separated by a comma. (Se hereda de ScriptNameObjectBase.)
Método protegido AutoGenerateName Generates a name based on the object Guid. (Se hereda de ScriptNameObjectBase.)
Método protegido BindDefaultImpl Enlaza los elementos predeterminados identificados por los parámetros. (Se hereda de SqlSmoObject.)
Método protegido BindRuleImpl Enlaza el esquema de la regla a la regla y las columnas identificadas por los parámetros. (Se hereda de SqlSmoObject.)
Método protegido CheckCollation Comprueba el orden de las opciones de scripting por el método de intercalación identificado por el parámetro collationName. (Se hereda de SqlSmoObject.)
Método protegido CheckObjectDirty Checks whether object has been modified and not persisted. (Se hereda de ScriptNameObjectBase.)
Método protegido CheckObjectState() () () () Valida el estado del objeto al que se hace referencia. (Se hereda de SqlSmoObject.)
Método protegido CheckObjectState(Boolean) Valida el estado del objeto al que se hace referencia, con la opción de especificar que se produzca una excepción si todavía no se ha creado el objeto. (Se hereda de SqlSmoObject.)
Método protegido CheckObjectStateImpl Comprueba el estado de un objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido CheckTextCorectness Checks text for correctness against the parameters. (Se hereda de ScriptNameObjectBase.)
Método protegido CheckTextModeSupport Checks mode of support. (Se hereda de ScriptNameObjectBase.)
Método protegido CheckVersion100 Comprueba si la versión de SQL Server es SQL Server 2008. (Se hereda de SqlSmoObject.)
Método protegido CheckVersion80 Comprueba la validez del objeto en SQL Server 2000. (Se hereda de SqlSmoObject.)
Método protegido CheckVersion80SP3 Comprueba la validez del objeto en SQL Server 2000 SP3. (Se hereda de SqlSmoObject.)
Método protegido CheckVersion90 Comprueba la validez del objeto en SQL Server 2005. (Se hereda de SqlSmoObject.)
Método protegido CheckVersionBelow90 Comprueba si la versión de SQL Server es anterior a SQL Server 2005. (Se hereda de SqlSmoObject.)
Método protegido CleanObject Cleans the referenced object. (Se hereda de ScriptNameObjectBase.)
Método público Create Creates a new backup device on the instance of SQL Server as defined by the BackupDevice object.
Método protegido CreateImpl Crea un objeto con opciones de scripting. (Se hereda de SqlSmoObject.)
Método protegido CreateImplFinish Método al que se llama cuando finaliza el evento Create. (Se hereda de SqlSmoObject.)
Método protegido CreateImplInit Método al que se llama cuando se inicializa el evento Create. (Se hereda de SqlSmoObject.)
Método público Discover Detecta una lista del tipo Object. (Se hereda de SqlSmoObject.)
Método público Drop Drops an existing backup device.
Método protegido DropImpl Quita un SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido DropImplWorker Llama a los métodos Drop. (Se hereda de SqlSmoObject.)
Método protegido EnumScriptImpl Enumera los scripts especificados por el parámetro so. (Se hereda de SqlSmoObject.)
Método protegido EnumScriptImplWorker Llama a los métodos que enumeran los scripts especificados por el parámetro so. (Se hereda de SqlSmoObject.)
Método protegido EnumScriptImplWorkerSOChanged Devuelve una cadena IEnumerable que describe las opciones de scripting de un objeto. (Se hereda de SqlSmoObject.)
Método público Equals (Se hereda de Object.)
Método protegido ExecuteNonQuery (Se hereda de SqlSmoObject.)
Método protegido Finalize (Se hereda de Object.)
Método protegido ForceTextModeOnTextBody Enforces text mode on the text body. (Se hereda de ScriptNameObjectBase.)
Método protegido FormatSqlVariant Da formato a un objeto como tipo SqlVariant. (Se hereda de SqlSmoObject.)
Método protegido GenerateDataSpaceFileStreamScript Genera un script para crear el archivo de datos. (Se hereda de SqlSmoObject.)
Método protegido GenerateDataSpaceScript Genera un script para asignar espacio en el archivo de datos. (Se hereda de SqlSmoObject.)
Método protegido GetBindDefaultScript Obtiene el script que enlaza los valores predeterminados especificados por los parámetros defSchema y defName. (Se hereda de SqlSmoObject.)
Método protegido GetBindRuleScript Obtiene el script que especifica las reglas de enlace. (Se hereda de SqlSmoObject.)
Método protegido GetBoolParameter(StringBuilder, ScriptingOptions, String, String, Int32%) Asigna un parámetro booleano del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido GetBoolParameter(StringBuilder, ScriptingOptions, String, String, Int32%, Boolean) Asigna una propiedad booleana del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido GetBraketNameForText Gets the bracket name. (Se hereda de ScriptNameObjectBase.)
Método protegido GetDateTimeParameter Asigna la propiedad datetime del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido GetDateTimeParameterAsInt Asigna la propiedad datetime del objeto SqlSmoObject como un valor entero si la propiedad datetime no es NULL. (Se hereda de SqlSmoObject.)
Método protegido GetDBName Obtiene el nombre de la base de datos asociada al objeto. (Se hereda de SqlSmoObject.)
Método protegido GetEnumParameter Asigna una propiedad enumeration del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido GetFragOptionString Obtiene un objeto FragmentationOption como un valor de cadena. (Se hereda de SqlSmoObject.)
Método protegido GetGuidParameter Asigna una propiedad Guid del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método público GetHashCode (Se hereda de Object.)
Método protegido GetIsSystemNamed Gets a Boolean value that specifies whether the system is named. (Se hereda de ScriptNameObjectBase.)
Método protegido GetIsTextDirty Determines whether the text value is consistent with stored value. (Se hereda de ScriptNameObjectBase.)
Método protegido GetParameter(StringBuilder, ScriptingOptions, String, String, Int32%) Asigna un parámetro del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido GetParameter(StringBuilder, ScriptingOptions, String, String, Int32%, Boolean) Asigna un parámetro del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido GetPropValue Obtiene un valor de propiedad del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido GetPropValueOptional Obtiene un valor de propiedad del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido GetPropValueOptionalAllowNull Obtiene un valor de propiedad del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido GetRealValue Obtiene un valor de propiedad del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido GetScriptIncludeExists Gets the script including the test for existence of type being scripted. (Se hereda de ScriptNameObjectBase.)
Método protegido GetScriptingOptionsForCreate Obtiene ScriptingOptions para el objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido GetServerName Obtiene el nombre de la instancia de SQL Server con la que está asociado el objeto. (Se hereda de SqlSmoObject.)
Método protegido GetServerObject Obtiene el servidor del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido GetSqlServerVersionName Obtiene el nombre de la versión de la instancia de SQL Server con la que está asociado el objeto. (Se hereda de SqlSmoObject.)
Método protegido GetStringParameter(StringBuilder, ScriptingOptions, String, String, Int32%) Asigna un parámetro de cadena del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido GetStringParameter(StringBuilder, ScriptingOptions, String, String, Int32%, Boolean) Asigna un parámetro de cadena del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido GetTextBody() () () () Returns the text body. (Se hereda de ScriptNameObjectBase.)
Método protegido GetTextBody(Boolean) Returns the text body. (Se hereda de ScriptNameObjectBase.)
Método protegido GetTextForScript(ScriptingOptions, Boolean, array<String> [] () [] []) Gets the text for scripting. (Se hereda de ScriptNameObjectBase.)
Método protegido GetTextForScript(ScriptingOptions, Boolean, array<String> [] () [] [], Boolean) Gets the text of script object. (Se hereda de ScriptNameObjectBase.)
Método protegido GetTextHeader Returns the text header. (Se hereda de ScriptNameObjectBase.)
Método protegido GetTextMode Determines whether the script name is using text mode. (Se hereda de ScriptNameObjectBase.)
Método protegido GetTextProperty(String) Gets the property as text. (Se hereda de ScriptNameObjectBase.)
Método protegido GetTextProperty(String, ScriptingOptions) Gets the property as text. (Se hereda de ScriptNameObjectBase.)
Método protegido GetTimeSpanParameterAsInt Asigna un parámetro de intervalo de tiempo del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método público GetType (Se hereda de Object.)
Método protegido GetUrnRecursive(StringBuilder) Asigna un objeto Urn del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido GetUrnRecursive(StringBuilder, UrnIdOption) Asigna un objeto Urn del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido ImplInitialize Inicializa los campos del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método público Initialize() () () () Inicializa el objeto y fuerza la carga de las propiedades. (Se hereda de SqlSmoObject.)
Método público Initialize(Boolean) Inicializa el objeto y fuerza la carga de las propiedades. (Se hereda de SqlSmoObject.)
Método protegido IsObjectDirty Determines whether the referenced object is consistent with the stored object. (Se hereda de ScriptNameObjectBase.)
Método protegido IsObjectInitialized Comprueba si se ha inicializado el objeto. (Se hereda de SqlSmoObject.)
Método protegido IsObjectInSpace Comprueba si el objeto está aislado o conectado a la instancia de SQL Server. (Se hereda de SqlSmoObject.)
Método protegido IsVersion80SP3 Determina si la versión de SQL Server es SQL Server 2000 con SP3. (Se hereda de SqlSmoObject.)
Método protegido IsVersion90AndAbove Determina si la versión de SQL Server es SQL Server 2005 o posterior. (Se hereda de SqlSmoObject.)
Método protegido MarkDropped Establece SqlSmoState en quitado. (Se hereda de SqlSmoObject.)
Método protegido MarkForDropImpl Establece SqlSmoState en quitado. (Se hereda de SqlSmoObject.)
Método protegido MemberwiseClone (Se hereda de Object.)
Método protegido PostAlter Método que se activa tras modificar el objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido PostCreate Método que se activa tras crear el objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido PostDrop Método que se activa tras quitar el objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método público ReadBackupHeader Enumerates the contents of the media maintained by a backup device or operating system file.
Método público ReadMediaHeader Enumerates the values of a backup media header record.
Método público Refresh Refreshes the script name. (Se hereda de ScriptNameObjectBase.)
Método protegido RenameImpl Solamente se identifica con fines informativos. No compatible. La compatibilidad con versiones posteriores no está garantizada. (Se hereda de NamedSmoObject.)
Método protegido RenameImplWorker Solamente se identifica con fines informativos. No compatible. La compatibilidad con versiones posteriores no está garantizada. (Se hereda de NamedSmoObject.)
Método público Script() () () () Generates a Transact-SQL script that can be used to re-create the backup device.
Método público Script(ScriptingOptions) Generates a Transact-SQL script that can be used to re-create the backup device as specified by the script options.
Método protegido ScriptAlter Modifica el objeto SqlSmoObject de acuerdo con los parámetros. (Se hereda de SqlSmoObject.)
Método protegido ScriptAnsiQI Scripts the database object in ANSI text. (Se hereda de ScriptNameObjectBase.)
Método protegido ScriptChangeOwner This method supports the SMO infrastructure and is not intended to be used directly from your code. (Se hereda de NamedSmoObject.)
Método protegido ScriptCreate Modifica el objeto SqlSmoObject de acuerdo con los parámetros. (Se hereda de SqlSmoObject.)
Método protegido ScriptDdl Inicia InvalidSmoOperationException. (Se hereda de SqlSmoObject.)
Método protegido ScriptDrop Inicia InvalidSmoOperationException. (Se hereda de SqlSmoObject.)
Método protegido ScriptImpl() () () () Obtiene una colección de los scripts del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido ScriptImpl(ScriptingOptions) Obtiene una colección de los scripts del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido ScriptImplWorker Obtiene una colección de los scripts del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido ScriptInformativeHeaders Scripts the information headers. (Se hereda de ScriptNameObjectBase.)
Método protegido ScriptOwner Alters the script owner authorization. (Se hereda de NamedSmoObject.)
Método protegido ScriptRename This method supports the SMO infrastructure and is not intended to be used directly from your code. (Se hereda de NamedSmoObject.)
Método protegido SetCollectionTextMode Sets the collection text mode. (Se hereda de ScriptNameObjectBase.)
Método protegido SetIsSystemNamed Sets a Boolean value that specifies whether the system is named. (Se hereda de ScriptNameObjectBase.)
Método protegido SetParentImpl Establece el elemento primario del objeto SqlSmoObject en el parámetro newParent. (Se hereda de SqlSmoObject.)
Método protegido SetSchemaOwned Sets the schema owned value. (Se hereda de NamedSmoObject.)
Método protegido SetTextBody Specifies the text body. (Se hereda de ScriptNameObjectBase.)
Método protegido SetTextHeader Specifies the text header. (Se hereda de ScriptNameObjectBase.)
Método protegido SetTextMode Specifies the text mode. (Se hereda de ScriptNameObjectBase.)
Método protegido SwitchTextMode Switches the text mode. (Se hereda de ScriptNameObjectBase.)
Método protegido ThrowIfTextIsDirtyForAlter Throws an exception of text has been modified and not persisted. (Se hereda de ScriptNameObjectBase.)
Método público ToString Devuelve un valor String que representa el objeto al que se hace referencia. (Se hereda de SqlSmoObject.)
Método protegido TouchImpl No implementado. (Se hereda de SqlSmoObject.)
Método protegido UnbindDefaultImpl Desenlaza las columnas predeterminadas del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido UnbindRuleImpl Desenlaza las reglas del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método público Validate Validates the state of an object. (Se hereda de SmoObjectBase.)

Arriba

Eventos

  Nombre Descripción
Evento público PropertyChanged Representa el evento que se produce cuando se cambia una propiedad. (Se hereda de SqlSmoObject.)
Evento público PropertyMetadataChanged Representa el evento que se produce cuando cambian los metadatos de la propiedad. (Se hereda de SqlSmoObject.)

Arriba

Campos

  Nombre Descripción
Campo protegido m_ExtendedProperties Representa una propiedad definida para extender las propiedades proporcionadas por un objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Campo protegido singletonParent Representa el elemento primario singleton. (Se hereda de SqlSmoObject.)

Arriba

Implementaciones de interfaces explícitas

  Nombre Descripción
Implementación de interfaces explícitasMétodo privado IAlienObject. . :: . .Discover Detecta las dependencias. No haga referencia directamente a este miembro en el código. Admite la infraestructura de SQL Server. (Se hereda de SqlSmoObject.)
Implementación de interfaces explícitasMétodo privado IAlienObject. . :: . .GetDomainRoot Devuelve la raíz del dominio. (Se hereda de SqlSmoObject.)
Implementación de interfaces explícitasMétodo privado IAlienObject. . :: . .GetParent Obtiene el elemento primario de este objeto. No haga referencia directamente a este miembro en el código. Admite la infraestructura de SQL Server. (Se hereda de SqlSmoObject.)
Implementación de interfaces explícitasMétodo privado IAlienObject. . :: . .GetPropertyType Obtiene el tipo de la propiedad especificada. (Se hereda de SqlSmoObject.)
Implementación de interfaces explícitasMétodo privado IAlienObject. . :: . .GetPropertyValue Obtiene el valor de la propiedad especificada. (Se hereda de SqlSmoObject.)
Implementación de interfaces explícitasMétodo privado IAlienObject. . :: . .GetUrn Obtiene el Nombre de recursos uniforme del objeto. No haga referencia directamente a este miembro en el código. Admite la infraestructura de SQL Server. (Se hereda de SqlSmoObject.)
Implementación de interfaces explícitasMétodo privado IAlienObject. . :: . .Resolve Obtiene la instancia que contiene la información sobre el objeto del Nombre de recursos unificado del objeto. (Se hereda de SqlSmoObject.)
Implementación de interfaces explícitasMétodo privado IAlienObject. . :: . .SetObjectState Establece el estado del objeto en el valor SfcObjectState especificado. (Se hereda de SqlSmoObject.)
Implementación de interfaces explícitasMétodo privado IAlienObject. . :: . .SetPropertyValue Establece el valor de la propiedad. (Se hereda de SqlSmoObject.)
Implementación de interfaces explícitasMétodo privado ISfcPropertyProvider. . :: . .GetPropertySet Obtiene la referencia de interfaz al conjunto de propiedades de este objeto. No haga referencia directamente a este miembro en el código. Admite la infraestructura de SQL Server. (Se hereda de SqlSmoObject.)

Arriba

Comentarios

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 Microsoft SQL Server.

  • Change the definition of an existing Microsoft SQL Server backup device.

The BackupDeviceType property must match the definition of the sysname SQL Server data type.

To get BackupDevice object properties, users can be a member of the public fixed server role.

To set BackupDevice object properties, users must have BACKUP DATABASE or BACKUP LOG permissions on the database, or be a member of the db_owner and db_backupoperator fixed database role and the sysadmin fixed server role.

Seguridad para subprocesos

Cualquier miembro público static (Shared en Visual Basic) de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.