Share via

UsmtUtils の構文

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

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

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

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

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

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

UsmtUtils.exe

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

の構文 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>] [/v:VerbosityLevel] [/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使用して移行ストアを作成するためにオプションが使用されたことを指定します。 移行ストアの暗号化を解除するには、次のように または /keyfile オプションを/key指定します。
  • <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 を/extract使用して正常に復元しない場合は、 オプションを使用して圧縮された USMT 移行ストアからファイルを回復します。 オプションの使用方法 /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
/復 号 化<AlgID>/:<"Key String">
or
/復 号 化：<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