BETest ツール

[アーティクル]
06/13/2023

BETest は、高度なバックアップ操作と復元操作をテストする VSS リクエスターです。このツールを使用すると、次のような複雑な VSS 機能のアプリケーションの使用をテストできます。

増分バックアップと差分バックアップ
権限のある復元などの複雑な復元オプション
ロールフォワードオプション

Note

BETest は、Windows Vista 以降の Microsoft Windows ソフトウェア開発キット (SDK) に含まれています。 VSS 7.2 SDK には、Windows Server 2003 でのみ実行される BETest のバージョンが含まれています。このトピックでは、VSS 7.2 SDK に含まれる Windows Server 2003 バージョンではなく、BETest の Windows SDK バージョンについて説明します。 Windows SDK と VSS 7.2 SDK のダウンロードの詳細については、「ボリュームシャドウコピーサービス」を参照してください。

Windows SDK のインストールでは、BETest ツールは %Program Files(x86)%\Windows Kits\8.1\bin\x64 (64 ビット Windows の場合) と %Program Files(x86)%\Windows Kits\8.1\bin\x86 (32 ビット Windows の場合) にあります。

BETest ツールの実行

コマンドラインから BETest ツールを実行するには、次の構文を使用します。

BETestコマンドラインオプション

次の使用例は、 VSS ライターである VSS テストライターツールと共に BETest ツールを使用する方法を示しています。

BETest ツールの使用例

C:\BETest という名前のテストディレクトリを作成します。次のファイルをこのディレクトリにコピーします。
- betest.exe
- vswriter.exe
- BetestSample.xml
- VswriterSample.xml
C:\TestPath という名前のディレクトリを作成します。このディレクトリにテストデータファイルを配置します。
C:\BackupDestination という名前のディレクトリを作成します。このディレクトリは空のままにします。
2 つの管理者特権コマンドウィンドウを開き、それぞれの作業ディレクトリを C:\BETest に設定します。
最初のコマンドウィンドウで、次のように VSS テストライターツールを起動します。

vswriter.exe VswriterSample.xml

vswriterSample.xml ファイルは、バックアップ操作に備えて c:\TestPath ディレクトリの内容を報告するように VSS テストライターツール (vswriter) を構成します。 VSS テストライターツールは、BETest などの要求元からのアクティビティを検出するまで出力を生成しないことに注意してください。 VSS テストライターツールを停止するには、Ctrl + C キーを押します。
2 番目のコマンドウィンドウで、BETest ツールを使用して、次のようにバックアップ操作を実行します。

betest.exe /B /S backup.xml /D C:\BackupDestination /X BetestSample.xml

BETest は、C:\TestPath ディレクトリから C:\BackupDestination ディレクトリにファイルをバックアップします。バックアップコンポーネントドキュメントがC:\BETest\backup.xmlに保存されます。
バックアップ操作が成功した場合は、C:\TestPath ディレクトリの内容を削除し、BETest ツールを使用して次のように復元操作を実行します。

betest.exe /R /S backup.xml /D C:\BackupDestination /X BetestSample.xml

BETest ツールのCommand-Lineオプション

BETest ツールは、次のコマンドラインオプションを使用して、実行する作業を識別します。

/認証

Active Directory または Active Directory アプリケーションモードの権限のある復元操作を実行します。

Windows Server 2003: このコマンドラインオプションはサポートされていません。

/B

バックアップ操作を実行しますが、復元は実行しません。

/紀元前

バックアップの完了操作のみを実行します。

Windows Server 2003: このコマンドラインオプションはサポートされていません。

/Cファイル名

Note

このコマンドラインオプションは、下位互換性のためにのみ提供されます。代わりに 、/X コマンドラインオプションを使用する必要があります。

Filename で指定された構成ファイルの内容に基づいて、バックアップまたは復元するコンポーネントを選択 します。このファイルには、0 ~ 127 の範囲の ANSI 文字のみを含める必要があり、1 MB 以下にする必要があります。ファイル内の各行では、次の形式を使用する必要があります。

WriterId : ComponentName;

ここで 、WriterId はライター ID、 ComponentName はライターのコンポーネントの 1 つの名前です。ライター ID とコンポーネント名は引用符で囲む必要があり、コロン (:)の前後にはスペースが必要です。複数のコンポーネントを指定する場合は、コンマで区切る必要があります。たとえば次のような点です。

"5affb034-969f-4919-8875-88f830d0ef89" : "TestFiles1", "TestFiles2", "TestFiles3";

/Dパス

バックアップされたファイルを Path で指定されたバックアップディレクトリに保存するか、バックアップディレクトリから復元 します。

/Nbc

バックアップの完了操作を省略します。

Windows Server 2003: このコマンドラインオプションはサポートされていません。

/O

バックアップに起動可能なシステム状態が含まれていることを指定します。

/P

永続的なシャドウコピーを作成します。

Windows Server 2003: このコマンドラインオプションはサポートされていません。

/PreFilename

/T コマンドラインオプションで指定されたバックアップの種類が INCREMENTAL または DIFFERENTIAL の場合は、バックアップドキュメントを、以前の完全バックアップまたは増分バックアップ用に Filename で指定されたファイルに設定します。

Windows Server 2003 および Windows XP: このコマンドラインオプションはサポートされていません。

/R

復元を実行しますが、バックアップは実行しません。 /S コマンドラインオプションと共に使用する必要があります。

/ロールバック

アプリケーションのロールバックに使用できるシャドウコピーを作成します。

Windows Server 2003: このコマンドラインオプションはサポートされていません。

/Sファイル名

バックアップの場合は、バックアップドキュメントを Filename で指定されたファイルに保存 します。復元のみの場合は、このファイルからバックアップドキュメントを読み込みます。

/スナップショット

ボリュームシャドウコピーを作成しますが、バックアップや復元は実行しません。

Windows Server 2003: このコマンドラインオプションはサポートされていません。

/StopError

最初のライターエラーが発生すると、BETest を停止します。

Windows Server 2003: このコマンドラインオプションはサポートされていません。

/TBackupType

バックアップの種類を指定します。 BackupType には、FULL、LOG、COPY、INCREMENTAL、または DIFFERENTIAL を指定できます。バックアップの種類の詳細については、「 VSS_BACKUP_TYPE」を参照してください。

/V

トラブルシューティングに使用できる詳細出力を生成します。

Windows Server 2003: このコマンドラインオプションはサポートされていません。

/Xファイル名

Filename で指定された XML 構成ファイルの内容に基づいて、バックアップまたは復元するコンポーネントを選択 します。このファイルには、0 ~ 127 の範囲の ANSI 文字のみを含める必要があります。 XML ファイルの形式は、BETest.xml ファイル内のスキーマによって定義されます。サンプル構成ファイルについては、「BetestSample.xml」を参照してください。これらのファイルはどちらも vsstools ディレクトリにあります。

Note

BETest.xml ファイルは、インターネットエクスプローラーで表示できます。このファイルを開く前に、xdr-schema.xsl ファイルが BETest.xml と同じディレクトリにあることを確認してください。 xdr-schema.xsl ファイルには、BETest.xml ファイルをより読みやすくするためのレンダリング命令が含まれています。

Windows Server 2003: このコマンドラインオプションはサポートされていません。

サンプル XML 構成ファイル: BetestSample.xml

次のサンプル構成ファイルBetestSample.xmlは、Vsstools ディレクトリにあります。

<BETest>
    <Writer writerid="5affb034-969f-4919-8875-88f830d0ef89">
        <Component componentName="TestFiles">
        </Component>
    </Writer>
</BETest>

この単純な構成ファイルの例では、バックアップまたは復元するコンポーネントを 1 つ選択します。

サンプル XML 構成ファイル: VswriterSample.xml

次のサンプル構成ファイルVswriterSample.xmlは、Vsstools ディレクトリにあります。

<TestWriter   usage="USER_DATA"
                    deleteFiles="no">

    <RestoreMethod method="RESTORE_IF_CAN_BE_REPLACED" 
                   writerRestore="always"
                   rebootRequired="no" />
    
    <Component componentType="filegroup" 
               componentName="TestFiles">
               <ComponentFile path="c:\TestPath" filespec="*" recursive="no" />
    </Component>

</TestWriter>

この構成ファイルのルート要素の名前は TestWriter です。その他のすべての要素は、TestWriter 要素の下に配置されます。

TestWriter に関連付けられている最初の属性は usage 属性です。この属性は、 IVssExamineWriterMetadata::GetIdentity メソッドによって報告される使用の種類を指定します。この属性に使用できる値の 1 つは、USER_DATAです。

2 番目の属性は deleteFiles 属性です。この属性については、「ライター属性の構成」を参照してください。

ルート要素の最初の子要素は RestoreMethod 要素です。この要素は、次を指定します。

restore メソッド (この場合はRESTORE_IF_CAN_BE_REPLACED)
ライターが復元イベントを必要とするかどうか (この場合は常に)
ライターの復元後に再起動が必要かどうか (この場合はいいえ)

この要素は、必要に応じて代替場所マッピングを指定できます。 (この場合、別の場所は指定されません。詳細については、「代替ロケーションマッピングの指定」を参照してください。

2 番目の子要素は Component 要素です。この要素により、ライターはメタデータにコンポーネントを追加します。 Component 要素には、コンポーネントを記述する属性と、コンポーネントの内容を記述する子要素が含まれます。次に例を示します。

componentType: これがファイルグループかデータベースかを示します (この場合はファイルグループ)
コンポーネント論理パスの logicalPath (この場合は指定なし)
コンポーネントの名前の componentName (この場合は "TestFiles")
selectable-for-backup 状態を示す selectable

Component 要素には、このコンポーネントにファイル仕様を追加するための ComponentFile という名前の子要素もあります。 (Component 要素には、コンポーネントごとに指定できる任意の数の ComponentFile 要素を含めることができます)。この ComponentFile 要素には、次の属性があります。

path="c:\TestPath"
filespec="*"
recursive="no"

次の方法で共有

BETest ツール

BETest ツールの実行

BETest ツールのCommand-Lineオプション

サンプル XML 構成ファイル: BetestSample.xml

サンプル XML 構成ファイル: VswriterSample.xml

フィードバック

フィードバック

その他のリソース