ScanState-Syntax

          </div>
          <p>Beispiel:</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>Path\</em>]<em>FileName</em></p>
        </td>
        <td colspan="1">
          <p>Erstellt das optionale Statusprotokoll. Sie können keine Protokolldateien in <em>StorePath</em> speichern. <em>Path</em> kann ein relativer oder vollständiger Pfad sein. Wenn Sie die <em>Path</em>-Variable nicht angeben, wird <em>FileName</em> im aktuellen Verzeichnis erstellt.</p>
          <p>Beispiel:</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> Wenn diese Option angegeben wird, wird der Befehl <strong>ScanState</strong> auch dann weiter ausgeführt, wenn nicht schwerwiegende Fehler auftreten. Alle Dateien oder Einstellungen, die einen Fehler verursachen, werden im Statusprotokoll erfasst. Falls z. B. eine große Datei vorhanden ist, für die nicht genügend Speicherplatz im Speicher verfügbar ist, protokolliert der Befehl <strong>ScanState</strong> einen Fehler, und die Migration wird fortgesetzt. Wenn eine Datei geöffnet ist oder von einer App verwendet wird, kann USMT die Datei u. U. nicht migrieren. In diesem Fall wird ebenfalls ein Fehler im Protokoll erfasst. Ohne die Option <strong>/c</strong> wird der Befehl <strong>ScanState</strong> beim ersten Fehler beendet.</p>
          <p>Im neuen <strong>&lt;ErrorControl&gt;</strong>-Abschnitt der Datei „Config.xml“ können Sie angeben, welche Lese-/Schreibfehler für Dateien oder die Registrierung sicher ignoriert werden können und bei welchen Fehlern die Migration fehlschlägt. Auf diese Weise kann die Befehlszeilenoption <strong>/c</strong> alle Eingabe-/Ausgabefehler (E/A-Fehler) in der Umgebung sicher überspringen. Außerdem generiert die Option <strong>/genconfig</strong> jetzt einen <strong>&lt;ErrorControl&gt;</strong>-Beispielabschnitt, der durch Angeben von Fehlermeldungen und des gewünschten Verhaltens in der Datei „Config.xml“ aktiviert wird.</p>
        </td>
      </tr>
      <tr>
        <td colspan="1">
          <p>
            <strong>/r:</strong>
            <em>&lt;TimesToRetry&gt;</em>
          </p>
        </td>
        <td colspan="2">
          <p>
            <strong>(Wiederholen)</strong>
          </p>
          <p>Gibt die Anzahl von Wiederholungen an, die ausgeführt wird, wenn beim Speichern des Benutzerstatus auf einem Server ein Fehler auftritt. Der Standardwert ist dreimal. Diese Option eignet sich für Umgebungen mit unzuverlässiger Netzwerkkonnektivität.</p>
          <p>Beim Speichern des Benutzerstatus kann die Option <strong>/r</strong> keine Daten wiederherstellen, die aufgrund eines Netzwerkhardwarefehlers (z. B. ein defektes oder abgetrenntes Netzwerkkabel) oder eines Fehlers beim Herstellen einer Verbindung mit einem virtuellen privaten Netzwerk (VPN) verloren gehen. Die Option „retry“ kann für große Netzwerke mit regem Datenverkehr verwendet werden, bei denen die Konnektivität ausreichend ist, die Kommunikationslatenz aber ein Problem darstellt.</p>
        </td>
      </tr>
      <tr>
        <td colspan="1">
          <p>
            <strong>/w:</strong>
            <em>&lt;SecondsBeforeRetry&gt;</em>
          </p>
        </td>
        <td colspan="2">
          <p>
            <strong>(Warten)</strong>
          </p>
          <p>Gibt die Wartezeit in Sekunden an, bevor ein Netzwerkdateivorgang wiederholt wird. Der Standardwert ist 1 Sekunde.</p>
        </td>
      </tr>
      <tr>
        <td>
          <p>
            <strong>/p:</strong>
            <em>&lt;pathToFile&gt;</em>
          </p>
        </td>
        <td>
          <p>Der Befehl <strong>ScanState</strong> erstellt bei seiner Ausführung eine XML-Datei am angegebenen Pfad. Diese XML-Datei enthält verbesserte Speicherplatzschätzungen für den Migrationsspeicher. Das folgende Beispiel zeigt, wie Sie diese XML-Datei erstellen:</p>
          <p>
            <code>Scanstate.exe C:\MigrationLocation [additional parameters]</code>
          </p>
          <p>
            <code>/p:"C:\MigrationStoreSize.xml"</code>
          </p>
          <p>Weitere Informationen finden Sie unter <a runat="server" href="hh825132(v=win.10).md">Schätzen der Migrationsspeichergröße</a>.</p>
          <p>Um die Funktionalität vorhandener Apps oder Skripts zu erhalten, für die das vorherige Verhalten von USMT erforderlich ist, können Sie die Option <strong>/p</strong> ohne Angabe von <em>"PfadZuEinerDatei"</em> in USMT verwenden. Falls Sie nur die Option <strong>/p</strong> angeben, werden die Speicherplatzschätzungen wie bei USMT3.x-Versionen erstellt.</p>
        </td>
      </tr>
      <tr>
        <td colspan="1">
          <p>
            <strong>/?</strong> oder <strong>/help</strong></p>
        </td>
        <td colspan="2">
          <p>Zeigt die Hilfe an der Befehlszeile an.</p>
        </td>
      </tr>
    </table>

Benutzeroptionen

Standardmäßig werden alle Benutzer migriert. Die einzige Möglichkeit zum Angeben der ein- und auszuschließenden Benutzer sind die folgenden Optionen. Es ist nicht möglich, Benutzer in den XML-Migrationsdateien oder mit der Datei „Config.xml“ auszuschließen. Weitere Informationen finden Sie unter Identifizieren von Benutzern und Migrieren von Benutzerkonten.

Befehlszeilenoption	Beschreibung
/all	Migriert alle Benutzer auf dem PC. USMT migriert alle Benutzerkonten auf dem PC, sofern Sie ein Konto nicht ausdrücklich mit der Option /ue oder /uel ausschließen. Aus diesem Grund müssen Sie diese Option nicht in der Befehlszeile angeben. Falls Sie aber die Option /all angeben, ist es nicht möglich, gleichzeitig auch die Optionen /ui, /ue oder /uel zu verwenden.
/ui: <DomainName>\<UserName> oder /ui: <ComputerName>\<LocalUserName>	(Benutzer einschließen) Migriert die angegebenen Benutzer. Standardmäßig werden alle Benutzer in die Migration eingeschlossen. Diese Option ist daher nur von Nutzen, wenn sie mit der Option /ue oder /uel verwendet wird. Sie können mehrere /ui-Optionen angeben, es ist aber nicht möglich, die Option /ui mit der Option /all zu kombinieren. DomainName und UserName können das Sternchen (*) als Platzhalterzeichen enthalten. Wenn Sie einen Benutzernamen mit Leerzeichen angeben, müssen Sie ihn in Anführungszeichen einschließen. Hinweis Wenn ein Benutzer mit der Option /ui angegeben (eingeschlossen) und zudem mit der Option /ue oder /uel angegeben (ausgeschlossen) wird, wird er nicht in die Migration einbezogen. Beispiel: Um nur „User2“ aus der Fabrikam-Domäne einzuschließen, geben Sie Folgendes ein: /ue:*\* /ui:fabrikam\user2 Um alle Benutzer aus der Fabrikam-Domäne und nur die Benutzerkonten aus anderen Domänen, die innerhalb der letzten 30 Tage aktiv waren oder anderweitig geändert wurden, zu migrieren, geben Sie Folgendes ein: /uel:30 /ui:fabrikam\* In diesem Beispiel wird ein Benutzerkonto aus der Contoso-Domäne, das zuletzt vor zwei Monaten geändert wurde, nicht migriert. Weitere Beispiele finden Sie in den Beschreibungen der Optionen /ue und /ui in dieser Tabelle.
/uel: <NumberOfDays> oder /uel: <YYYY/MM/DD> oder /uel:0	(Benutzer basierend auf der letzten Anmeldung ausschließen) Migriert die Benutzer, die sich innerhalb des angegebenen Zeitraums am Quell-PC angemeldet haben, basierend auf dem Datum Letzte Änderung der Datei „Ntuser.dat“ auf dem Quell-PC. Die Option /uel fungiert als Include-Regel. Die Option /uel:30 migriert z. B. Benutzer, die sich innerhalb der letzten 30 Tage ab dem Datum der Ausführung des Befehls „ScanState“ angemeldet haben oder deren Konto in diesem Zeitraum geändert wurde. Sie können eine Anzahl von Tagen oder ein Datum angeben. Diese Option kann nicht mit der Option /all verwendet werden. USMT ruft die Informationen zur letzten Anmeldung vom lokalen PC ab. Der PC muss daher beim Ausführen dieser Option nicht mit dem Netzwerk verbunden sein. Wenn sich ein Domänenbenutzer an einem anderen PC angemeldet hat, wird diese Anmeldung außerdem nicht von USMT berücksichtigt. Hinweis Die Option /uel kann nicht für Offlinemigrationen verwendet werden. /uel:0 migriert alle momentan angemeldeten Benutzer. /uel:90 migriert Benutzer, die sich innerhalb der letzten 90 Tage angemeldet haben oder deren Konten in diesem Zeitraum anderweitig geändert wurden. /uel:1 migriert Benutzer, deren Konten innerhalb der letzten 24 Stunden geändert wurden. /uel:2002/1/15 migriert Benutzer, die sich seit einschließlich dem 15. Januar 2002 angemeldet haben oder deren Konten in diesem Zeitraum geändert wurden. Beispiel: scanstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore /uel:0
/ue: <DomainName>\<UserName> – oder – /ue: <ComputerName>\<LocalUserName>	(Benutzer ausschließen) Schließt die angegebenen Benutzer von der Migration aus. Sie können mehrere /ue-Optionen angeben. Diese Option kann nicht mit der Option /all verwendet werden. <DomainName> und <UserName> können das Sternchen (*) als Platzhalterzeichen enthalten. Wenn Sie einen Benutzernamen mit Leerzeichen angeben, müssen Sie ihn in Anführungszeichen einschließen. Beispiel: scanstate /i:migdocs.xml /i:migapp.xml \\server\share\migration\mystore /ue:contoso\user1

Verwenden der Optionen „/ui“ und „/ue“

Die folgenden Beispiele gelten sowohl für die Option /ui als auch für die Option /ue. Sie können /ue durch die Option /ui ersetzen, um die angegebenen Benutzer nicht auszuschließen, sondern einzuschließen.

Gemeinsame Verwendung der Optionen

Die Optionen /uel, /ue und /ui können zusammen verwendet werden, um nur die gewünschten Benutzer zu migrieren.

Die Option „/ui“ hat Vorrang vor den Optionen „/ue“ und „/uel“. Wenn ein Benutzer mit der Option /ui angegeben (eingeschlossen) und zudem mit der Option /ue oder /uel angegeben (ausgeschlossen) wird, wird er in die Migration einbezogen. Wenn Sie z. B. /ui:contoso\* /ue:contoso\user1 angeben, wird „User1“ migriert, weil die Option /ui Vorrang vor der Option /ue hat.

Die Option „/uel“ hat Vorrang vor der Option „/ue“. Wenn sich ein Benutzer innerhalb des mit /uel festgelegten Zeitraums angemeldet hat, wird das Profil dieses Benutzers auch dann migriert, wenn er mit der Option /ue ausgeschlossen wurde. Geben Sie z. B. /ue:fixed\user1 /uel:14 an, wird „User1“ migriert, sofern er sich innerhalb der letzten 14 Tage am PC angemeldet hat.

Optionen für verschlüsselte Dateien

Die folgenden Optionen können zum Migrieren verschlüsselter Dateien verwendet werden. In allen Fällen tritt bei USMT standardmäßig ein Fehler auf, wenn eine verschlüsselte Datei gefunden wird und Sie die Option /efs nicht angegeben haben. Um verschlüsselte Dateien zu migrieren, müssen Sie das Standardverhalten ändern.

Weitere Informationen finden Sie unter Migrieren von EFS-Dateien und -Zertifikaten.

Inkompatible Befehlszeilenoptionen

Die folgende Tabelle zeigt, welche Befehlszeilenoptionen nicht mit dem Befehl ScanState kompatibel sind. Falls der Tabelleneintrag für eine bestimmte Kombination leer ist, sind die Optionen kompatibel und können zusammen verwendet werden. Das Symbol X bedeutet, dass die Optionen nicht kompatibel sind. Die Option /nocompress kann z. B. nicht mit der Option /encrypt verwendet werden.

Siehe auch

Weitere Ressourcen

XML-Elementbibliothek