BackupDevice 클래스

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

상속 계층

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

네임스페이스:  Microsoft.SqlServer.Management.Smo
어셈블리:  Microsoft.SqlServer.Smo(Microsoft.SqlServer.Smo.dll)

구문

‘선언
<PhysicalFacetAttribute> _
<EvaluationModeAttribute(AutomatedPolicyEvaluationMode.CheckOnSchedule)> _
Public NotInheritable Class BackupDevice _
    Inherits ScriptNameObjectBase _
    Implements ICreatable, IDroppable, IScriptable
‘사용 방법
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

BackupDevice 유형에서 다음 멤버를 표시합니다.

생성자

	이름	설명
	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.

맨 위로 이동

속성

	이름	설명
	BackupDeviceType	Gets or sets the type of backup device of the backup device.
	ExecuteForScalar	스칼라 옵션을 실행하도록 개체를 설정할지 여부를 지정하는 Boolean 속성 값을 가져오거나 설정합니다. (SqlSmoObject에서 상속됨)
	IsTouched	개체 속성이 업데이트되었으나 아직 서버에 유지되는지 여부를 지정하는 Boolean 속성 값을 가져옵니다. (SqlSmoObject에서 상속됨)
	Name	Gets or sets the name of the object. (NamedSmoObject에서 상속됨)
	ObjectInSpace	개체가 분리되어 존재하는지, 아니면 SQL Server 인스턴스에 직접 또는 간접 연결되는지를 지정하는 Boolean 속성 값을 가져옵니다. (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	개체 속성을 나타내는 Property 개체의 컬렉션을 가져옵니다. (SqlSmoObject에서 상속됨)
	ScalarResult	참조된 개체의 스칼라 결과를 가져옵니다. (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. (SmoObjectBase에서 상속됨)
	Urn	개체를 고유하게 식별하는 URN(Uniform Resource Name) 주소 값을 가져옵니다. (SqlSmoObject에서 상속됨)
	UserData	Gets or sets user-defined data associated with the referenced object. (SmoObjectBase에서 상속됨)

맨 위로 이동

메서드

	이름	설명
	AddDatabaseContext(StringCollection)	queries 매개 변수로 식별되는 쿼리 컬렉션에 데이터베이스 컨텍스트를 추가합니다. (SqlSmoObject에서 상속됨)
	AddDatabaseContext(StringCollection, ScriptingOptions)	queries 매개 변수로 식별되는 쿼리 컬렉션에 지정한 스크립팅 옵션을 사용하여 데이터베이스 컨텍스트를 추가합니다. (SqlSmoObject에서 상속됨)
	AlterImpl	개체 변경 이벤트를 활성화합니다. (SqlSmoObject에서 상속됨)
	AlterImplFinish	개체 변경 이벤트가 완료되면 호출되는 메서드입니다. (SqlSmoObject에서 상속됨)
	AlterImplInit	개체 변경 이벤트가 초기화되면 호출되는 메서드입니다. (SqlSmoObject에서 상속됨)
	AlterImplWorker	변경 메서드를 호출합니다. (SqlSmoObject에서 상속됨)
	AppendCommaText	Appends text, optionally separated by a comma. (ScriptNameObjectBase에서 상속됨)
	AppendWithCommaText	Appends text, optionally separated by a comma. (ScriptNameObjectBase에서 상속됨)
	AppendWithOption	Appends text and option text separated from the main text with a “WITH” string and optionally separated by a comma. (ScriptNameObjectBase에서 상속됨)
	AutoGenerateName	Generates a name based on the object Guid. (ScriptNameObjectBase에서 상속됨)
	BindDefaultImpl	매개 변수로 식별된 기본 항목을 바인딩합니다. (SqlSmoObject에서 상속됨)
	BindRuleImpl	규칙 스키마를 매개 변수로 식별된 열과 규칙에 바인딩합니다. (SqlSmoObject에서 상속됨)
	CheckCollation	collationName 매개 변수로 식별된 데이터 정렬 메서드를 사용하여 스크립팅 옵션의 순서를 확인합니다. (SqlSmoObject에서 상속됨)
	CheckObjectDirty	Checks whether object has been modified and not persisted. (ScriptNameObjectBase에서 상속됨)
	CheckObjectState() () () ()	참조된 개체의 상태를 검사합니다. (SqlSmoObject에서 상속됨)
	CheckObjectState(Boolean)	개체가 아직 만들어지지 않았을 경우 예외를 발생시키도록 지정하는 옵션을 사용하여 참조된 개체의 상태를 검사합니다. (SqlSmoObject에서 상속됨)
	CheckObjectStateImpl	SqlSmoObject 의 상태를 확인합니다. (SqlSmoObject에서 상속됨)
	CheckTextCorectness	Checks text for correctness against the parameters. (ScriptNameObjectBase에서 상속됨)
	CheckTextModeSupport	Checks mode of support. (ScriptNameObjectBase에서 상속됨)
	CheckVersion100	SQL Server 버전이 SQL Server 2008인지 여부를 확인합니다. (SqlSmoObject에서 상속됨)
	CheckVersion80	SQL Server 2000에서 개체의 유효성을 검사합니다. (SqlSmoObject에서 상속됨)
	CheckVersion80SP3	SQL Server 2000 SP3에서 개체의 유효성을 검사합니다. (SqlSmoObject에서 상속됨)
	CheckVersion90	SQL Server 2005에서 개체의 유효성을 검사합니다. (SqlSmoObject에서 상속됨)
	CheckVersionBelow90	SQL Server 버전이 SQL Server 2005 이전 버전인지 여부를 확인합니다. (SqlSmoObject에서 상속됨)
	CleanObject	Cleans the referenced object. (ScriptNameObjectBase에서 상속됨)
	Create	Creates a new backup device on the instance of SQL Server as defined by the BackupDevice object.
	CreateImpl	스크립팅 옵션을 사용하여 개체를 만듭니다. (SqlSmoObject에서 상속됨)
	CreateImplFinish	만들기 이벤트가 완료되면 호출되는 메서드입니다. (SqlSmoObject에서 상속됨)
	CreateImplInit	만들기 이벤트가 초기화되면 호출되는 메서드입니다. (SqlSmoObject에서 상속됨)
	Discover	Object 유형의 목록을 검색합니다. (SqlSmoObject에서 상속됨)
	Drop	Drops an existing backup device.
	DropImpl	SqlSmoObject 를 삭제합니다. (SqlSmoObject에서 상속됨)
	DropImplWorker	삭제 메서드를 호출합니다. (SqlSmoObject에서 상속됨)
	EnumScriptImpl	so 매개 변수로 지정한 스크립트를 열거합니다. (SqlSmoObject에서 상속됨)
	EnumScriptImplWorker	so 매개 변수로 지정한 스크립트를 열거하는 메서드를 호출합니다. (SqlSmoObject에서 상속됨)
	EnumScriptImplWorkerSOChanged	개체의 스크립팅 옵션을 설명하는 IEnumerable 문자열을 반환합니다. (SqlSmoObject에서 상속됨)
	Equals	(Object에서 상속됨)
	ExecuteNonQuery	(SqlSmoObject에서 상속됨)
	Finalize	(Object에서 상속됨)
	ForceTextModeOnTextBody	Enforces text mode on the text body. (ScriptNameObjectBase에서 상속됨)
	FormatSqlVariant	개체를 SqlVariant 형식으로 지정합니다. (SqlSmoObject에서 상속됨)
	GenerateDataSpaceFileStreamScript	데이터 파일을 만드는 스크립트를 생성합니다. (SqlSmoObject에서 상속됨)
	GenerateDataSpaceScript	데이터 파일에 공간을 할당하는 스크립트를 생성합니다. (SqlSmoObject에서 상속됨)
	GetBindDefaultScript	defSchema 및 defName 매개 변수로 지정한 기본값을 바인딩하는 스크립트를 가져옵니다. (SqlSmoObject에서 상속됨)
	GetBindRuleScript	바인딩 규칙을 지정하는 스크립트를 가져옵니다. (SqlSmoObject에서 상속됨)
	GetBoolParameter(StringBuilder, ScriptingOptions, String, String, Int32%)	SqlSmoObject 의 부울 매개 변수를 할당합니다. (SqlSmoObject에서 상속됨)
	GetBoolParameter(StringBuilder, ScriptingOptions, String, String, Int32%, Boolean)	SqlSmoObject 의 부울 속성을 할당합니다. (SqlSmoObject에서 상속됨)
	GetBraketNameForText	Gets the bracket name. (ScriptNameObjectBase에서 상속됨)
	GetDateTimeParameter	SqlSmoObject 의 datetime 속성을 할당합니다. (SqlSmoObject에서 상속됨)
	GetDateTimeParameterAsInt	datetime 속성이 Null이 아닐 경우 SqlSmoObject의 datetime 속성을 정수 값으로 지정합니다. (SqlSmoObject에서 상속됨)
	GetDBName	개체에 연결된 데이터베이스 이름을 가져옵니다. (SqlSmoObject에서 상속됨)
	GetEnumParameter	SqlSmoObject 의 열거 속성을 할당합니다. (SqlSmoObject에서 상속됨)
	GetFragOptionString	FragmentationOption 개체를 문자열 값으로 가져옵니다. (SqlSmoObject에서 상속됨)
	GetGuidParameter	SqlSmoObject 의 Guid 속성을 할당합니다. (SqlSmoObject에서 상속됨)
	GetHashCode	(Object에서 상속됨)
	GetIsSystemNamed	Gets a Boolean value that specifies whether the system is named. (ScriptNameObjectBase에서 상속됨)
	GetIsTextDirty	Determines whether the text value is consistent with stored value. (ScriptNameObjectBase에서 상속됨)
	GetParameter(StringBuilder, ScriptingOptions, String, String, Int32%)	SqlSmoObject 의 매개 변수를 할당합니다. (SqlSmoObject에서 상속됨)
	GetParameter(StringBuilder, ScriptingOptions, String, String, Int32%, Boolean)	SqlSmoObject 의 매개 변수를 할당합니다. (SqlSmoObject에서 상속됨)
	GetPropValue	SqlSmoObject 개체의 속성 값을 가져옵니다. (SqlSmoObject에서 상속됨)
	GetPropValueOptional	SqlSmoObject 개체의 속성 값을 가져옵니다. (SqlSmoObject에서 상속됨)
	GetPropValueOptionalAllowNull	SqlSmoObject 개체의 속성 값을 가져옵니다. (SqlSmoObject에서 상속됨)
	GetRealValue	SqlSmoObject 개체의 속성 값을 가져옵니다. (SqlSmoObject에서 상속됨)
	GetScriptIncludeExists	Gets the script including the test for existence of type being scripted. (ScriptNameObjectBase에서 상속됨)
	GetScriptingOptionsForCreate	SqlSmoObject 개체에 대한 ScriptingOptions를 가져옵니다. (SqlSmoObject에서 상속됨)
	GetServerName	개체에 연결된 SQL Server 인스턴스의 이름을 가져옵니다. (SqlSmoObject에서 상속됨)
	GetServerObject	SqlSmoObject 개체의 서버를 가져옵니다. (SqlSmoObject에서 상속됨)
	GetSqlServerVersionName	개체에 연결된 SQL Server 인스턴스의 버전을 가져옵니다. (SqlSmoObject에서 상속됨)
	GetStringParameter(StringBuilder, ScriptingOptions, String, String, Int32%)	SqlSmoObject 개체의 문자열 매개 변수를 할당합니다. (SqlSmoObject에서 상속됨)
	GetStringParameter(StringBuilder, ScriptingOptions, String, String, Int32%, Boolean)	SqlSmoObject 개체의 문자열 매개 변수를 할당합니다. (SqlSmoObject에서 상속됨)
	GetTextBody() () () ()	Returns the text body. (ScriptNameObjectBase에서 상속됨)
	GetTextBody(Boolean)	Returns the text body. (ScriptNameObjectBase에서 상속됨)
	GetTextForScript(ScriptingOptions, Boolean, array<String> [] () [] [])	Gets the text for scripting. (ScriptNameObjectBase에서 상속됨)
	GetTextForScript(ScriptingOptions, Boolean, array<String> [] () [] [], Boolean)	Gets the text of script object. (ScriptNameObjectBase에서 상속됨)
	GetTextHeader	Returns the text header. (ScriptNameObjectBase에서 상속됨)
	GetTextMode	Determines whether the script name is using text mode. (ScriptNameObjectBase에서 상속됨)
	GetTextProperty(String)	Gets the property as text. (ScriptNameObjectBase에서 상속됨)
	GetTextProperty(String, ScriptingOptions)	Gets the property as text. (ScriptNameObjectBase에서 상속됨)
	GetTimeSpanParameterAsInt	SqlSmoObject 개체의 시간 범위 매개 변수를 할당합니다. (SqlSmoObject에서 상속됨)
	GetType	(Object에서 상속됨)
	GetUrnRecursive(StringBuilder)	SqlSmoObject 개체의 Urn 개체를 할당합니다. (SqlSmoObject에서 상속됨)
	GetUrnRecursive(StringBuilder, UrnIdOption)	SqlSmoObject 개체의 Urn 개체를 할당합니다. (SqlSmoObject에서 상속됨)
	ImplInitialize	SqlSmoObject 개체의 필드를 초기화합니다. (SqlSmoObject에서 상속됨)
	Initialize() () () ()	개체를 초기화하고 속성을 강제로 로드합니다. (SqlSmoObject에서 상속됨)
	Initialize(Boolean)	개체를 초기화하고 속성을 강제로 로드합니다. (SqlSmoObject에서 상속됨)
	IsObjectDirty	Determines whether the referenced object is consistent with the stored object. (ScriptNameObjectBase에서 상속됨)
	IsObjectInitialized	개체가 초기화되었는지 여부를 검사합니다. (SqlSmoObject에서 상속됨)
	IsObjectInSpace	개체가 분리되는지, 아니면 SQL Server 인스턴스에 연결되는지를 검사합니다. (SqlSmoObject에서 상속됨)
	IsVersion80SP3	SQL Server의 버전이 SQL Server 2000 서비스 팩 3인지 여부를 확인합니다. (SqlSmoObject에서 상속됨)
	IsVersion90AndAbove	SQL Server의 버전이 SQL Server 2005 이상인지 여부를 확인합니다. (SqlSmoObject에서 상속됨)
	MarkDropped	SqlSmoState 를 dropped로 설정합니다. (SqlSmoObject에서 상속됨)
	MarkForDropImpl	SqlSmoState 를 dropped로 설정합니다. (SqlSmoObject에서 상속됨)
	MemberwiseClone	(Object에서 상속됨)
	PostAlter	SqlSmoObject 가 변경된 후 활성화된 메서드입니다. (SqlSmoObject에서 상속됨)
	PostCreate	SqlSmoObject 가 생성된 후 활성화된 메서드입니다. (SqlSmoObject에서 상속됨)
	PostDrop	SqlSmoObject 가 삭제된 후 활성화된 메서드입니다. (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. (ScriptNameObjectBase에서 상속됨)
	RenameImpl	정보를 제공하기 위해서만 확인됩니다. 지원되지 않습니다. 향후 호환성은 보장되지 않습니다. (NamedSmoObject에서 상속됨)
	RenameImplWorker	정보를 제공하기 위해서만 확인됩니다. 지원되지 않습니다. 향후 호환성은 보장되지 않습니다. (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	매개 변수에 따라 SqlSmoObject를 변경합니다. (SqlSmoObject에서 상속됨)
	ScriptAnsiQI	Scripts the database object in ANSI text. (ScriptNameObjectBase에서 상속됨)
	ScriptChangeOwner	This method supports the SMO infrastructure and is not intended to be used directly from your code. (NamedSmoObject에서 상속됨)
	ScriptCreate	매개 변수에 따라 SqlSmoObject를 변경합니다. (SqlSmoObject에서 상속됨)
	ScriptDdl	InvalidSmoOperationException 을 발생합니다. (SqlSmoObject에서 상속됨)
	ScriptDrop	InvalidSmoOperationException 을 발생합니다. (SqlSmoObject에서 상속됨)
	ScriptImpl() () () ()	SqlSmoObject 의 스크립트 컬렉션을 가져옵니다. (SqlSmoObject에서 상속됨)
	ScriptImpl(ScriptingOptions)	SqlSmoObject 의 스크립트 컬렉션을 가져옵니다. (SqlSmoObject에서 상속됨)
	ScriptImplWorker	SqlSmoObject 의 스크립트 컬렉션을 가져옵니다. (SqlSmoObject에서 상속됨)
	ScriptInformativeHeaders	Scripts the information headers. (ScriptNameObjectBase에서 상속됨)
	ScriptOwner	Alters the script owner authorization. (NamedSmoObject에서 상속됨)
	ScriptRename	This method supports the SMO infrastructure and is not intended to be used directly from your code. (NamedSmoObject에서 상속됨)
	SetCollectionTextMode	Sets the collection text mode. (ScriptNameObjectBase에서 상속됨)
	SetIsSystemNamed	Sets a Boolean value that specifies whether the system is named. (ScriptNameObjectBase에서 상속됨)
	SetParentImpl	SqlSmoObject 의 부모를 newParent 매개 변수로 설정합니다. (SqlSmoObject에서 상속됨)
	SetSchemaOwned	Sets the schema owned value. (NamedSmoObject에서 상속됨)
	SetTextBody	Specifies the text body. (ScriptNameObjectBase에서 상속됨)
	SetTextHeader	Specifies the text header. (ScriptNameObjectBase에서 상속됨)
	SetTextMode	Specifies the text mode. (ScriptNameObjectBase에서 상속됨)
	SwitchTextMode	Switches the text mode. (ScriptNameObjectBase에서 상속됨)
	ThrowIfTextIsDirtyForAlter	Throws an exception of text has been modified and not persisted. (ScriptNameObjectBase에서 상속됨)
	ToString	참조된 개체를 나타내는 String을 반환합니다. (SqlSmoObject에서 상속됨)
	TouchImpl	구현되지 않았습니다. (SqlSmoObject에서 상속됨)
	UnbindDefaultImpl	SqlSmoObject 의 기본 열을 바인딩 해제합니다. (SqlSmoObject에서 상속됨)
	UnbindRuleImpl	SqlSmoObject 의 규칙을 바인딩 해제합니다. (SqlSmoObject에서 상속됨)
	Validate	Validates the state of an object. (SmoObjectBase에서 상속됨)

맨 위로 이동

이벤트

	이름	설명
	PropertyChanged	속성이 변경될 때 발생하는 이벤트를 나타냅니다. (SqlSmoObject에서 상속됨)
	PropertyMetadataChanged	속성 메타데이터가 변경될 때 발생하는 이벤트를 나타냅니다. (SqlSmoObject에서 상속됨)

맨 위로 이동

필드

	이름	설명
	m_ExtendedProperties	SqlSmoObject 에서 제공하는 속성을 확장하도록 정의된 속성을 나타냅니다. (SqlSmoObject에서 상속됨)
	singletonParent	단일 부모를 나타냅니다. (SqlSmoObject에서 상속됨)

맨 위로 이동

명시적 인터페이스 구현

	이름	설명
	IAlienObject. . :: . .Discover	모든 종속성을 검색합니다. 코드에서 직접 이 멤버를 참조하면 안 됩니다. 이 방법은 SQL Server 인프라를 지원합니다. (SqlSmoObject에서 상속됨)
	IAlienObject. . :: . .GetDomainRoot	도메인의 루트를 반환합니다. (SqlSmoObject에서 상속됨)
	IAlienObject. . :: . .GetParent	이 개체의 부모를 가져옵니다. 코드에서 직접 이 멤버를 참조하면 안 됩니다. 이 방법은 SQL Server 인프라를 지원합니다. (SqlSmoObject에서 상속됨)
	IAlienObject. . :: . .GetPropertyType	지정한 속성의 유형을 가져옵니다. (SqlSmoObject에서 상속됨)
	IAlienObject. . :: . .GetPropertyValue	지정한 속성의 값을 가져옵니다. (SqlSmoObject에서 상속됨)
	IAlienObject. . :: . .GetUrn	개체의 URN(Unified Resource Name)을 가져옵니다. 코드에서 직접 이 멤버를 참조하면 안 됩니다. 이 방법은 SQL Server 인프라를 지원합니다. (SqlSmoObject에서 상속됨)
	IAlienObject. . :: . .Resolve	개체의 URN(Unified Resource Name)에서 개체에 대한 정보를 포함하는 인스턴스를 가져옵니다. (SqlSmoObject에서 상속됨)
	IAlienObject. . :: . .SetObjectState	개체 상태를 지정한 SfcObjectState 값으로 설정합니다. (SqlSmoObject에서 상속됨)
	IAlienObject. . :: . .SetPropertyValue	속성 값을 설정합니다. (SqlSmoObject에서 상속됨)
	ISfcPropertyProvider. . :: . .GetPropertySet	이 개체의 속성 집합에 대한 인터페이스 참조를 가져옵니다. 코드에서 직접 이 멤버를 참조하면 안 됩니다. 이 방법은 SQL Server 인프라를 지원합니다. (SqlSmoObject에서 상속됨)

맨 위로 이동

주의

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.

예

데이터베이스 및 트랜잭션 로그 백업 및 복원

스레드 보안

이 유형의 모든 공용 static(Visual Basic에서는 Shared) 멤버는 스레드로부터 안전합니다. 인스턴스 멤버는 스레드로부터의 안전성이 보장되지 않습니다.

참고 항목

참조

Microsoft.SqlServer.Management.Smo 네임스페이스

관련 자료

백업 장치