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

  • [アーティクル]
  • 適用対象:
    ✅ Windows 11, ✅ Windows 10

概要

ScanState ツールと LoadState ツールで移行 .xml ファイルのいずれかを使用するには、 オプションを使用してコマンド ラインでこれらのファイルを/i指定します。 ScanState ツールと LoadState ツールは、移行を制御するために .xml ファイルを必要とするため、コマンドと LoadState.exe コマンドの両方に同じ .xml ファイルのセットをScanState.exe指定します。 ただし、 Config.xml ストアから移行されたファイルと設定の一部を除外する必要がない限り、オプションを持つ /config ファイルを指定する必要はありません。 たとえば、 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 ファイル。 アプリケーション設定を移行するには、 コマンドと LoadState.exe コマンドのScanState.exe両方でこのファイルを指定します。

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

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

注

ファイルと MigDocs.xml ファイルを一緒にMigUser.xml使用しないでください。 詳細については、「 ファイルの種類、ファイル、フォルダーを識別する 」および 「USMT のベスト プラクティス 」を参照してください。

カスタム .xml ファイル

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

Config.xml ファイル

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

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

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

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

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

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

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

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

注

ファイルから Config.xml コンポーネントを除外するには、 移行 値を "いいえ" に設定します。 コンポーネントの XML タグをファイルから Config.xml 削除しても、そのコンポーネントは移行から除外されません。

例

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

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

  • 次のコマンドは、ファイルと既定の移行.xmlファイルを Config.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"

追加情報