リターンコード

[アーティクル]
04/01/2016

このトピックでは、User State Migration Tool (USMT) 10.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, 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	Windows Preinstallation Environment (WinPE) での実行中に、/offline コマンドが使われませんでした。
		Use /offline to run gather on this platform	WinPE での実行中に、/offline コマンドが使われませんでした。
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 (USMT) のトラブルシューティング

ログファイル