Classe BackupDevice
The BackupDevice object provides programmatic access to SQL Server backup devices.
Hiérarchie d'héritage
System. . :: . .Object
Microsoft.SqlServer.Management.Smo. . :: . .SmoObjectBase
Microsoft.SqlServer.Management.Smo. . :: . .SqlSmoObject
Microsoft.SqlServer.Management.Smo. . :: . .NamedSmoObject
Microsoft.SqlServer.Management.Smo. . :: . .ScriptNameObjectBase
Microsoft.SqlServer.Management.Smo..::..BackupDevice
Espace de noms : Microsoft.SqlServer.Management.Smo
Assembly : Microsoft.SqlServer.Smo (en Microsoft.SqlServer.Smo.dll)
Syntaxe
'Déclaration
<PhysicalFacetAttribute> _
<EvaluationModeAttribute(AutomatedPolicyEvaluationMode.CheckOnSchedule)> _
Public NotInheritable Class BackupDevice _
Inherits ScriptNameObjectBase _
Implements ICreatable, IDroppable, IScriptable
'Utilisation
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
Le type BackupDevice expose les membres suivants.
Constructeurs
Nom | Description | |
---|---|---|
BackupDevice() () () () | Initializes a new instance of the BackupDevice class. | |
BackupDevice(Server, String) | Initializes a new instance of the BackupDevice class with the specified name and on the specified instance of SQL Server. |
Haut de la page
Propriétés
Nom | Description | |
---|---|---|
BackupDeviceType | Gets or sets the type of backup device of the backup device. | |
ExecuteForScalar | Obtient ou définit la valeur de la propriété Boolean qui spécifie si l'objet est défini selon l'option permettant l'exécution qui retourne une valeur scalaire. (hérité de SqlSmoObject.) | |
IsTouched | Obtient la valeur de la propriété Boolean qui spécifie si les propriétés de l'objet ont été mises à jour mais n'ont pas encore été rendues persistantes sur le serveur. (hérité de SqlSmoObject.) | |
Name | Gets or sets the name of the object. (hérité de NamedSmoObject.) | |
ObjectInSpace | Obtient la valeur de la propriété Boolean qui spécifie si l'objet existe dans l'isolation, ou s'il est connecté directement ou indirectement à l'instance de SQL Server. (hérité de SqlSmoObject.) | |
Parent | Gets the Server object that owns the BackupDevice object. | |
PhysicalLocation | Gets or sets the path to the device or operating system file that represents the physical backup location. | |
Properties | Obtient une collection d'objets Property qui représentent les propriétés de l'objet. (hérité de SqlSmoObject.) | |
ScalarResult | Obtient le résultat scalaire pour l'objet référencé. (hérité de SqlSmoObject.) | |
SkipTapeLabel | Gets or sets a Boolean property value that specifies whether to check that the tape label is correct or not. | |
State | Gets the state of the referenced object. (hérité de SmoObjectBase.) | |
Urn | Obtient la valeur URN (Uniform Resource Name) qui identifie de façon unique l'objet. (hérité de SqlSmoObject.) | |
UserData | Gets or sets user-defined data associated with the referenced object. (hérité de SmoObjectBase.) |
Haut de la page
Méthodes
Nom | Description | |
---|---|---|
AddDatabaseContext(StringCollection) | Ajoute le contexte de base de données à la collection de requêtes identifiée par le paramètre queries. (hérité de SqlSmoObject.) | |
AddDatabaseContext(StringCollection, ScriptingOptions) | Ajoute le contexte de base de données à la collection de requêtes identifiée par le paramètre queries, à l'aide des options de script spécifiées. (hérité de SqlSmoObject.) | |
AlterImpl | Active l'événement d'objet modifié. (hérité de SqlSmoObject.) | |
AlterImplFinish | Méthode appelée lorsque l'événement d'objet modifié est terminé. (hérité de SqlSmoObject.) | |
AlterImplInit | Méthode appelée lorsque l'événement d'objet modifié est initialisé. (hérité de SqlSmoObject.) | |
AlterImplWorker | Appelle les méthodes de modification. (hérité de SqlSmoObject.) | |
AppendCommaText | Appends text, optionally separated by a comma. (hérité de ScriptNameObjectBase.) | |
AppendWithCommaText | Appends text, optionally separated by a comma. (hérité de ScriptNameObjectBase.) | |
AppendWithOption | Appends text and option text separated from the main text with a “WITH” string and optionally separated by a comma. (hérité de ScriptNameObjectBase.) | |
AutoGenerateName | Generates a name based on the object Guid. (hérité de ScriptNameObjectBase.) | |
BindDefaultImpl | Lie les éléments par défaut identifiés par les paramètres. (hérité de SqlSmoObject.) | |
BindRuleImpl | Lie le schéma de règle à la règle et aux colonnes identifiées par les paramètres. (hérité de SqlSmoObject.) | |
CheckCollation | Vérifie l'ordre des options de script par la méthode de classement identifiée par le paramètre collationName. (hérité de SqlSmoObject.) | |
CheckObjectDirty | Checks whether object has been modified and not persisted. (hérité de ScriptNameObjectBase.) | |
CheckObjectState() () () () | Valide l'état de l'objet référencé. (hérité de SqlSmoObject.) | |
CheckObjectState(Boolean) | Valide l'état de l'objet référencé avec l'option permettant de spécifier qu'une exception est levée si l'objet n'est pas encore créé. (hérité de SqlSmoObject.) | |
CheckObjectStateImpl | Vérifie l'état de l'objet SqlSmoObject. (hérité de SqlSmoObject.) | |
CheckTextCorectness | Checks text for correctness against the parameters. (hérité de ScriptNameObjectBase.) | |
CheckTextModeSupport | Checks mode of support. (hérité de ScriptNameObjectBase.) | |
CheckVersion100 | Vérifie si la version de SQL Server est SQL Server 2008. (hérité de SqlSmoObject.) | |
CheckVersion80 | Vérifie la validité de l'objet sur SQL Server 2000. (hérité de SqlSmoObject.) | |
CheckVersion80SP3 | Vérifie la validité de l'objet sur SQL Server 2000 SP3. (hérité de SqlSmoObject.) | |
CheckVersion90 | Vérifie la validité de l'objet sur SQL Server 2005. (hérité de SqlSmoObject.) | |
CheckVersionBelow90 | Vérifie si la version de SQL Server est antérieure à SQL Server 2005. (hérité de SqlSmoObject.) | |
CleanObject | Cleans the referenced object. (hérité de ScriptNameObjectBase.) | |
Create | Creates a new backup device on the instance of SQL Server as defined by the BackupDevice object. | |
CreateImpl | Crée un objet avec les options de script. (hérité de SqlSmoObject.) | |
CreateImplFinish | Méthode appelée lorsque l'événement de création est terminé. (hérité de SqlSmoObject.) | |
CreateImplInit | Méthode appelée lorsque l'événement de création est initialisé. (hérité de SqlSmoObject.) | |
Discover | Découvre une liste de type Object. (hérité de SqlSmoObject.) | |
Drop | Drops an existing backup device. | |
DropImpl | Supprime un SqlSmoObject. (hérité de SqlSmoObject.) | |
DropImplWorker | Appelle les méthodes de suppression. (hérité de SqlSmoObject.) | |
EnumScriptImpl | Énumère des scripts spécifiés par le paramètre so. (hérité de SqlSmoObject.) | |
EnumScriptImplWorker | Appelle les méthodes qui énumèrent des scripts spécifiés par le paramètre so. (hérité de SqlSmoObject.) | |
EnumScriptImplWorkerSOChanged | Retourne une chaîne IEnumerable qui décrit les options de script pour un objet. (hérité de SqlSmoObject.) | |
Equals | (hérité de Object.) | |
ExecuteNonQuery | (hérité de SqlSmoObject.) | |
Finalize | (hérité de Object.) | |
ForceTextModeOnTextBody | Enforces text mode on the text body. (hérité de ScriptNameObjectBase.) | |
FormatSqlVariant | Met en forme un objet en tant que type SqlVariant. (hérité de SqlSmoObject.) | |
GenerateDataSpaceFileStreamScript | Génère un script pour créer un fichier de données. (hérité de SqlSmoObject.) | |
GenerateDataSpaceScript | Génère un script pour allouer l'espace dans le fichier de données. (hérité de SqlSmoObject.) | |
GetBindDefaultScript | Obtient le script qui lie les valeurs par défaut spécifiées par les paramètres defName et defSchema. (hérité de SqlSmoObject.) | |
GetBindRuleScript | Obtient le script qui spécifie les règles de liaison. (hérité de SqlSmoObject.) | |
GetBoolParameter(StringBuilder, ScriptingOptions, String, String, Int32%) | Affecte un paramètre booléen du SqlSmoObject. (hérité de SqlSmoObject.) | |
GetBoolParameter(StringBuilder, ScriptingOptions, String, String, Int32%, Boolean) | Affecte une propriété booléenne du SqlSmoObject. (hérité de SqlSmoObject.) | |
GetBraketNameForText | Gets the bracket name. (hérité de ScriptNameObjectBase.) | |
GetDateTimeParameter | Affecte une propriété datetime du SqlSmoObject. (hérité de SqlSmoObject.) | |
GetDateTimeParameterAsInt | Affecte la propriété datetime du SqlSmoObject comme une valeur entière, si la propriété datetime n'est pas Null. (hérité de SqlSmoObject.) | |
GetDBName | Obtient le nom de la base de données associée à l'objet. (hérité de SqlSmoObject.) | |
GetEnumParameter | Affecte une propriété d'énumération du SqlSmoObject. (hérité de SqlSmoObject.) | |
GetFragOptionString | Obtient un objet FragmentationOption en tant que valeur de chaîne. (hérité de SqlSmoObject.) | |
GetGuidParameter | Affecte une propriété Guid du SqlSmoObject. (hérité de SqlSmoObject.) | |
GetHashCode | (hérité de Object.) | |
GetIsSystemNamed | Gets a Boolean value that specifies whether the system is named. (hérité de ScriptNameObjectBase.) | |
GetIsTextDirty | Determines whether the text value is consistent with stored value. (hérité de ScriptNameObjectBase.) | |
GetParameter(StringBuilder, ScriptingOptions, String, String, Int32%) | Affecte un paramètre du SqlSmoObject. (hérité de SqlSmoObject.) | |
GetParameter(StringBuilder, ScriptingOptions, String, String, Int32%, Boolean) | Affecte un paramètre du SqlSmoObject. (hérité de SqlSmoObject.) | |
GetPropValue | Obtient une valeur de propriété de l'objet SqlSmoObject. (hérité de SqlSmoObject.) | |
GetPropValueOptional | Obtient une valeur de propriété de l'objet SqlSmoObject. (hérité de SqlSmoObject.) | |
GetPropValueOptionalAllowNull | Obtient une valeur de propriété de l'objet SqlSmoObject. (hérité de SqlSmoObject.) | |
GetRealValue | Obtient une valeur de propriété de l'objet SqlSmoObject. (hérité de SqlSmoObject.) | |
GetScriptIncludeExists | Gets the script including the test for existence of type being scripted. (hérité de ScriptNameObjectBase.) | |
GetScriptingOptionsForCreate | Obtient ScriptingOptions pour l'objet SqlSmoObject. (hérité de SqlSmoObject.) | |
GetServerName | Obtient le nom de l'instance de SQL Server à laquelle l'objet est associé. (hérité de SqlSmoObject.) | |
GetServerObject | Obtient le serveur de l'objet SqlSmoObject. (hérité de SqlSmoObject.) | |
GetSqlServerVersionName | Obtient le nom de version de l'instance de SQL Server à laquelle l'objet est associé. (hérité de SqlSmoObject.) | |
GetStringParameter(StringBuilder, ScriptingOptions, String, String, Int32%) | Affecte un paramètre de chaîne de l'objet SqlSmoObject. (hérité de SqlSmoObject.) | |
GetStringParameter(StringBuilder, ScriptingOptions, String, String, Int32%, Boolean) | Affecte un paramètre de chaîne de l'objet SqlSmoObject. (hérité de SqlSmoObject.) | |
GetTextBody() () () () | Returns the text body. (hérité de ScriptNameObjectBase.) | |
GetTextBody(Boolean) | Returns the text body. (hérité de ScriptNameObjectBase.) | |
GetTextForScript(ScriptingOptions, Boolean, array<String> [] () [] []) | Gets the text for scripting. (hérité de ScriptNameObjectBase.) | |
GetTextForScript(ScriptingOptions, Boolean, array<String> [] () [] [], Boolean) | Gets the text of script object. (hérité de ScriptNameObjectBase.) | |
GetTextHeader | Returns the text header. (hérité de ScriptNameObjectBase.) | |
GetTextMode | Determines whether the script name is using text mode. (hérité de ScriptNameObjectBase.) | |
GetTextProperty(String) | Gets the property as text. (hérité de ScriptNameObjectBase.) | |
GetTextProperty(String, ScriptingOptions) | Gets the property as text. (hérité de ScriptNameObjectBase.) | |
GetTimeSpanParameterAsInt | Affecte un paramètre d'intervalle de temps de l'objet SqlSmoObject. (hérité de SqlSmoObject.) | |
GetType | (hérité de Object.) | |
GetUrnRecursive(StringBuilder) | Affecte un objet Urn de l'objet SqlSmoObject. (hérité de SqlSmoObject.) | |
GetUrnRecursive(StringBuilder, UrnIdOption) | Affecte un objet Urn de l'objet SqlSmoObject. (hérité de SqlSmoObject.) | |
ImplInitialize | Initialise les champs de l'objet SqlSmoObject. (hérité de SqlSmoObject.) | |
Initialize() () () () | Initialise l'objet et force le chargement des propriétés. (hérité de SqlSmoObject.) | |
Initialize(Boolean) | Initialise l'objet et force le chargement des propriétés. (hérité de SqlSmoObject.) | |
IsObjectDirty | Determines whether the referenced object is consistent with the stored object. (hérité de ScriptNameObjectBase.) | |
IsObjectInitialized | Vérifie si l'objet a été initialisé. (hérité de SqlSmoObject.) | |
IsObjectInSpace | Vérifie si l'objet est isolé ou connecté à l'instance de SQL Server. (hérité de SqlSmoObject.) | |
IsVersion80SP3 | Détermine si la version de SQL Server est SQL Server 2000 avec SP3. (hérité de SqlSmoObject.) | |
IsVersion90AndAbove | Détermine si la version de SQL Server est SQL Server 2005 ou une version ultérieure. (hérité de SqlSmoObject.) | |
MarkDropped | Définit l'objet SqlSmoState à supprimer. (hérité de SqlSmoObject.) | |
MarkForDropImpl | Définit l'objet SqlSmoState à supprimer. (hérité de SqlSmoObject.) | |
MemberwiseClone | (hérité de Object.) | |
PostAlter | Méthode activée après la modification du SqlSmoObject. (hérité de SqlSmoObject.) | |
PostCreate | Méthode activée après la création du SqlSmoObject. (hérité de SqlSmoObject.) | |
PostDrop | Méthode activée après la suppression du SqlSmoObject. (hérité de SqlSmoObject.) | |
ReadBackupHeader | Enumerates the contents of the media maintained by a backup device or operating system file. | |
ReadMediaHeader | Enumerates the values of a backup media header record. | |
Refresh | Refreshes the script name. (hérité de ScriptNameObjectBase.) | |
RenameImpl | Identifié à titre d'information uniquement. Non pris en charge. La compatibilité future n'est pas garantie. (hérité de NamedSmoObject.) | |
RenameImplWorker | Identifié à titre d'information uniquement. Non pris en charge. La compatibilité future n'est pas garantie. (hérité de NamedSmoObject.) | |
Script() () () () | Generates a Transact-SQL script that can be used to re-create the backup device. | |
Script(ScriptingOptions) | Generates a Transact-SQL script that can be used to re-create the backup device as specified by the script options. | |
ScriptAlter | Modifie l'objet SqlSmoObject d'après les paramètres. (hérité de SqlSmoObject.) | |
ScriptAnsiQI | Scripts the database object in ANSI text. (hérité de ScriptNameObjectBase.) | |
ScriptChangeOwner | This method supports the SMO infrastructure and is not intended to be used directly from your code. (hérité de NamedSmoObject.) | |
ScriptCreate | Modifie l'objet SqlSmoObject d'après les paramètres. (hérité de SqlSmoObject.) | |
ScriptDdl | Lève une exception InvalidSmoOperationException. (hérité de SqlSmoObject.) | |
ScriptDrop | Lève une exception InvalidSmoOperationException. (hérité de SqlSmoObject.) | |
ScriptImpl() () () () | Obtient une collection de scripts du SqlSmoObject. (hérité de SqlSmoObject.) | |
ScriptImpl(ScriptingOptions) | Obtient une collection de scripts du SqlSmoObject. (hérité de SqlSmoObject.) | |
ScriptImplWorker | Obtient une collection de scripts du SqlSmoObject. (hérité de SqlSmoObject.) | |
ScriptInformativeHeaders | Scripts the information headers. (hérité de ScriptNameObjectBase.) | |
ScriptOwner | Alters the script owner authorization. (hérité de NamedSmoObject.) | |
ScriptRename | This method supports the SMO infrastructure and is not intended to be used directly from your code. (hérité de NamedSmoObject.) | |
SetCollectionTextMode | Sets the collection text mode. (hérité de ScriptNameObjectBase.) | |
SetIsSystemNamed | Sets a Boolean value that specifies whether the system is named. (hérité de ScriptNameObjectBase.) | |
SetParentImpl | Définit le parent du SqlSmoObject sur le paramètre newParent. (hérité de SqlSmoObject.) | |
SetSchemaOwned | Sets the schema owned value. (hérité de NamedSmoObject.) | |
SetTextBody | Specifies the text body. (hérité de ScriptNameObjectBase.) | |
SetTextHeader | Specifies the text header. (hérité de ScriptNameObjectBase.) | |
SetTextMode | Specifies the text mode. (hérité de ScriptNameObjectBase.) | |
SwitchTextMode | Switches the text mode. (hérité de ScriptNameObjectBase.) | |
ThrowIfTextIsDirtyForAlter | Throws an exception of text has been modified and not persisted. (hérité de ScriptNameObjectBase.) | |
ToString | Retourne un String qui représente l'objet référencé. (hérité de SqlSmoObject.) | |
TouchImpl | Non implémenté. (hérité de SqlSmoObject.) | |
UnbindDefaultImpl | Annule la liaison des colonnes par défaut du SqlSmoObject. (hérité de SqlSmoObject.) | |
UnbindRuleImpl | Annule la liaison des règles du SqlSmoObject. (hérité de SqlSmoObject.) | |
Validate | Validates the state of an object. (hérité de SmoObjectBase.) |
Haut de la page
Événements
Nom | Description | |
---|---|---|
PropertyChanged | Représente l'événement qui se produit lorsqu'une propriété est modifiée. (hérité de SqlSmoObject.) | |
PropertyMetadataChanged | Représente l'événement qui se produit lorsque les métadonnées de la propriété sont modifiées. (hérité de SqlSmoObject.) |
Haut de la page
Champs
Nom | Description | |
---|---|---|
m_ExtendedProperties | Représente une propriété définie pour étendre les propriétés fournies par un SqlSmoObject. (hérité de SqlSmoObject.) | |
singletonParent | Représente le parent de singleton. (hérité de SqlSmoObject.) |
Haut de la page
Implémentations d'interfaces explicites
Nom | Description | |
---|---|---|
IAlienObject. . :: . .Discover | Découvre les éventuelles dépendances. Ne référencez pas directement ce membre dans votre code. Il prend en charge l'infrastructure SQL Server. (hérité de SqlSmoObject.) | |
IAlienObject. . :: . .GetDomainRoot | Retourne la racine du domaine. (hérité de SqlSmoObject.) | |
IAlienObject. . :: . .GetParent | Obtient le parent de cet objet. Ne référencez pas directement ce membre dans votre code. Il prend en charge l'infrastructure SQL Server. (hérité de SqlSmoObject.) | |
IAlienObject. . :: . .GetPropertyType | Obtient le type de la propriété spécifiée. (hérité de SqlSmoObject.) | |
IAlienObject. . :: . .GetPropertyValue | Obtient la valeur de la propriété spécifiée. (hérité de SqlSmoObject.) | |
IAlienObject. . :: . .GetUrn | Obtient l'URN (Uniform Resource Name) de l'objet. Ne référencez pas directement ce membre dans votre code. Il prend en charge l'infrastructure SQL Server. (hérité de SqlSmoObject.) | |
IAlienObject. . :: . .Resolve | Obtient l'instance qui contient les informations relatives à l'objet de l'URN (Unified Resource Name) de l'objet. (hérité de SqlSmoObject.) | |
IAlienObject. . :: . .SetObjectState | Définit l'état de l'objet sur la valeur SfcObjectState spécifiée. (hérité de SqlSmoObject.) | |
IAlienObject. . :: . .SetPropertyValue | Définit la valeur de la propriété. (hérité de SqlSmoObject.) | |
ISfcPropertyProvider. . :: . .GetPropertySet | Obtient la référence d'interface au jeu de propriétés de cet objet. Ne référencez pas directement ce membre dans votre code. Il prend en charge l'infrastructure SQL Server. (hérité de SqlSmoObject.) |
Haut de la page
Notes
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.
Sécurité des threads
Tous les membres publics static (Shared dans Visual Basic) de ce type sont thread-safe. Tous les membres de l'instance ne sont pas garantis comme étant thread-safe.
Voir aussi