VSS 復元オプションの設定

復元オプションを使用すると、要求者はカスタマイズされた復元オプションをライターに伝えることができるようになります。

[復元オプション]

復元オプションの形式を標準化すると、ライターと要求者は一般的なカスタム要求を処理できます。 復元オプションは、 IVssBackupComponents::SetRestoreOptions メソッドを、 IVssBackupComponents::P reRestore メソッドを呼び出す前に、選択したバックアップ コンポーネントごとに最大 1 回呼び出すことによって、リクエスターによって設定されます。 以下で説明するように、 wszRestoreOptions パラメーターで SetRestoreOptions メソッドに渡される文字列には、複数の値を含めることができます。

フォーマット

復元オプションの形式は、1 つ以上のコンマ区切りの名前と値のペアであり、必要に応じて、名前の先頭にサブコンポーネントの名前が付加されます。 コンポーネント名とオプション名では、大文字と小文字は区別されません。 値の大文字と小文字の区別は、ライターによって決定されます。 次に例を示します。

"Child1":"Option1"="Value1","Option2"="Value2","Child2\Grandchild3":"Option3"="Value3"

この例では、"Option1" は "Child1" サブコンポーネントとその子孫にのみ適用され、"Option2" はすべてのコンポーネントとその子孫に適用され、"Option3" は "Child2\Grandchild3" サブコンポーネントとその子孫にのみ適用されます。

SetRestoreOptions メソッドは、バックアップに選択可能なコンポーネントでのみ呼び出すことができますが、子孫ノードはバックアップに対して選択できない場合があり、復元に対して選択可能な場合があります。

一般的な復元オプション

これらの一般的な復元オプションは、ライターと要求者の間の相互運用性を高めるために定義されています。

• 権限のある復元

  "権限あり" オプションは複数の "Item" 値をサポートしますが、"All" 値は 1 つだけです。

  このコンポーネント全体が権限を持っています。

  "Authoritative"="All"
  

  指定された項目のみが権限を持っています。 名前付き項目の形式は、ライターによって定義されます。 一般的な指定は、すべてのファイル "..." を示す "*" です。指定したコンポーネントのすべてのファイルとサブディレクトリを示す場合は 。

  "Authoritative"="Item:XXX"
  

• ロールフォワード

  データベースが復元された後、ライターは通常、ログをロールフォワードしてデータベースを最新の状態にします。 増分復元または差分復元の場合、リクエスターは IVssBackupComponents::SetAdditionalRestores メソッドを使用してログ処理の動作を部分的に制御します。この復元オプションを使用すると、より詳細な制御が可能になります。

  ログをロールスルーしないでください。

  "Roll Forward"="None"
  

  すべてのログをロールスルーします。

  "Roll Forward"="All"
  

  指定したポイントまでログをロールスルーします。 指定したポイントの形式は、ライターによって定義されます。

  "Roll Forward"="Partial:XXX"
  

• 新しいコンポーネント名

  ライターは、コンポーネントを新しい名前に復元できます。 たとえば、データベースを別の名前に復元して個々のアイテムを復元する場合などです。を同じ名前に復元すると、すべてのデータが表示されます。このオプションの値として、有効な論理パスとコンポーネント名をライターが受け入れることをお勧めします。 これは、多くの場合、 指示されたターゲットで使用されます。

  "New Component Name"="Logical Path\Component Name"