UsmtUtils の構文

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

この記事では、コマンド ライン インターフェイスを使用してユーザー状態移行ツール (USMT) で使用できるユーティリティの構文について説明します。 これらのユーティリティ:

  • 移行の暗号化オプションを決定する機能を向上させます。

  • 共有ロックのために削除できないハード リンク ストアの削除に役立ちます。

  • カタログ ファイルまたは圧縮移行ストア内の他のファイルのいずれかが破損しているかどうかを確認します。

  • ファイルと設定が移行先コンピューターに移行されるときに作成された圧縮移行ストアからファイルを抽出します。

UsmtUtils.exe

次の表に、 UsmtUtils.exeのコマンド ライン オプションを示します。 以降のセクションでは、 /verify と /extract オプションに関するコマンド ライン オプションをさらに提供します。

UsmtUtils.exeの構文は次のとおりです。

UsmtUtils.exe [/ec | /rd <storeDir> | /verify <filepath> [options] | /extract <filepath><destinationPath> [options]]

コマンド ライン オプション 説明
/ec 現在のシステムでサポートされている暗号化アルゴリズム (AlgID) の一覧を返します。 このオプションは、移行先コンピューターで、ソース コンピューターで ScanState ツールを実行する前に、/encrypt コマンドで使用するアルゴリズムを決定するために使用できます。
/rd<storeDir> コンピューター上の <storeDir> 引数で指定されたディレクトリ パスを削除します。 このコマンドを使用すると、共有ロックのためにコマンド プロンプトで削除できないハード リンク移行ストアを削除できます。 移行ストアが特定のドライブ上の複数のボリュームにまたがる場合、移行ストアはこれらのすべてのボリュームから削除されます。

次に、例を示します。
UsmtUtils.exe /rd D:\MyHardLinkStore
/y /rd オプションで使用する場合は、削除を受け入れるようにプロンプトをオーバーライドします。 /y オプションが /rd オプションと共に使用されている場合、USMT がディレクトリを削除する前に、削除を受け入れるように求めるプロンプトは表示されません。
/確かめる 圧縮された移行ストアがそのままであるか、破損したファイルまたは破損したカタログが含まれているかどうかに関する情報を返します。

/verifyで使用する構文とオプションの検証オプションに関するページを参照してください。
/抜く 圧縮された USMT 移行ストアからファイルを回復します。

/extractで使用する構文とオプションについては、「抽出オプション」を参照してください。

オプションの確認

/verify オプションを使用して、圧縮された移行ストアがそのままであるか、破損したファイルまたは破損したカタログが含まれているかどうかを判断します。 /verify オプションの使用方法の詳細については、「圧縮された移行ストアの条件を確認する」を参照してください。

/verifyの構文は次のとおりです。

UsmtUtils.exe /verify[:<reportType>] <filePath> [/l:<logfile>] [/decrypt [:<AlgID>] {/key:<keystring> | /keyfile:<filename>}]

コマンド ライン オプション 説明
<reportType> すべてのファイル、破損したファイルのみ、またはカタログの状態を報告するかどうかを指定します。
  • 概要。 変更されていないファイルの数と、移行ストアで破損したファイルの数の両方を返します。 アルゴリズムが指定されていない場合、サマリー レポートは既定で表示されます。
  • all。 圧縮された移行ストア内のすべてのファイルのタブ区切りの一覧と、各ファイルの状態を返します。 各行には、ファイル名の後にタブの間隔が表示され、ファイルの状態に応じて CORRUPTED または OK が含まれます。 最後のエントリは、ストアの カタログ の破損状態を報告します。 カタログ ファイルには、移行ストア内のすべてのファイルのメタデータが含まれています。 LoadState ツールでは、移行ストアを開くために有効なカタログ ファイルが必要です。 カタログ ファイルがそのままであり、 LoadState が移行ストアを開くことができる場合は "OK" を返し、移行ストアが破損している場合は "CORRUPTED" を返します。
  • failureonly。 圧縮された移行ストアで破損しているファイルのみのタブ区切りの一覧を返します。
  • カタログ。 カタログ ファイルの状態のみを返します。
/l:
<logfilePath>		 ログ ファイルの場所と名前を指定します。
/v:<VerbosityLevel> (詳細)

UsmtUtils ログ ファイルで詳細出力を有効にします。 既定値は 0 です。

VerbosityLevel は、次のいずれかのレベルに設定できます。
  • 0 - 既定のエラーと警告のみが有効になります。
  • 1 - 詳細出力を有効にします。
  • 4 - エラーと状態の出力を有効にします。
  • 5 - 詳細出力と状態出力を有効にします。
  • 8 - デバッガーへのエラー出力を有効にします。
  • 9 - デバッガーへの詳細出力を有効にします。
  • 12 - デバッガーへのエラーと状態の出力を有効にします。
  • 13 - 詳細、状態、デバッガーの出力を有効にします。
/decrypt<AlgID>/:<KeyString>
or
/decrypt<AlgID>/:<"Key String">
or
/decrypt:<AlgID>/keyfile:<FileName>		 ScanState ツールを使用して移行ストアを作成するために、/encrypt オプションが使用されたことを指定します。 移行ストアを復号化するには、次のように /key または /keyfile オプションを指定します。
  • <AlgID>は、ScanState.exe コマンド ラインで移行ストアを作成するために使用された暗号化アルゴリズムを指定します。 アルゴリズムが指定されていない場合、 ScanState と UsmtUtils は既定で 3DES アルゴリズムを使用します。
    <AlgID> 有効な値には、 AES_128、 AES_192、 AES_256、 3DES、または 3DES_112が含まれます。
  • /key: <KeyString> 暗号化キーを指定します。 <KeyString>にスペースがある場合は、引数を引用符で囲む必要があります。
  • /keyfile: <FileName> 暗号化キーを含むテキスト (.txt) ファイルの場所と名前を指定します。

サポートされている暗号化アルゴリズムの詳細については、「 移行ストアの暗号化」を参照してください。

/verify コマンドの例を次に示します。

  • UsmtUtils.exe /verify D:\MyMigrationStore\store.mig

  • UsmtUtils.exe /verify:catalog D:\MyMigrationStore\store.mig

  • UsmtUtils.exe /verify:all D:\MyMigrationStore\store.mig /decrypt /l:D:\UsmtUtilsLog.txt

  • UsmtUtils.exe /verify:failureonly D:\MyMigrationStore\store.mig /decrypt:AES_192 /keyfile:D:\encryptionKey.txt

抽出オプション

LoadState を使用して正常に復元しない場合は、圧縮された USMT 移行ストアからファイルを回復するには、/extract オプションを使用します。 /extract オプションの使用方法の詳細については、「圧縮された USMT 移行ストアからファイルを抽出する」を参照してください。

/extractの構文は次のとおりです。

/extract <filePath><destinationPath> [/i:<includePattern>] [/e: <excludePattern>] [/l: <logfile>] [/v: VerbosityLevel>] [/decrypt[:<AlgID>] {key: <keystring> | /keyfile: <filename>}] [/o]

コマンド ライン オプション 説明
<filePath> USMT 移行ストアへのパス。

次に、例を示します。
D:\MyMigrationStore\USMT\store.mig
<destinationPath> ツールが個々のファイルを配置するフォルダーへのパス。
/i:<includePattern> 抽出に含めるファイルのパターンを指定します。 複数のパターンを指定できます。 パターンはコンマまたはセミコロンで区切ります。 /i: <includePattern> と /e: <excludePattern> オプションは、同じコマンドで使用できます。 コマンド ラインでインクルード パターンと除外パターンの両方を使用する場合は、除外パターンよりもインクルード パターンが優先されます。
/e:<excludePattern> 抽出から除外するファイルのパターンを指定します。 複数のパターンを指定できます。 パターンはコンマまたはセミコロンで区切ります。 /i: <includePattern> と /e: <excludePattern> オプションは、同じコマンドで使用できます。 コマンド ラインでインクルード パターンと除外パターンの両方を使用する場合は、除外パターンよりもインクルード パターンが優先されます。
/l:<logfilePath> ログ ファイルの場所と名前を指定します。
/v:<VerbosityLevel> (詳細)

UsmtUtils ログ ファイルで詳細出力を有効にします。 既定値は 0 です。

VerbosityLevel は、次のいずれかのレベルに設定できます。
  • 0 - 既定のエラーと警告のみが有効になります。
  • 1 - 詳細出力を有効にします。
  • 4 - エラーと状態の出力を有効にします。
  • 5 - 詳細出力と状態出力を有効にします。
  • 8 - デバッガーへのエラー出力を有効にします。
  • 9 - デバッガーへの詳細出力を有効にします。
  • 12 - デバッガーへのエラーと状態の出力を有効にします。
  • 13 - 詳細、状態、デバッガーの出力を有効にします。
/decrypt*<AlgID>/key:<KeyString>
or
/decrypt<AlgID>/:<"Key String">
or
/decrypt:<AlgID>/keyfile:<FileName>*		 ScanState ツールを使用して移行ストアを作成するために、/encrypt オプションが使用されたことを指定します。 移行ストアの暗号化を解除するには、 /key または /keyfile オプションも次のように指定する必要があります。
  • <AlgID>は、ScanState.exe コマンド ラインで移行ストアを作成するために使用された暗号化アルゴリズムを指定します。 アルゴリズムが指定されていない場合、 ScanState と UsmtUtils は既定で 3DES アルゴリズムを使用します。
    <AlgID> 有効な値には、 AES_128、 AES_192、 AES_256、 3DES、または 3DES_112が含まれます。
  • /key: <KeyString> は暗号化キーを指定します。 <KeyString>にスペースがある場合は、引数を引用符で囲む必要があります。
  • /keyfile:<FileName> 暗号化キーを含むテキスト (.txt) ファイルを指定します

サポートされている暗号化アルゴリズムの詳細については、「 移行ストアの暗号化」を参照してください。
/o 既存の出力ファイルを上書きします。

/extract コマンドの例を次に示します。

  • UsmtUtils.exe /extract D:\MyMigrationStore\USMT\store.mig C:\ExtractedStore

  • UsmtUtils.exe /extract D:\MyMigrationStore\USMT\store.mig /i:"*.txt, *.pdf" C:\ExtractedStore /decrypt /keyfile:D:\encryptionKey.txt

  • UsmtUtils.exe /extract D:\MyMigrationStore\USMT\store.mig /e:*.exe C:\ExtractedStore /decrypt:AES_128 /key:password /l:C:\usmtlog.txt

  • UsmtUtils.exe /extract D:\MyMigrationStore\USMT\store.mig /i:myProject.* /e:*.exe C:\ExtractedStore /o