BackupDevice クラス
BackupDevice オブジェクトを使用すると、プログラムで SQL Server バックアップ デバイスにアクセスできます。
継承階層
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)
構文
'宣言
<EvaluationModeAttribute(AutomatedPolicyEvaluationMode.CheckOnSchedule)> _
<PhysicalFacetAttribute> _
Public NotInheritable Class BackupDevice _
Inherits ScriptNameObjectBase _
Implements ICreatable, IDroppable, IScriptable
'使用
Dim instance As BackupDevice
[EvaluationModeAttribute(AutomatedPolicyEvaluationMode.CheckOnSchedule)]
[PhysicalFacetAttribute]
public sealed class BackupDevice : ScriptNameObjectBase,
ICreatable, IDroppable, IScriptable
[EvaluationModeAttribute(AutomatedPolicyEvaluationMode::CheckOnSchedule)]
[PhysicalFacetAttribute]
public ref class BackupDevice sealed : public ScriptNameObjectBase,
ICreatable, IDroppable, IScriptable
[<SealedAttribute>]
[<EvaluationModeAttribute(AutomatedPolicyEvaluationMode.CheckOnSchedule)>]
[<PhysicalFacetAttribute>]
type BackupDevice =
class
inherit ScriptNameObjectBase
interface ICreatable
interface IDroppable
interface IScriptable
end
public final class BackupDevice extends ScriptNameObjectBase implements ICreatable, IDroppable, IScriptable
BackupDevice 型は、以下のメンバーを公開しています。
コンストラクター
| 名前 | 説明 | |
|---|---|---|
.gif "パブリック メソッド") |
BackupDevice() | BackupDevice クラスの新しいインスタンスを初期化します。 |
|
BackupDevice(Server, String) | 指定した SQL Server のインスタンスで、指定した名前を使用して、BackupDevice クラスの新しいインスタンスを初期化します。 |
先頭に戻る
プロパティ
| 名前 | 説明 | |
|---|---|---|
.gif "パブリック プロパティ") |
BackupDeviceType | バックアップ デバイスの種類を取得します。値の設定も可能です。 |
|
Name | オブジェクトの名前を取得または設定します。 (NamedSmoObject から継承されています。) |
|
Parent | BackupDevice オブジェクトを所有する Server オブジェクトを取得します。 |
|
PhysicalLocation | バックアップの物理的な場所を表すデバイスまたはオペレーティング システム ファイルへのパスを取得します。値の設定も可能です。 |
|
Properties | オブジェクトのプロパティを表す Property オブジェクトのコレクションを取得します。 (SqlSmoObject から継承されています。) |
|
SkipTapeLabel | テープ ラベルが正しいことを確認するかどうかを示す Boolean プロパティ値を取得します。値の設定も可能です。 |
|
State | 参照先のオブジェクトの状態を取得します。 (SmoObjectBase から継承されています。) |
|
Urn | オブジェクトを一意に識別する URN (Uniform Resource Name) アドレスの値を取得します。 (SqlSmoObject から継承されています。) |
|
UserData | 参照先のオブジェクトに関連付けられたユーザー定義データを取得します。値の設定も可能です。 (SmoObjectBase から継承されています。) |
先頭に戻る
メソッド
| 名前 | 説明 | |
|---|---|---|
|
Create | SQL Server のインスタンスで、BackupDevice オブジェクトによる定義に基づいて、新しいバックアップ デバイスを作成します。 |
|
Discover | Object 型の一覧を検出します。 (SqlSmoObject から継承されています。) |
|
Drop | 既存のバックアップ デバイスを削除します。 |
|
Equals | (Object から継承されています。) |
.gif "プロテクト メソッド") |
FormatSqlVariant | SqlVariant 型としてオブジェクトの書式を設定します。 (SqlSmoObject から継承されています。) |
|
GetContextDB | このオブジェクトに関連付けられているコンテキスト データベースを取得します。 (SqlSmoObject から継承されています。) |
|
GetDBName | オブジェクトに関連付けられたデータベース名を取得します。 (SqlSmoObject から継承されています。) |
|
GetHashCode | (Object から継承されています。) |
|
GetPropValue | SqlSmoObject オブジェクトのプロパティの値を取得します。 (SqlSmoObject から継承されています。) |
|
GetPropValueOptional | SqlSmoObject オブジェクトのプロパティの値を取得します。 (SqlSmoObject から継承されています。) |
|
GetPropValueOptionalAllowNull | SqlSmoObject オブジェクトのプロパティの値を取得します。 (SqlSmoObject から継承されています。) |
|
GetServerObject | SqlSmoObject オブジェクトのサーバーを取得します。 (SqlSmoObject から継承されています。) |
|
GetType | (Object から継承されています。) |
|
Initialize() | オブジェクトを初期化し、プロパティを強制的に読み込ませます。 (SqlSmoObject から継承されています。) |
|
Initialize(Boolean) | オブジェクトを初期化し、プロパティを強制的に読み込ませます。 (SqlSmoObject から継承されています。) |
|
IsObjectInitialized | オブジェクトが初期化されたかどうかを確認します。 (SqlSmoObject から継承されています。) |
|
IsObjectInSpace | オブジェクトが孤立しているか、または SQL Server のインスタンスに接続されているかを確認します。 (SqlSmoObject から継承されています。) |
|
ReadBackupHeader | バックアップ デバイスまたはオペレーティング システム ファイルで管理されているメディアの内容を列挙します。 |
|
ReadMediaHeader | バックアップ メディアのヘッダー レコードの値を列挙します。 |
|
Refresh | スクリプト名を更新します。 (ScriptNameObjectBase から継承されています。) |
|
Script() | バックアップ デバイスの再作成に使用できる Transact-SQL スクリプトを生成します。 |
|
Script(ScriptingOptions) | スクリプト オプションで指定したとおりにバックアップ デバイスを再作成するために使用できる Transact-SQL スクリプトを生成します。 |
|
SetParentImpl | SqlSmoObject の親を newParent パラメーターに設定します。 (SqlSmoObject から継承されています。) |
|
ToString | 参照するオブジェクトを表す String を返します。 (SqlSmoObject から継承されています。) |
|
Validate | オブジェクトの状態を検証します。 (SmoObjectBase から継承されています。) |
先頭に戻る
イベント
| 名前 | 説明 | |
|---|---|---|
.gif "パブリック イベント") |
PropertyChanged | プロパティが変更されるときに発生するイベントを表します。 (SqlSmoObject から継承されています。) |
|
PropertyMetadataChanged | プロパティ メタデータが変更されたときに発生するイベントを表します。 (SqlSmoObject から継承されています。) |
先頭に戻る
明示的なインターフェイスの実装
| 名前 | 説明 | |
|---|---|---|
.gif "明示的なインターフェイスの実装") .gif "プライベート メソッド") |
IAlienObject.Discover | 依存関係を検出します。このメンバーをコード内で直接参照しないでください。このメンバーは、SQL Server インフラストラクチャをサポートしています。 (SqlSmoObject から継承されています。) |
|
IAlienObject.GetDomainRoot | ドメインのルートを返します。 (SqlSmoObject から継承されています。) |
|
IAlienObject.GetParent | このオブジェクトの親を取得します。このメンバーをコード内で直接参照しないでください。このメンバーは、SQL Server インフラストラクチャをサポートしています。 (SqlSmoObject から継承されています。) |
|
IAlienObject.GetPropertyType | 指定したプロパティの種類を取得します。 (SqlSmoObject から継承されています。) |
|
IAlienObject.GetPropertyValue | 指定されたプロパティの値を取得します。 (SqlSmoObject から継承されています。) |
|
IAlienObject.GetUrn | オブジェクトの Unified Resource Name (URN) を取得します。このメンバーをコード内で直接参照しないでください。このメンバーは、SQL Server インフラストラクチャをサポートしています。 (SqlSmoObject から継承されています。) |
|
IAlienObject.Resolve | オブジェクトに関する情報を含むインスタンスを、オブジェクトの Unified Resource Name (URN) から取得します。 (SqlSmoObject から継承されています。) |
|
IAlienObject.SetObjectState | オブジェクトの状態を、指定した SfcObjectState 値に設定します。 (SqlSmoObject から継承されています。) |
|
IAlienObject.SetPropertyValue | プロパティの値を設定します。 (SqlSmoObject から継承されています。) |
|
ISfcPropertyProvider.GetPropertySet | このオブジェクトのプロパティ セットへのインターフェイス リファレンスを取得します。このメンバーをコード内で直接参照しないでください。このメンバーは、SQL Server インフラストラクチャをサポートしています。 (SqlSmoObject から継承されています。) |
先頭に戻る
説明
SQL Server バックアップ デバイスにより、特定のバックアップ メディア (通常はテープ) の動作が決定されます。 バックアップ デバイスは、BACKUP ステートメントや RESTORE ステートメントを実行するときにも、Backup オブジェクトを使用するときにも必要ありません。
BackupDevice オブジェクトを使用すると次のような操作を実行できます。
Microsoft SQL Server を実行しているサーバーの新しいバックアップ デバイスの定義
既存の Microsoft SQL Server バックアップ デバイスの定義の変更
BackupDeviceType プロパティは、sysname SQL Server データ型の定義と一致する必要があります。
BackupDevice オブジェクトのプロパティを取得するには、固定サーバー ロール public のメンバーでもかまいません。
BackupDevice オブジェクトのプロパティを設定するには、データベースの BACKUP DATABASE 権限または BACKUP LOG 権限が必要です。または、固定データベース ロール db_owner および db_backupoperator と、固定サーバー ロール sysadmin のメンバーである必要があります。
使用例
データベースおよびトランザクション ログのバックアップと復元
スレッド セーフ
この型の public static (Visual Basic では Shared) のメンバーはすべて、スレッド セーフです。インスタンス メンバーの場合は、スレッド セーフであるとは限りません。
関連項目
参照
Microsoft.SqlServer.Management.Smo 名前空間