ScanState 構文

ScanState.exe コマンドは、ユーザー状態移行ツール (USMT) と共に使用して、ソース コンピューターをスキャンし、ファイルと設定を収集し、ストアを作成します。 この記事では、 ScanState.exe コマンド構文と、それに使用できるオプションについて説明します。

開始する前に

ScanState.exe コマンドを実行する前に、次の項目に注意してください。

• すべてのオペレーティング システム設定が確実に移行されるようにするには、管理者資格情報を持つアカウントから管理者モードで ScanState.exe コマンドを実行します。

• 移行ストアが暗号化されている場合は、暗号化キーまたは暗号化キーを含むファイルへのパスが必要です。 この情報は移行ストアのどこにも保持されないため、キーまたはキー ファイルの場所を必ず書き留めます。 この情報は、移行ストアの暗号化を解除するために LoadState.exe コマンドを実行するとき、または回復ユーティリティを使用する必要がある場合に必要です。 キーまたはキー ファイルが正しくないか見つからない場合、エラー メッセージが表示されます。

• ScanState.exe コマンドを実行するためのソフトウェア要件については、「USMT 要件」を参照してください。

• 特に記載がない限り、コマンド ラインでツールを実行する場合は、各オプションを 1 回だけ使用します。

• ドメイン アカウントは、ソース コンピューターがドメイン コントローラーにアクセスしなくても収集できます。 この機能は、追加の構成なしで使用できます。

• [互換性のないコマンド ライン オプション] テーブルには、一緒に使用できるオプションと、互換性のないコマンド ライン オプションが一覧表示されます。

• 移行ストアが保存されているディレクトリの場所は、スキャンから除外されます。 たとえば、移行ストアが D ドライブのルートに保存されている場合、D ドライブとそのすべてのサブディレクトリはスキャンから除外されます。

構文

このセクションでは、 ScanState.exe コマンドを使用するときに使用できるコマンド ライン オプションの構文と使用方法について説明します。 オプションは任意の順序で指定できます。 オプションにパラメーターが含まれている場合は、コロンまたはスペース区切り記号を使用できます。

ScanState.exe コマンドの構文は次のとおりです。

ScanState.exe [StorePath] [/apps] [/ppkg:FileName] [/i:[Path\]FileName] [/o] [/v:VerbosityLevel] [/nocompress] [/localonly] [/encrypt /key:KeyString|/keyfile:[Path\]FileName] [/l:[Path\]FileName] [/progress:[Path\]FileName] [/r:TimesToRetry] [/w:SecondsBeforeRetry] [/c] [/p] [/all] [/ui:[DomainName|ComputerName\]UserName] [/ue:[DomainName|ComputerName\]UserName] [/uel:NumberOfDays|YYYYY/MM/DD|0] [/efs:abort|skip|decryptcopy|copyraw] [/genconfig:[Path\]FileName[/config:[Path\]FileName] [/?|help]

たとえば、現在のディレクトリに Config.xml ファイルを作成するには、次を使用します。

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

Config.xml ファイルと既定の移行.xmlファイルを使用して暗号化されたストアを作成するには、次のコマンドを使用します。

ScanState.exe \\server\share\migration\mystore /i:MigApp.xml /i:MigDocs.xml /o /config:Config.xml /v:13 /encrypt /key:"mykey"

ストレージ オプション

オフライン Windows システムで ScanState コマンドを実行する

ScanState.exe コマンドは、Windows プレインストール環境 (WinPE) で実行できます。 さらに、USMT では、 Windows.old ディレクトリに含まれる Windows の以前のインストールからの移行がサポートされています。 オフライン ディレクトリは、ScanState.exe コマンドを WinPE で実行する場合は Windows ディレクトリ、ScanState.exe コマンドを Windows で実行する場合は Windows.old ディレクトリにすることができます。

オフライン Windows イメージで ScanState.exe コマンドを実行するには、次のようないくつかの利点があります。

• パフォーマンスの向上。

  WinPE はシン オペレーティング システムであるため、実行中のサービスが少なくなります。 この環境では、 ScanState.exe コマンドのローカル ハードウェア リソースへのアクセスが増え、 ScanState が移行操作をより迅速に実行できるようになります。

• エンド ツー エンドのデプロイ プロセスを簡略化しました。

  Windows.old からデータを移行すると、新しいオペレーティング システムのインストール後に移行プロセスを実行できるため、エンド ツー エンドの展開プロセスが簡略化されます。

• 移行の成功を改善しました。

  移行の成功率は、次の理由で増加します。

  • オフライン時に編集のためにファイルがロックされません。
  • WinPE を使用すると、オフラインの Windows ファイル システム内のファイルに管理者がアクセスできるため、オンライン システムに管理者レベルでアクセスする必要がなくなります。

• 起動しないコンピューターから を回復する機能。

  起動しないコンピューターからデータを回復して移行できる場合があります。

オフライン移行オプション

移行規則のオプション

USMT には、移行するファイルを指定するための次のオプションが用意されています。

監視オプション

USMT には、移行中に発生した問題を分析するために使用できるいくつかのオプションが用意されています。

ユーザー オプション

既定では、すべてのユーザーが移行されます。 含めるユーザーと除外するユーザーを指定する唯一の方法は、次のオプションを使用することです。 移行.xmlファイルまたはConfig.xml ファイルを使用して、ユーザーを除外することはできません。 詳細については、「 ユーザーの識別 」と「 ユーザー アカウントの移行」を参照してください。

/ui と /ue の使用方法

次の例は、 /ui オプションと /ue オプションの両方に適用されます。 /ue オプションは、指定したユーザーを除外するのではなく、含める/ui オプションに置き換えることができます。

オプションを一緒に使用する

/uel、/ue、/uiの各オプションを一緒に使用して、移行する必要があるユーザーのみを移行できます。

/ui オプションは、/ue オプションと /uel オプションよりも優先されます。 /ui オプションに含めるユーザーを指定し、/ue または /uel オプションで除外するように指定した場合、そのユーザーは移行に含まれます。 たとえば、/ui:contoso\* /ue:contoso\user1が指定されている場合、/ue オプションよりも /ui オプションが優先されるため、User1 が移行されます。

/uel オプションは、/ue オプションよりも優先されます。 ユーザーが /uel オプションによって設定された指定された期間内にログオンした場合、そのユーザーのプロファイルは、 /ue オプションを使用して除外されている場合でも移行されます。 たとえば、 /ue:fixed\user1 /uel:14 が指定されている場合、過去 14 日以内にコンピューターにログオンした場合、User1 は移行されます。

暗号化されたファイル オプション

暗号化されたファイルを移行するには、次のオプションを使用できます。 いずれの場合も、 /efs オプションが指定されていない限り、暗号化されたファイルが見つかった場合、既定では USMT は失敗します。 暗号化されたファイルを移行するには、既定の動作を変更する必要があります。

詳細については、「 EFS ファイルと証明書を移行する」を参照してください。

互換性のないコマンド ライン オプション

次の表は、 ScanState.exe コマンドと互換性のないコマンド ライン オプションを示しています。 特定の組み合わせのテーブル エントリに ✅がある場合、オプションは互換性があり、これらを組み合わせて使用できます。 ❌記号は、オプションに互換性がないことを意味します。 たとえば、 /nocompress オプションは、 /encrypt オプションでは使用できません。

関連記事

• XML 要素ライブラリ。