リターン コード

  • [アーティクル]

このトピックでは、ユーザー状態移行ツール (USMT) 5.0 のリターン コードとエラー メッセージについて説明します。また、USMT のリターン コードとそれに関連した軽減手順とを一覧にした表を掲載しています。加えて、エラーが発生した理由をログファイルを使って特定するためのヒントも紹介しています。

USMT を使った移行作業で発生するエラーは、USMT を実行するための要件をきちんと理解すれば最小限に抑えることができます。詳しくは、「USMT の要件」をご覧ください。

このトピックの内容

USMT のリターン コード

USMT のエラー メッセージ

リターン コードとエラー メッセージのトラブルシューティング

USMT のリターン コード

USMT を使った移行作業でエラーが発生した場合、リターン コードと、それに対応する USMT エラー メッセージに記されているより具体的な情報とを手掛かりにして、問題をトラブルシューティングし、軽減手順を把握することができます。

リターン コードには、報告されるエラーの領域を表すカテゴリがあります。リターン コードは、大きく次のカテゴリに分けられます。

  • 成功またはユーザーによる取り消し

  • 無効なコマンド ライン

  • セットアップと初期化

  • 致命的ではないエラー

  • 致命的なエラー

通常、詳細レベルは 5 に設定することをお勧めします。ScanState、LoadState、UsmtUtils の各コマンド ラインに /v*:5* を設定すると、対応する USMT ログに、最も詳しいレポートが出力されます。ログ ファイルをデバッガーに出力する場合は、もっと高い詳細レベルを使うことができます。

USMT のエラー メッセージ

エラー メッセージには、移行の問題について、対応するリターン コードよりも詳しい情報が含まれています。たとえば、ScanState、LoadState、UsmtUtils のいずれかのツールから、"11" ("USMT_INVALID_PARAMETERS") というリターン コードが返されたとき、対応するエラー メッセージとして "/key and /keyfile both specified" が出力されます。エラー メッセージは、コマンド プロンプトに表示されるほか、ScanState、LoadState、UsmtUtils の各ログ ファイルでも確認でき、リターン コードの発生理由を特定する手掛かりとして利用できます。

Windows アプリケーション プログラミング インターフェイス (API) のシステム エラー コードが出力されている場合、コマンド ラインに**「net helpmsg」**と入力してそのエラー コード番号を入力すると、詳しい情報を得ることができます。システム エラー コードについて詳しくは、こちらの Microsoft Web サイトをご覧ください。

リターン コードとエラー メッセージのトラブルシューティング

次の表は、リターン コードを数値ごとに列挙したものです。対応するエラー メッセージと推奨されるトラブルシューティング方法も記載されています。

リターン コードの値 リターン コード エラー メッセージ トラブルシューティング、軽減、回避策 カテゴリ

0

USMT_SUCCESS

Successful run

該当なし

成功または取り消し

1

USMT_DISPLAY_HELP

Command line help requested

該当なし

成功または取り消し

2

USMT_STATUS_CANCELED

Gather was aborted because of an EFS file

該当なし

User chose to cancel (such as pressing CTRL+C)

該当なし

成功または取り消し

3

USMT_WOULD_HAVE_FAILED

At least one error was skipped as a result of /c

ScanState、LoadState、UsmtUtils のいずれかのログでコマンド ライン エラーに関する詳しい情報を確認してください。

11

USMT_INVALID_PARAMETERS

/all conflicts with /ui, /ue or /uel

ScanState または LoadState のログでコマンド ライン エラーに関する詳しい情報を確認してください。

/auto expects an optional parameter for the script folder

ScanState または LoadState のログでコマンド ライン エラーに関する詳しい情報を確認してください。

/encrypt can't be used with /nocompress

ScanState または LoadState のログでコマンド ライン エラーに関する詳しい情報を確認してください。

/encrypt requires /key or /keyfile

ScanState または LoadState のログでコマンド ライン エラーに関する詳しい情報を確認してください。

/genconfig can't be used with most other options

ScanState または LoadState のログでコマンド ライン エラーに関する詳しい情報を確認してください。

/genmigxml can't be used with most other options

ScanState または LoadState のログでコマンド ライン エラーに関する詳しい情報を確認してください。

/hardlink requires /nocompress

ScanState または LoadState のログでコマンド ライン エラーに関する詳しい情報を確認してください。

/key and /keyfile both specified

ScanState または LoadState のログでコマンド ライン エラーに関する詳しい情報を確認してください。

/key or /keyfile used without enabling encryption

ScanState または LoadState のログでコマンド ライン エラーに関する詳しい情報を確認してください。

/lae is only used with /lac

ScanState または LoadState のログでコマンド ライン エラーに関する詳しい情報を確認してください。

/listfiles cannot be used with /p

ScanState または LoadState のログでコマンド ライン エラーに関する詳しい情報を確認してください。

/offline requires a valid path to an XML file describing offline paths

ScanState または LoadState のログでコマンド ライン エラーに関する詳しい情報を確認してください。

/offlinewindir requires a valid path to offline windows folder

ScanState または LoadState のログでコマンド ライン エラーに関する詳しい情報を確認してください。

/offlinewinold requires a valid path to offline windows folder

ScanState または LoadState のログでコマンド ライン エラーに関する詳しい情報を確認してください。

A command was already specified

コマンド ライン構文が正しいことと、重複するコマンドが存在しないことを確認してください。

An option argument is missing

ScanState または LoadState のログでコマンド ライン エラーに関する詳しい情報を確認してください。

An option is specified more than once and is ambiguous

ScanState または LoadState のログでコマンド ライン エラーに関する詳しい情報を確認してください。

By default /auto selects all users and uses the highest log verbosity level.Switches like /all, /ui, /ue, /v are not allowed.

ScanState または LoadState のログでコマンド ライン エラーに関する詳しい情報を確認してください。

Command line arguments are required.Specify /?for options.

ScanState または LoadState のログでコマンド ライン エラーに関する詳しい情報を確認してください。

Command line option is not valid

ScanState または LoadState のログでコマンド ライン エラーに関する詳しい情報を確認してください。

EFS parameter specified is not valid for /efs

ScanState または LoadState のログでコマンド ライン エラーに関する詳しい情報を確認してください。

File argument is invalid for /genconfig

ScanState または LoadState のログでコマンド ライン エラーに関する詳しい情報を確認してください。

File argument is invalid for /genmigxml

ScanState または LoadState のログでコマンド ライン エラーに関する詳しい情報を確認してください。

Invalid space estimate path.Check the parameters and/or file system permissions

ScanState または LoadState のログでコマンド ライン エラーに関する詳しい情報を確認してください。

List file path argument is invalid for /listfiles

ScanState または LoadState のログでコマンド ライン エラーに関する詳しい情報を確認してください。

Retry argument must be an integer

ScanState または LoadState のログでコマンド ライン エラーに関する詳しい情報を確認してください。

Settings store argument specified is invalid

ScanState または LoadState のログでコマンド ライン エラーに関する詳しい情報を確認してください。ストアのパスがアクセス可能であり、適切なアクセス許可レベルが設定されていることを確認してください。

Specified encryption algorithm is not supported

ScanState または LoadState のログでコマンド ライン エラーに関する詳しい情報を確認してください。

The /efs:hardlink requires /hardlink

ScanState または LoadState のログでコマンド ライン エラーに関する詳しい情報を確認してください。

The /targetWindows7 option is only available for Windows XP, Windows Vista(R), and Windows 7

ScanState または LoadState のログでコマンド ライン エラーに関する詳しい情報を確認してください。

The store parameter is required but not specified

ScanState または LoadState のログでコマンド ライン エラーに関する詳しい情報を確認してください。

The source-to-target domain mapping is invalid for /md

ScanState または LoadState のログでコマンド ライン エラーに関する詳しい情報を確認してください。

The source-to-target user account mapping is invalid for /mu

ScanState または LoadState のログでコマンド ライン エラーに関する詳しい情報を確認してください。

Undefined or incomplete command line option

ScanState または LoadState のログでコマンド ライン エラーに関する詳しい情報を確認してください。

無効なコマンド ライン

Use /nocompress, or provide an XML file path with /p"pathtoafile" to get a compressed store size estimate

ScanState または LoadState のログでコマンド ライン エラーに関する詳しい情報を確認してください。

User exclusion argument is invalid

ScanState または LoadState のログでコマンド ライン エラーに関する詳しい情報を確認してください。

Verbosity level must be specified as a sum of the desired log options: Verbose (0x01), Record Objects (0x04), Echo to debug port (0x08)

ScanState または LoadState のログでコマンド ライン エラーに関する詳しい情報を確認してください。

Volume shadow copy feature is not supported with a hardlink store

ScanState または LoadState のログでコマンド ライン エラーに関する詳しい情報を確認してください。

Wait delay argument must be an integer

ScanState または LoadState のログでコマンド ライン エラーに関する詳しい情報を確認してください。

12

USMT_ERROR_OPTION_PARAM_TOO_LARGE

Command line arguments cannot exceed 256 characters

ScanState または LoadState のログでコマンド ライン エラーに関する詳しい情報を確認してください。

無効なコマンド ライン

Specified settings store path exceeds the maximum allowed length of 256 characters

ScanState または LoadState のログでコマンド ライン エラーに関する詳しい情報を確認してください。

13

USMT_INIT_LOGFILE_FAILED

Log path argument is invalid for /l

ScanState のコマンド ラインで /l を指定した場合、USMT によってパスが検証されます。ドライブやその他の情報 (ファイル システムの文字など) が正しいことを確認してください。

無効なコマンド ライン

14

USMT_ERROR_USE_LAC

Unable to create a local account because /lac was not specified

ローカル アカウントを作成するときは、コマンド ライン オプション /lac と /lae を使う必要があります。

無効なコマンド ライン

26

USMT_INIT_ERROR

Multiple Windows installations found

Listfiles.txt を作成できませんでした。このファイルの作成先として指定した場所が正しいことを確認してください。

セットアップと初期化

Software malfunction or unknown exception

読み込まれているすべての .xml ファイルをチェックして誤り (Config.xml ファイルの読み込みに /I を使うなど) がないか確認します。

Unable to find a valid Windows directory to proceed with requested offline operation; Check if offline input file is present and has valid entries

オフライン入力ファイルが存在し、有効なエントリが存在することを確認します。有効なオフライン オペレーティング システムを USMT は見つけることができませんでした。オフライン ディレクトリのマッピングを確認してください。

27

USMT_INVALID_STORE_LOCATION

A store path can't be used because an existing store exists; specify /o to overwrite

既に存在する中間ストア (移行ストア) を上書きするには、/o を指定します。

セットアップと初期化

A store path is missing or has incomplete data

ストアのパスがアクセス可能であり、適切なアクセス許可レベルが設定されていることを確認してください。

An error occurred during store creation

ストアのパスがアクセス可能であり、適切なアクセス許可レベルが設定されていることを確認してください。既に存在する中間ストア (移行ストア) を上書きするには、/o を指定します。

An inappropriate device such as a floppy disk was specified for the store

ストアのパスがアクセス可能であり、適切なアクセス許可レベルが設定されていることを確認してください。

ストアのパスが無効です。ストア パラメーターとファイル システムのアクセス許可を確認してください。

Invalid store path; check the store parameter and/or file system permissions

The file layout and/or file content is not recognized as a valid store

ストアのパスがアクセス可能であり、適切なアクセス許可レベルが設定されていることを確認してください。既に存在する中間ストア (移行ストア) を上書きするには、/o を指定します。

The store path holds a store incompatible with the current USMT version

ストアのパスがアクセス可能であり、適切なアクセス許可レベルが設定されていることを確認してください。

The store save location is read-only or does not support a requested storage option

ストアのパスがアクセス可能であり、適切なアクセス許可レベルが設定されていることを確認してください。

28

USMT_UNABLE_GET_SCRIPTFILES

Script file is invalid for /i

指定したすべての移行 .xml ファイルをチェックし、誤りがないかどうかを確認してください。これは、Config.xml ファイルの読み込みに /i を使ったときに多く見られるエラーです。

セットアップと初期化

Unable to find a script file specified by /i

スクリプト ファイルの場所を確認し、コマンド ライン オプションが正しいことを確認してください。

29

USMT_FAILED_MIGSTARTUP

A minimum of 250 MB of free space is required for temporary files

一時ディスク領域の最小要件である 250 MB をシステムが満たしていることを確認してください。一時ファイル用の作業ディレクトリにリダイレクトするための環境変数 USMT_WORKING_DIR=<パス> を設定して回避することもできます。

セットアップと初期化

Another process is preventing migration; only one migration tool can run at a time

ScanState のログ ファイルをチェックし、移行 .xml ファイルのエラーが発生していないか確認してください。

Failed to start main processing, look in log for system errors or check the installation

ScanState のログ ファイルをチェックし、移行 .xml ファイルのエラーが発生していないか確認してください。

Migration failed because of an XML error; look in the log for specific details

ScanState のログ ファイルをチェックし、移行 .xml ファイルのエラーが発生していないか確認してください。

Unable to automatically map the drive letters to match the online drive letter layout; Use /offline to provide a mapping table

ScanState のログ ファイルをチェックし、移行 .xml ファイルのエラーが発生していないか確認してください。

31

USMT_UNABLE_FINDMIGUNITS

An error occurred during the discover phase; the log should have more specific information

ScanState のログ ファイルをチェックし、移行 .xml ファイルのエラーが発生していないか確認してください。

セットアップと初期化

32

USMT_FAILED_SETMIGRATIONTYPE

An error occurred processing the migration system

ScanState のログ ファイルをチェックし、移行 .xml ファイルのエラーが発生していないか確認してください。または、コマンド ラインで「/?」と入力し、オンライン ヘルプをご覧ください。

セットアップと初期化

33

USMT_UNABLE_READKEY

Error accessing the file specified by the /keyfile parameter

ScanState のログ ファイルをチェックし、移行 .xml ファイルのエラーが発生していないか確認してください。または、コマンド ラインで「/?」と入力し、オンライン ヘルプをご覧ください。

セットアップと初期化

The encryption key must have at least one character

ScanState のログ ファイルをチェックし、移行 .xml ファイルのエラーが発生していないか確認してください。または、コマンド ラインで「/?」と入力し、オンライン ヘルプをご覧ください。

34

USMT_ERROR_INSUFFICIENT_RIGHTS

Directory removal requires elevated privileges

管理者としてログオンし、管理者特権で実行してください。

セットアップと初期化

No rights to create user profiles; log in as Administrator; run with elevated privileges

管理者としてログオンし、管理者特権で実行してください。

No rights to read or delete user profiles; log in as Administrator, run with elevated privileges

管理者としてログオンし、管理者特権で実行してください。

35

USMT_UNABLE_DELETE_STORE

A reboot is required to remove the store

コマンドの実行時に削除できなかったファイルがある場合は、再起動してファイルを削除してください。

セットアップと初期化

A store path can't be used because it contains data that could not be overwritten

移行ストアを削除できませんでした。ハードリンク移行ストアを使っている場合、ロックされたファイルがストアに存在する可能性があります。ストアを手動で削除するか、usmtutils /rd コマンドを使ってストアを削除する必要があります。

There was an error removing the store

ScanState または LoadState のログでコマンド ライン エラーに関する詳しい情報を確認してください。

36

USMT_ERROR_UNSUPPORTED_PLATFORM

Compliance check failure; please check the logs for details

アクティブな一時プロファイルがシステム上に存在するかどうかを調査してください。

セットアップと初期化

Use of /offline is not supported during apply

/offline コマンドが、Windows プレインストール環境 (Windows Preinstallation Environment) で実行しているときに使われませんでした。

Use /offline to run gather on this platform

/offline コマンドが、Windows PE で実行しているときに使われませんでした。

37

USMT_ERROR_NO_INVALID_KEY

The store holds encrypted data but the correct encryption key was not provided

正しい暗号化キー (/key) または暗号化キー ファイル (/keyfile) が指定されていることを確認してください。

セットアップと初期化

38

USMT_ERROR_CORRUPTED_NOTENCRYPTED_STORE

An error occurred during store access

ScanState または LoadState のログでコマンド ライン エラーに関する詳しい情報を確認してください。ストアのパスがアクセス可能であり、適切なアクセス許可レベルが設定されていることを確認してください。

セットアップと初期化

39

USMT_UNABLE_TO_READ_CONFIG_FILE

Error reading Config.xml

Config.xml ファイル内のコマンド ライン エラーに関する詳しい情報を ScanState または LoadState のログで確認してください。

セットアップと初期化

File argument is invalid for /config

Config.xml ファイルの読み込みに使ったコマンド ラインを確認してください。コマンドラインで「/?」と入力することによってオンライン ヘルプを参照できます。

40

USMT_ERROR_UNABLE_CREATE_PROGRESS_LOG

Error writing to the progress log

進行状況ログを作成できませんでした。保存場所が有効であること、また書き込みアクセス権があることを確認してください。

セットアップと初期化

Progress log argument is invalid for /progress

進行状況ログを作成できませんでした。保存場所が有効であること、また書き込みアクセス権があることを確認してください。

41

USMT_PREFLIGHT_FILE_CREATION_FAILED

Can't overwrite existing file

進行状況ログを作成できませんでした。保存場所が有効であること、また書き込みアクセス権があることを確認してください。

セットアップと初期化

Invalid space estimate path.Check the parameters and/or file system permissions

ScanState または LoadState のログでコマンド ライン エラーに関する詳しい情報を確認してください。

42

USMT_ERROR_CORRUPTED_STORE

The store contains one or more corrupted files

破損したファイルに関する詳しい情報を UsmtUtils のログで確認してください。破損していないファイルを抽出する方法について詳しくは、「圧縮された USMT 移行ストアからのファイルの抽出」をご覧ください。

61

USMT_MIGRATION_STOPPED_NONFATAL

Processing stopped due to an I/O error

USMT は終了しましたが、/c コマンド ライン オプションを指定し (必要に応じて) <ErrorControl> セクションを構成するか、/vsc コマンド ライン オプションを指定することによって続行できます。

致命的ではないエラー

71

USMT_INIT_OPERATING_ENVIRONMENT_FAILED

A Windows Win32 API error occurred

データの転送が開始されましたが、移行ストアの作成中か適用フェーズでエラーが発生しました。ScanState または LoadState のログで詳しい情報を確認してください。

致命的なエラー

An error occurred when attempting to initialize the diagnostic mechanisms such as the log

データの転送が開始されましたが、移行ストアの作成中か適用フェーズでエラーが発生しました。ScanState または LoadState のログで詳しい情報を確認してください。

Failed to record diagnostic information

データの転送が開始されましたが、移行ストアの作成中か適用フェーズでエラーが発生しました。ScanState または LoadState のログで詳しい情報を確認してください。

Unable to start.Make sure you are running USMT with elevated privileges

USMT を終了し、管理者特権でもう一度ログインしてください。

72

USMT_UNABLE_DOMIGRATION

An error occurred closing the store

データの転送が開始されましたが、移行ストアの作成中か適用フェーズでエラーが発生しました。ScanState または LoadState のログで詳しい情報を確認してください。

致命的なエラー

An error occurred in the apply process

データの転送が開始されましたが、移行ストアの作成中か適用フェーズでエラーが発生しました。ScanState または LoadState のログで詳しい情報を確認してください。

An error occurred in the gather process

データの転送が開始されましたが、移行ストアの作成中か適用フェーズでエラーが発生しました。ScanState または LoadState のログで詳しい情報を確認してください。

Out of disk space while writing the store

データの転送が開始されましたが、移行ストアの作成中か適用フェーズでエラーが発生しました。ScanState または LoadState のログで詳しい情報を確認してください。

Out of temporary disk space on the local system

データの転送が開始されましたが、移行ストアの作成中か適用フェーズでエラーが発生しました。ScanState または LoadState のログで詳しい情報を確認してください。

関連項目

他のリソース

ユーザー状態移行ツール (User State Migration Tool) のトラブルシューティング
ログ ファイル