USMT XML ファイルをカスタマイズする

概要

ScanState ツールと LoadState ツールで移行 .xml ファイルのいずれかを使用するには、コマンド ラインで /i オプションを使用してこれらのファイルを指定します。 ScanState ツールと LoadState ツールでは、移行を制御するために .xml ファイルが必要であるため、ScanState.exe コマンドとLoadState.exe コマンドの両方に同じ.xmlファイルのセットを指定します。 ただし、/config オプションを持つConfig.xml ファイルは、ストアから移行されたファイルと設定の一部を除外する必要がない限り、指定する必要はありません。 たとえば、 Documents フォルダーをストアに移行するが、移行先のコンピューターには移行しない場合などです。 このシナリオを実現するには、 Config.xml ファイルを変更し、更新されたファイルを LoadState.exe コマンドで指定します。 LoadState.exe コマンドは、目的のファイルと設定のみを移行します。

.xml ファイルが LoadState.exe コマンドから除外されている場合、不足している .xml ファイルと共に移行されたストア内のすべてのデータが移行されます。 ただし、 ScanState.exe コマンドで指定された移行規則は適用されません。 たとえば、 .xml ファイルが取り残され、次のような再ルーティング規則が含まれている場合です。

MigsysHelperFunction.RelativeMove("c:\data", "%CSIDL_PERSONAL%")

USMT はファイルを再ルーティングせず、 C:\dataに移行されます。

移行を変更するには、次の 1 つ以上の操作を行います。

• 移行 .xml ファイルを変更します。 コンポーネントの一部を除外するには、 .xml ファイルを変更します。 たとえば、C:\ を移行するが 、.mp3 ファイルをすべて除外したり、コピー先コンピューター上の新しい場所にデータを移動したりします。 これらのファイルを変更するには、移行規則と構文に関する知識が必要です。 ScanState と LoadState でこれらのファイルを使用するには、各コマンドを入力するときにコマンド ラインで指定します。

• カスタム .xml ファイルを作成します。 カスタム .xml ファイルを作成して、別のアプリケーションの設定を移行したり、organizationのニーズに合わせて移行動作を変更したりすることもできます。 ScanState と LoadState でこのファイルを使用するには、両方のコマンド ラインで指定します。

• Config.xml ファイルを作成および変更します。 Config.xml ファイルを作成および変更して、コンポーネント全体を移行から除外します。 たとえば、 Config.xml ファイルを使用して Documents フォルダー全体を除外したり、アプリケーションの設定を除外したりできます。 Config.xml ファイルを使用してコンポーネントを除外する方が、移行 .xml ファイルを変更するよりも簡単です。これは、移行規則と構文に精通している必要がないためです。 さらに、オペレーティング システムの設定を移行から除外する唯一の方法は、 Config.xml ファイルを使用することです。

データの除外の詳細については、 ファイルと設定の除外 に関する記事を参照してください。

.xml ファイルの移行

このセクションでは、USMT に含まれる移行 .xml ファイルについて説明します。 各ファイルには、移行するコンポーネントと移行先コンピューター上のどこに移行するかを制御する移行規則が含まれています。

• MigApp.xml ファイル。 アプリケーション設定を移行するには、 ScanState.exe コマンドと LoadState.exe コマンドの両方でこのファイルを指定します。

• MigDocs.xml ファイル。 このファイルを ScanState ツールと LoadState ツールの両方で指定して、 MigXmlHelper.GenerateDocPatterns ヘルパー関数によって検出されたすべてのユーザー フォルダーとファイルを移行します。 このヘルパー関数は、任意のドライブのルートと Users ディレクトリに存在するユーザー データを検索します。 ただし、アプリケーション データ、プログラム ファイル、または Windows ディレクトリ内のファイルは検出および移行されません。 MigDocs.xml ファイルは変更できます。

• MigUser.xml ファイル。 ユーザー フォルダー、ファイル、ファイルの種類を移行するには、 ScanState.exe コマンドと LoadState.exe コマンドの両方でこのファイルを指定します。 MigUser.xml ファイルは変更できます。 このファイルには、特定のユーザー アカウントを移行するルールは含まれません。 移行するユーザー アカウントを指定する唯一の方法は、 ScanState ユーザー オプション と LoadState ユーザー オプションを使用してコマンド ラインにあります。

カスタム .xml ファイル

カスタム .xml ファイルを作成して、organization固有のニーズに合わせて移行をカスタマイズできます。 たとえば 、基幹業務 アプリケーションを移行したり、既定の移行動作を変更したりするために、カスタム.xmlファイルを作成できます。 ScanState.exeとLoadState.exeでこのファイルを使用するには、両方のコマンドで指定します。 詳細については、 カスタム XML の例に関する記事を 参照してください。

Config.xml ファイル

Config.xml ファイルは、ScanState.exe コマンドで /genconfig オプションを使用して作成される省略可能なファイルです。 このファイルは、特定のコンポーネントを移行から除外するように作成および変更する必要があります。 さらに、このファイルを作成して変更して、オペレーティング システムの設定を移行対象から除外する必要があります。 Config.xmlファイル形式は、移行規則が含まれていないため、移行.xmlファイルとは異なります。 オペレーティング システム コンポーネント、アプリケーション、および移行可能なユーザー ドキュメントの一覧のみが含まれています。 例については、 Config.xml ファイルに関 する記事を参照してください。 このため、 Config.xml ファイルを使用してコンポーネントを除外する方が、移行 .xml ファイルを変更するよりも簡単です。 Config.xmlでは、移行規則と構文に関する知識はありません。 ただし、 Config.xml ファイルではワイルドカード文字を使用できません。

既定のすべてのコンポーネントを含めるために、 Config.xml ファイルを作成する必要はありません。 または、 MigApp.xml、 MigDocs.xml、 MigUser.xml ファイルで定義されている既定の移行動作が十分であり、一部のコンポーネントのみを除外する必要がある場合は、 Config.xml ファイルを作成できます。 他 の.xml ファイルは元の状態のままでかまいません。

ScanState.exe コマンドを /genconfig オプションで実行すると、/i オプションを使用して指定された他の .xml ファイルを読み取り、コンピューターから移行できるコンポーネントのカスタム リストを作成ScanState.exe。 このファイルには、.xmlファイルの両方にあり、/genconfig オプションを使用して ScanState.exe コマンドを実行するときにコンピューターにインストールされるオペレーティング システム コンポーネント、アプリケーション、およびユーザー ドキュメント セクションのみが含まれます。 したがって、このファイルは、対象のコンピューターに存在するすべてのコンポーネント、アプリケーション、および設定を含むソース コンピューター上に作成する必要があります。 ソース コンピューターでファイルを作成すると、このファイルに移行できるすべてのコンポーネントが確実に含まれます。 コンポーネントは、 <Applications>、 <WindowsComponents>、 <Documents> の各セクションに編成されています。 コンポーネントを移行しないことを選択するには、そのエントリを migrate="no" に変更します。

このファイルを作成した後は、移行に影響を与える/Config オプションを使用して、ScanState.exe コマンドでのみ指定する必要があります。 ただし、ストアに移行された追加のデータを除外する必要がある場合は、 Config.xml ファイルを変更し、更新されたファイルを LoadState.exe コマンドで指定します。 たとえば、Documents フォルダーがストアに収集されていても、Documents フォルダーを移行先のコンピューターに移行する必要がない場合、LoadState.exe コマンドを実行する前にmigrate="no"を示すようにConfig.xml ファイルを変更できます。また、ファイルは移行されません。 データを除外するときに行われる優先順位の詳細については、 ファイルと設定の除外 に関する記事を参照してください。

さらに、 Config.xml ファイルでは次の機能に注意してください。

• migrate="no"を指定してConfig.xml ファイル内の移行から親コンポーネントが削除された場合、子コンポーネントがmigrate="yes"に設定されている場合でも、その子コンポーネントはすべて自動的に移行から削除されます。

• 同じコンポーネントに対して誤って 2 行のコードが存在し、一方の行で migrate="no" が指定され、もう一方の行で migrate="yes"が指定されている場合、コンポーネントは移行されます。

• USMT には、 Config.xml ファイルで構成できる移行ポリシーがいくつかあります。 たとえば、追加の<ErrorControl>、<ProfileControl>、および <HardLinkStoreControl> オプションを構成できます。 詳細については、 Config.xml ファイルに関する記事を 参照してください。

例

• 次のコマンドは、現在のディレクトリに Config.xml ファイルを作成しますが、ストアは作成されません。

  ScanState.exe /i:MigApp.xml /i:MigDocs.xml /genconfig:Config.xml /v:5

• 次のコマンドは、 Config.xml ファイルと既定の移行.xmlファイルを使用して、暗号化されたストア を 作成します。

  ScanState.exe \\server\share\migration\mystore /i:MigApp.xml /i:MigDocs.xml /o /config:Config.xml /v:5 /encrypt /key:"mykey"

• 次のコマンドは、ストアの暗号化を解除し、ファイルと設定を移行します。

  LoadState.exe \\server\share\migration\mystore /i:MigApp.xml /i:MigDocs.xml /v:5 /decrypt /key:"mykey"

追加情報

• 移行されるファイルと設定を変更する方法の詳細については、 ユーザー状態移行ツール (USMT) のハウツーに関する記事を参照してください。
• 各 .xml 要素の詳細については、 XML 要素ライブラリ に関する記事を参照してください。
• 一般的な質問に対する回答については、 よく寄せられる質問 に関する記事の「.xml ファイル」を参照してください。

関連記事

• ユーザー状態移行ツール (USMT) コマンド ライン構文。
• USMT リソース。