ScanState の構文

          </div>
          <p>例:</p>
          <p>
            <code>scanstate \\server\share\migration\mystore /v:13 /i:migdocs.xml /i:migapp.xml</code>
          </p>
          <p>
            
          </p>
        </td>
      </tr>
      <tr>
        <td colspan="1">
          <p>
            <strong>/progress</strong>:[<em>パス\</em>]<em>ファイル名</em></p>
        </td>
        <td colspan="1">
          <p>オプションの進行状況ログを作成します。<em>ストアのパス</em>にログ ファイルを格納することはできません。<em>パス</em>は相対パスにすることも、完全パスにすることもできます。<em>パス</em>変数を指定しない場合、<em>ファイル名</em>が現在のディレクトリに作成されます。</p>
          <p>例:</p>
          <p>
            <code>scanstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore /progress:prog.log /l:scanlog.log</code>
          </p>
        </td>
      </tr>
      <tr>
        <td colspan="1">
          <p>
            <strong>/c</strong>
          </p>
        </td>
        <td colspan="2">
          <p> このオプションを指定すると、エラーが発生してもそれが重大なエラーでなければ <strong>ScanState</strong> コマンドは実行され続けます。エラーの原因となったファイルや設定は、進行状況ログに記録されます。たとえば、ストアに収まらない大きなファイルがある場合、<strong>ScanState</strong> コマンドはエラーをログに記録して、移行処理を続けます。さらに、ファイルが開いていたり、アプリケーションによって使われていたりした場合、USMT はファイルを移行できないことがあり、エラーをログに記録します。<strong>/c</strong> オプションを付けないと、<strong>ScanState</strong> コマンドは最初のエラーで終了します。</p>
          <p>Config.xml ファイルの新しい <strong>&lt;ErrorControl&gt;</strong> セクションを使って、ファイルやレジストリの読み取り/書き込みエラーのうち無視しても問題ないものと、移行の失敗の原因となる可能性のあるエラーを指定できます。これにより、<strong>/c</strong> コマンド ライン オプションで、環境のすべての入出力 (I/O) エラーを問題なくスキップできるようになります。さらに、<strong>/genconfig</strong> オプションを使うと、<strong>&lt;ErrorControl&gt;</strong> セクションのサンプルが生成されるようになりました。このサンプルを有効にするには、Config.xml ファイル内でエラー メッセージと目的の動作を指定します。</p>
        </td>
      </tr>
      <tr>
        <td colspan="1">
          <p>
            <strong>/r:</strong>
            <em>&lt;再試行回数&gt;</em>
          </p>
        </td>
        <td colspan="2">
          <p>
            <strong>(再試行)</strong>
          </p>
          <p>ユーザー状態をサーバーに保存しているときにエラーが発生した場合の再試行回数を指定します。既定値は 3 回です。このオプションは、ネットワーク接続の信頼性が高くない環境で役立ちます。</p>
          <p>ユーザーの状態を保存する場合、<strong>/r</strong> オプションでは、不具合やネットワーク ケーブルが接続されていないなどのネットワーク ハードウェア障害や、仮想プライベート ネットワーク (VPN) 接続の失敗のために失われたデータを回復できません。再試行オプションは、接続に問題はないものの、通信の待ち時間が問題である大規模で混雑したネットワークを対象としています。</p>
        </td>
      </tr>
      <tr>
        <td colspan="1">
          <p>
            <strong>/w:</strong>
            <em>&lt;再試行までの秒数&gt;</em>
          </p>
        </td>
        <td colspan="2">
          <p>
            <strong>(待機)</strong>
          </p>
          <p>ネットワーク ファイル操作を再試行するまでの待機時間を秒単位で指定します。既定値は 1 秒です。</p>
        </td>
      </tr>
      <tr>
        <td>
          <p>
            <strong>/p:</strong>
            <em>&lt;ファイルのパス&gt;</em>
          </p>
        </td>
        <td>
          <p>
            <strong>ScanState</strong> コマンドを実行すると、指定したパスに .xml ファイルが作成されます。この .xml ファイルには、移行ストアについての精度の高い領域の予測が含まれます。次の例に、この .xml ファイルの作成方法を示します。</p>
          <p>
            <code>Scanstate.exe C:\MigrationLocation [additional parameters]</code>
          </p>
          <p>
            <code>/p:"C:\MigrationStoreSize.xml"</code>
          </p>
          <p>詳しくは、「<a runat="server" href="hh825132(v=win.10).md">移行ストアのサイズの見積もり</a>」をご覧ください。</p>
          <p>お持ちのアプリケーションやスクリプトの機能で以前の USMT の機能を使う必要がある場合は、USMT で <em>"ファイルのパス"</em> を指定せずに <strong>/p</strong> オプションを使います。<strong>/p</strong> オプションのみを指定すると、USMT 3.x リリースと同じように、保存領域の予測が作成されます。</p>
        </td>
      </tr>
      <tr>
        <td colspan="1">
          <p>
            <strong>/?</strong> または <strong>/help</strong></p>
        </td>
        <td colspan="2">
          <p>コマンド ラインにヘルプを表示します。</p>
        </td>
      </tr>
    </table>

ユーザー オプション

既定では、すべてのユーザーが移行の対象になります。移行対象に含めるユーザーと移行対象から除外するユーザーを指定する唯一の方法は、次のオプションを使うことです。移行 .xml ファイルや Config.xml ファイルでユーザーを除外することはできまん。詳しくは、「ユーザーを識別する」と「ユーザー アカウントの移行」をご覧ください。

コマンド ライン オプション	説明
/all	コンピューター上のすべてのユーザーを移行します。 /ue オプションか /uel オプションでアカウントを個別に除外しない限り、USMT はコンピューター上のすべてのユーザー アカウントを移行します。このため、コマンド ラインでこのオプションを指定する必要はありません。ただし、/all オプションを指定した場合、/ui オプション、/ue オプション、/uel オプションを一緒に使うことはできません。
/ui: <ドメイン名>\<ユーザー名> または /ui: <コンピューター名>\<ローカル ユーザー名>	(対象にするユーザー) 指定されたユーザーを移行します。既定では、すべてのユーザーが移行の対象になります。したがって、このオプションは、/ue オプションか /uel オプションと一緒に使う場合にのみ役立ちます。複数の /ui オプションを指定することはできますが、/ui オプションを /all オプションと一緒に使うことはできません。ドメイン名とユーザー名には、アスタリスク (*) のワイルドカード文字を含めることができます。スペースを含むユーザー名を指定する場合は、引用符で囲む必要があります。 メモ /ui オプションでユーザーを対象として指定すると同時に、/ue オプションまたは /uel オプションでそのユーザーを除外した場合、そのユーザーは移行の対象になります。 例: Fabrikam ドメインの User2 のみを対象に含めるには、次のように入力します。 /ue:*\* /ui:fabrikam\user2 Fabrikam ドメインのすべてのユーザーと、過去 30 日以内にアクティブ化または変更されたその他のドメインのユーザー アカウントのみを移行する場合は、次のように入力します。 /uel:30 /ui:fabrikam\* この例では、2 か月前に最後に変更された Contoso ドメインのユーザー アカウントは移行されません。 他の例については、この表の /ue オプションと /ui オプションの説明をご覧ください。
/uel: <日数> または /uel: <YYYY/MM/DD> または /uel:0	(最後のログオンに基づいてユーザーを除外) 移行元コンピューターの Ntuser.dat ファイルの最終変更日時の日付に基づいて、指定された期間に移行元コンピューターにログオンしたユーザーを移行します。/uel オプションは、対象に含めるための規則として機能します。たとえば、/uel:30 オプションは、ScanState コマンドが実行された日から 30 日以内にログオンしたユーザーか、アカウントが変更されたユーザーを移行します。 日数を指定することも、日付を指定することもできます。このオプションを /all オプションと一緒に使うことはできません。USMT はローカル コンピューターから最後のログオン情報を取得するため、このオプションを実行するときに、コンピューターをネットワークに接続する必要はありません。さらに、ドメイン ユーザーが別のコンピューターにログオンしている場合、そのログオン インスタンスは USMT で認識されません。 メモ /uel オプションは、オフライン移行では使えません。 /uel:0 は現在ログオンしているユーザーを移行します。 /uel:90 は、過去 90 日以内にログオンしたか、アカウントが変更されたユーザーを移行します。 /uel:1 は、過去 24 時間以内にアカウントが変更されたユーザーを移行します。 /uel:2002/1/15 は、2002 年 1 月 15 日以降にログオンしたことがあるか、変更されたユーザーを移行します。 例: scanstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore /uel:0
/ue: <ドメイン名>\<ユーザー名> または /ue: <コンピューター名>\<ローカル ユーザー名>	(ユーザーを除外) 指定されたユーザーを移行対象から除外します。複数の /ue オプションを指定できます。このオプションを /all オプションと一緒に使うことはできません。<ドメイン名> と <ユーザー名> には、アスタリスク (*) のワイルドカード文字を含めることができます。スペースを含むユーザー名を指定する場合は、引用符で囲む必要があります。 例: scanstate /i:migdocs.xml /i:migapp.xml \\server\share\migration\mystore /ue:contoso\user1

/ui と /ue の使い方

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

オプションの併用

/uel オプション、/ue オプション、/ui オプションを一緒に使って、目的のユーザーだけを移行できます。

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

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

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

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

詳しくは、「EFS ファイルと EFS 証明書の移行」をご覧ください。

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

次の表に、ScanState コマンドと互換性のないコマンド ライン オプションを示します。この表で特定の組み合わせのエントリが空白の場合、それらのオプションには互換性があり、一緒に使うことができます。X 記号は、それらのオプションに互換性がないことを示します。たとえば、/nocompress オプションと /encrypt オプションを一緒に使うことはできません。

関連項目

他のリソース

XML 要素ライブラリ