競合と優先度

ファイルと設定を対象に含めたり、対象から除外したり、その経路を変更したりする場合には、ユーザー状態移行ツール (USMT) 5.0 で競合と優先度がどのように扱われるかを知っておくことが重要です。USMT を操作する際の、競合と優先度に関する最も重要なガイドラインを以下に示します。

• **コンポーネント内で規則が競合している場合は、最も限定的な規則が適用されます。**ただし <unconditionalExclude> 規則は例外で、それ以外の規則よりも優先されます。 ディレクトリ名は、ファイルの拡張子よりも優先されます。例については、後の「<include> 規則と <exclude> 規則が競合したときの動作」と「<include> 規則と <exclude> 規則の優先度の例」の最初の例をご覧ください。

• **同じコンポーネントに含まれる規則のみが、限定性に応じて相互に影響します。**異なるコンポーネントに含まれる規則は、<unconditionalExclude> 規則を除いて、相互に影響しません。

• **規則の限定性が等しいときは <exclude> が <include> よりも優先されます。**たとえば、<exclude> 規則を使って特定のファイルを除外し、<include> 規則を使ってそのファイルを対象に含めた場合、そのファイルは除外されます。

• **コンポーネントの順序は考慮されません。**各コンポーネントはすべての .xml ファイルを通じて他のコンポーネントとは関係なく処理されるため、どの .xml ファイルにどのコンポーネントが含まれているかは関係ありません。

• コンポーネント内の <include> 規則と <exclude> 規則の順序は考慮されません。

• **グローバルにデータを除外するには、<unconditionalExclude> 要素を使います。**この要素は、.xml ファイルに含まれている他の <include> 規則に関係なく、オブジェクトを除外します。たとえば、<unconditionalExclude> 要素を使って、コンピューター上の MP3 ファイルをすべて除外したり、C:\UserData のファイルをすべて除外したりできます。

このトピックの内容

全般

• 異なるコンポーネントに含まれる規則の関係性

• Config.xml ファイルでの優先度の扱い

• .xml ファイルに複数のコンポーネントが含まれる場合の USMT の処理

• 規則の処理方法

• コマンド ラインで指定した全 .xml ファイルが USMT で結合される方法

<include> 規則と <exclude> 規則

• <include> 規則と <exclude> 規則が競合したときの動作

• <include> 規則と <exclude> 規則の優先度の例

ファイルの競合

• ファイルが競合したときの既定の動作

• ファイルが競合したときの <merge> 規則の動作

全般

異なるコンポーネントに含まれる規則の関係性

同じコンポーネントに含まれる規則のみが、限定性に応じて相互に影響します (<unconditionalExclude> 規則を除く)。異なるコンポーネントの規則は、相互に影響しません。あるコンポーネントに <include> 規則が含まれており、別のコンポーネントに同じ <exclude> 規則が含まれている場合、2 つの規則は独立しているため、データは移行されます。

あるコンポーネントに <include> 規則があり、同じファイルの別のコンポーネントに <locationModify> 規則がある場合、ファイルは両方の場所で移行されます。つまり、<include> 規則に基づいてファイルが対象に含められ、<locationModify> 規則に基づいて移行されます。

次の .xml ファイルでは、<exclude> 規則が別のコンポーネントで指定されているため、.mp3 ファイルを含め、C:\Userdocs からすべてのファイルが移行されます。

<migration urlid="https://www.microsoft.com/migration/1.0/migxmlext/UserDocs">
<component type="Documents" context="System">
<displayName>User Documents</displayName>
        <role role="Data">
            <rules>
                <exclude>
                    <objectSet>
                        <pattern type="File">C:\Userdocs\* [*.mp3]</pattern>
                    </objectSet>
                </exclude>
          </rules>
        </role>
</component>

<component type="Documents" context="System">
<displayName> User documents to include </displayName>
        <role role="Data">
            <rules>
                <include>
                    <objectSet>
                        <pattern type="File"> C:\Userdocs\ [*]</pattern>
                    </objectSet>
                </include>
          </rules>
        </role>
</component>
</migration>

Config.xml ファイルでの優先度の扱い

Config.xml ファイルで migrate="no" を指定することは、移行 .xml ファイルから対応するコンポーネントを削除するのと同じことです。ただし、マイ ドキュメントに migrate="no" を設定しても、移行 .xml ファイルに以下のような規則 (マイ ドキュメントのすべての .doc ファイルを含める) が含まれている場合、.doc ファイルのみが移行され、その他のファイルはすべて除外されます。

<include>
   <objectSet>
      <pattern type="File">%CSIDL_PERSONAL%\* [*.doc] </pattern>
   </objectSet>
</include> 

.xml ファイルに複数のコンポーネントが含まれる場合の USMT の処理

コンポーネントの順序は考慮されません。各コンポーネントは他のコンポーネントとは関係なく処理されます。たとえば、あるコンポーネントに <include> 規則があり、同じファイルの別のコンポーネントに <locationModify> 規則がある場合、ファイルは両方の場所で移行されます。つまり、<include> 規則に基づいてファイルが対象に含められ、<locationModify> 規則に基づいて移行されます。

規則の処理方法

規則には、大きく分けて 2 つのカテゴリがあります。

• ScanState ツールと LoadState ツールの両方の動作に影響を及ぼす規則。たとえば、<include> 規則、<exclude> 規則、<unconditionalExclude> 規則は、.xml ファイル内の各コンポーネントに対して処理されます。USMT によって、コンポーネントごとに対象の一覧と除外の一覧が作成されます。コンポーネントの規則の中には、限定性のために破棄されるものもありますが、それ以外の規則はすべて処理されます。USMT は、いずれかの場所を除外する必要があるかどうかを調べるために、各 <include> 規則に対して要素を繰り返し処理します。USMT は、すべてのオブジェクトを列挙し、ユーザーごとに収集するオブジェクトの一覧を作成します。一覧が完成すると、各オブジェクトは、移行先コンピューターに格納または移行されます。

• LoadState ツールの動作にのみ影響を及ぼす規則。たとえば、<locationModify> 規則、<contentModify> 規則、<destinationCleanup> 規則は ScanState に影響しません。これらは LoadState でのみ処理されます。まず、LoadState ツールは <locationModify> 規則と <contentModify> 規則に基づいて、各コンポーネントの内容と場所を判断します。次に、すべての <destinationCleanup> 規則を処理し、移行先コンピューターからデータを削除します。最後に、コンポーネントをコンピューターに適用します。

コマンド ラインで指定した全 .xml ファイルが USMT で結合される方法

USMT は名前や内容を基に .xml ファイルを区別しません。ファイル内の各コンポーネントは別々に処理されます。USMT では、ファイル内のコンポーネントの管理と構成を容易にするために、複数の .xml ファイルがサポートされています。USMT は移行 urlid を使って各コンポーネントを区別するため、コマンド ラインで指定した各 .xml ファイルに一意の移行 urlid があることを確かめてください。

<include> 規則と <exclude> 規則

<include> 規則と <exclude> 規則が競合したときの動作

コンポーネント内で規則が競合している場合は、最も限定的な規則が適用されます。ただし <unconditionalExclude> 規則は例外で、それ以外の規則よりも優先されます。規則の限定性が等しいとき、データは移行されません。たとえば、あるファイルを対象から除外すると同時に、対象に含めている場合、ファイルは移行されません。異なるコンポーネントに含まれる規則が競合している場合、規則は相互に影響しません。各コンポーネントは独立して処理されるためです。

次の例では、.mp3 ファイルは移行から除外されません。これは、ディレクトリ名がファイルの拡張子よりも優先されるためです。

<include>
     <objectSet>
          <pattern type="File">C:\Data\* [*]</pattern>
     </objectSet>
</include>
<exclude>
     <objectSet>
          <pattern type="File"> C:\* [*.mp3]</pattern>
     </objectSet>
</exclude>  

<include> 規則と <exclude> 規則の優先度の例

以下の例では、USMT が <include> 規則と <exclude> 規則をどのように扱うかを説明します。規則が異なるコンポーネントに含まれている場合は、コンポーネントが同じ移行 .xml ファイルにあるか異なる移行 .xml ファイルにあるかに関係なく、その結果の動作は同じになります。

• ファイルを含めるか、除外する

• レジストリ オブジェクトを含めるか、除外する

ファイルを含めるか、除外する

レジストリ オブジェクトを含めるか、除外する

ファイルの競合

ファイルが競合したときの既定の動作

<merge> 規則がない場合、レジストリの既定の動作では、移行元の情報によって移行先の情報が上書きされます。ファイルについては、既定で移行元のファイル名が変更され、数字が付加されます。たとえば、OriginalFileName(1).OriginalExtension、OriginalFileName(2).OriginalExtension などのファイル名になります。

ファイルが競合したときの <merge> 規則の動作

競合が検出されると、USMT では最も限定的な <merge> 規則が選ばれ、競合を解決するために適用されます。たとえば、C:\* [*] を sourcePriority() に設定する <merge> 規則があり、C:\subfolder\* [*] を destinationPriority() に設定する別の <merge> 規則がある場合、USMT では、最も限定的である destinationPriority() 規則を使います。

シナリオ例

移行元コンピューターに次のファイルがあります。

• C:\Data\SampleA.txt

• C:\Data\SampleB.txt

• C:\Data\Folder\SampleB.txt

移行先コンピューターに次のファイルがあります。

• C:\Data\SampleB.txt

• C:\Data\Folder\SampleB.txt

次のコードを含むカスタム .xml ファイルがあります。

<include> 
   <objectSet> 
      <pattern type="File">c:\data\* [*]</pattern> 
   </objectSet> 
</include> 

次の表では、この例を基に、カスタム .xml ファイルの 1 列目にコードを追加する場合の結果の動作について説明します。

<merge script="MigXmlHelper.DestinationPriority()"> 
   <objectSet> 
      <pattern type="File">c:\data\* [*]</pattern> 
   </objectSet> 
</merge>

<merge script="MigXmlHelper.SourcePriority()"> 
   <objectSet> 
      <pattern type="File">c:\data\* [*]</pattern> 
   </objectSet> 
</merge> 

<merge script="MigXmlHelper.SourcePriority()"> 
   <objectSet> 
      <pattern type="File">c:\data\ [*]</pattern> 
   </objectSet> 
</merge> 

関連項目

他のリソース

USMT XML リファレンス