Freigeben über

ScanState-Syntax

  • Artikel

Der Befehl „ScanState“ wird mit User State Migration Tool (USMT) 5.0 verwendet, um den Quell-PC zu überprüfen, die Dateien und Einstellungen zu sammeln und einen Speicher zu erstellen.

Inhalt dieses Themas

Vorbemerkungen

Syntax

Speicheroptionen

Migrationsregeloptionen

Überwachungsoptionen

Benutzeroptionen

Optionen für verschlüsselte Dateien

Inkompatible Befehlszeilenoptionen

Vorbemerkungen

Beachten Sie vor dem Ausführen des Befehls ScanState Folgendes:

  • Um sicherzustellen, dass alle Betriebssystemeinstellungen migriert werden, müssen Sie die ScanState-Befehle in den meisten Fällen im Verwaltungsmodus mit einem Konto mit Administratoranmeldeinformationen ausführen.

  • Falls Sie den Migrationsspeicher verschlüsseln, müssen Sie einen Verschlüsselungsschlüssel oder den Pfad zu einer Datei, die den Verschlüsselungsschlüssel enthält, eingeben. Da der Schlüssel bzw. Schlüsseldateipfad nicht im Migrationsspeicher gespeichert wird, müssen Sie diese Informationen unbedingt notieren. Sie benötigen sie, wenn Sie den Migrationsspeicher mit dem Befehl „LoadState“ entschlüsseln oder das Wiederherstellungshilfsprogramm ausführen müssen. Wird ein falscher oder fehlender Schlüssel bzw. Schlüsseldateipfad angegeben, erscheint eine Fehlermeldung.

  • Informationen zu den Softwareanforderungen für die Ausführung des Befehls ScanState finden Sie unter USMT-Anforderungen.

    Wichtig

    Windows XP und Windows Vista® werden nur auf dem Quell-PC als Betriebssysteme unterstützt.

  • Sofern nichts anderes angegeben ist, kann jede Option beim Ausführen eines Tools in der Befehlszeile nur einmal verwendet werden.

  • Sie können Domänenkonten sammeln, wenn der Quell-PC keinen Zugriff auf den Domänencontroller hat. Diese Funktion ist ohne zusätzliche Konfiguration verfügbar.

  • Der Tabelle Inkompatible Befehlszeilenoptionen können Sie entnehmen, welche Optionen zusammen verwendet werden können und welche Befehlszeilenoptionen inkompatibel sind.

  • Der Speicherort des Verzeichnisses, in dem Sie den Migrationsspeicher speichern, ist vom Scan ausgeschlossen. Wenn Sie den Migrationsspeicher beispielsweise im Stammverzeichnis des Laufwerks „D“ speichern, sind das Laufwerk „D“ und alle untergeordneten Verzeichnisse vom Scan ausgeschlossen.

Syntax

In diesem Abschnitt werden die Syntax und die Verwendung der ScanState-Befehlszeilenoptionen erläutert. Die Optionen können in beliebiger Reihenfolge angegeben werden. Falls die Option einen Parameter enthält, können Sie einen Doppelpunkt oder ein Leerzeichen als Trennzeichen verwenden.

Die Syntax des Befehls ScanState lautet wie folgt:

scanstate [StorePath] [/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|YYYY/MM/DD|0] [/efs:abort|skip|decryptcopy|copyraw] [/genconfig:[Path\]FileName[/config:[Path\]FileName] [/?|help]

Beispiel:

  • Um eine Datei „Config.xml“ im aktuellen Verzeichnis zu erstellen, verwenden Sie folgende Syntax:

    scanstate /i:migapp.xml /i:migdocs.xml /genconfig:config.xml /v:13

  • Um einen verschlüsselten Speicher mit der Datei „Config.xml“ und den standardmäßigen XML-Migrationsdateien zu erstellen, verwenden Sie folgende Syntax:

    scanstate \\server\share\migration\mystore /i:migapp.xml /i:migdocs.xml /o /config:config.xml /v:13 /encrypt /key:"mykey"

Speicheroptionen

Befehlszeilenoption Beschreibung

StorePath

Gibt einen Ordner an, in dem Dateien und Einstellungen gespeichert werden. StorePath kann nicht c:\ sein. Sie müssen die Option StorePath im Befehl ScanState angeben, sofern Sie nicht die Option /genconfig verwenden. Es ist nicht möglich, mehrere Speicherorte mit StorePath anzugeben.

/o

Diese Option muss angegeben werden, um vorhandene Daten im Migrationsspeicher oder in der Datei „Config.xml“ zu überschreiben. Wird sie nicht angegeben, tritt beim Befehl ScanState ein Fehler auf, wenn der Migrationsspeicher bereits Daten enthält. Diese Option kann in einer Befehlszeile nur einmal verwendet werden.

/vsc

Wenn diese Option angegeben wird, kann der Volumenschattenkopie-Dienst Dateien migrieren, die gesperrt sind oder gerade verwendet werden. Diese Befehlszeilenoption verhindert den Großteil der Fehler aufgrund gesperrter Dateien, die normalerweise im <ErrorControl>-Abschnitt zu finden sind.

Diese Option kann nur mit der ausführbaren Datei von „ScanState“ verwendet und nicht mit der Option /hardlink kombiniert werden.

/hardlink

Aktiviert die Erstellung eines Migrationsspeichers mit festem Link am angegebenen Speicherort. Die Option /nocompress muss mit der Option /hardlink angegeben werden.

/encrypt [{/key:<KeyString> | /keyfile:<file>]}

Verschlüsselt den Speicher mit dem angegebenen Schlüssel. Die Verschlüsselung ist standardmäßig deaktiviert. Bei dieser Option müssen Sie den Verschlüsselungsschlüssel mit einer der folgenden Methoden angeben:

  • /key: KeyString gibt den Verschlüsselungsschlüssel an. Falls KeyString ein Leerzeichen enthält, müssen Sie KeyString in Anführungszeichen einschließen.

  • /keyfile: FilePathAndName gibt eine Textdatei (TXT) an, die den Verschlüsselungsschlüssel enthält.

Wir empfehlen für KeyString eine Mindestzeichenlänge von acht Zeichen, wobei aber maximal 256 Zeichen zulässig sind. Die Optionen /key und /keyfile können nicht in derselben Befehlszeile verwendet werden. Die Optionen /encrypt und /nocompress können nicht in derselben Befehlszeile verwendet werden.

> [!IMPORTANT] > Bei der Verwendung dieser Option ist Vorsicht angebracht, da jeder, der Zugriff auf das ScanState-Befehlszeilenskript hat, auch Zugriff auf den Verschlüsselungsschlüssel hat. >

Das folgende Beispiel zeigt den Befehl „ScanState“ und die Option /key:

scanstate /i:migdocs.xml /i:migapp.xml \\server\share\migration\mystore /encrypt /key:mykey

/encrypt:<EncryptionStrength>

Mit der Option /encrypt kann ein Befehlszeilenparameter zum Festlegen der Verschlüsselungsstärke für die Verschlüsselung des Migrationsspeichers angegeben werden. Weitere Informationen zu unterstützten Verschlüsselungsalgorithmen finden Sie unter Verschlüsselung des Migrationsspeichers.

/nocompress

Deaktiviert die Komprimierung von Daten und speichert die Dateien unter „StorePath\USMT“ in einem ausgeblendeten Ordner mit dem Namen „File“. Die Komprimierung ist standardmäßig aktiviert. Wenn Sie die Option /nocompress mit der Option /hardlink kombinieren, wird ein Migrationsspeicher mit festem Link erstellt. Stellen Sie mit dem nicht komprimierten Speicher fest, was von USMT gespeichert wurde, Probleme zu beheben oder die Dateien mit einem Antivirenprogramm zu überprüfen. Diese Option sollte nur in Testumgebungen verwendet werden. Während der tatsächlichen Migration empfehlen wir die Verwendung eines komprimierten Speichers, sofern Sie die Option /nocompress nicht mit der Option /hardlink kombinieren.

Die Optionen /nocompress und /encrypt können nicht zusammen in einer Anweisung in der Befehlszeile verwendet werden. Falls Sie sich aber entscheiden, einen nicht komprimierten Speicher zu migrieren, migriert der Befehl LoadState jede Datei ohne temporären Speicherort direkt aus dem Speicher zum richtigen Speicherplatz auf dem Ziel-PC.

Beispiel:

scanstate /i:migdocs.xml /i:migapp.xml \\server\share\migration\mystore /nocompress

Ausführen des Befehls „ScanState“ auf einem Windows-Offlinesystem

Sie können den Befehl ScanState in Windows PE ausführen. Außerdem unterstützt USMT Migrationen von vorherigen Windows-Installationen in „Windows.old“-Verzeichnisse. Das Offlineverzeichnis kann ein Windows-Verzeichnis sein, wenn Sie den Befehl ScanState in Windows PE ausführen, oder ein Verzeichnis „Windows.old“, wenn Sie den Befehl ScanState in Windows ausführen.

Die Ausführung des Befehls ScanState für ein Windows-Offlineimage bietet u. a. die folgenden Vorteile:

  • Verbesserte Leistung.

    Da Windows PE ein reduziertes Betriebssystem ist, werden weniger Dienste ausgeführt. In dieser Umgebung hat der Befehl ScanState umfassenderen Zugriff auf die lokalen Hardwareressourcen, wodurch ScanState Migrationsvorgänge schneller ausführen kann.

  • Vereinfachter End-to-End-Bereitstellungsvorgang.

    Das Migrieren von Daten aus dem Verzeichnis „Windows.old“ vereinfacht den End-to-End-Bereitstellungsvorgang, da der Migrationsvorgang nach dem Installieren des neuen Betriebssystems ausgeführt werden kann.

  • Weniger Migrationsfehler.

    Migrationen können öfter erfolgreich abgeschlossen werden, weil Dateien bei einem Offlinebetriebssystem nicht zur Bearbeitung gesperrt werden und Windows PE Administratorzugriff auf Dateien im Windows-Offlinedateisystem bietet. Auf das Onlinesystem ist daher kein Zugriff auf Administratorebene notwendig.

  • Wiederherstellung nicht startbarer PCs.

    Möglicherweise können Daten von einem PC, der sich nicht mehr starten lässt, wiederhergestellt und migriert werden.

Optionen für die Offlinemigration

Befehlszeilenoption Definition

/offline: "Pfad zu einer XML-Offlinedatei"

Diese Option wird verwendet, um den Pfad zu einer XML-Offlinedatei anzugeben, die andere Offlinemigrationsoptionen enthalten kann, z. B. ein Windows-Offlineverzeichnis oder eine für die Migration erforderliche Domänen- oder Ordnerumleitung.

/offlinewindir: "Pfad zu einem Windows-Verzeichnis"

Diese Option gibt das Windows-Offlineverzeichnis an, aus dem der Befehl ScanState Informationen zum Benutzerstatus sammelt. Das Offlineverzeichnis kann ein Verzeichnis „Windows.old“ sein, wenn Sie den Befehl ScanState in Windows ausführen, oder ein Windows-Verzeichnis, wenn Sie den Befehl ScanState in Windows PE ausführen.

/offlinewinold: "Verzeichnis ‚Windows.old’"

Diese Befehlszeilenoption aktiviert den Offlinemigrationsmodus und startet die Migration vom angegebenen Speicherort. Sie dient nur für Migrationsszenarien mit „Windows.old“, bei denen die Migration aus einem Verzeichnis „Windows.old“ erfolgt.

Migrationsregeloptionen

In USMT stehen die folgenden Optionen zum Angeben der zu migrierenden Dateien zur Verfügung.

Befehlszeilenoption Beschreibung

/i:[Path\]FileName

(Einschließen)

Gibt eine XML-Datei mit Regeln an, die die zu migrierenden Benutzer-, App- oder Systemstatus festlegen. Sie können diese Option mehrmals angeben, um alle XML-Dateien („MigApp.xml“, „MigDocs.xml“ und von Ihnen erstellte benutzerdefinierte XML-Dateien) einzuschließen. Path kann ein relativer oder vollständiger Pfad sein. Wenn Sie die Path-Variable nicht angeben, muss sich FileName im aktuellen Verzeichnis befinden. Weitere Informationen zu den Dateien, die hier angegeben werden sollten, finden Sie im Abschnitt „XML-Dateien“ des Themas Häufig gestellte Fragen.

/genconfig:[Path\]FileName

(Generate Config.xml)

Erstellt die optionale Datei „Config.xml“, aber keinen Migrationsspeicher. Um sicherzustellen, dass diese Datei alle Komponenten, Apps und Einstellungen enthält, die migriert werden können, sollten Sie diese Datei auf einem Quell-PC erstellen, der alle Komponenten, Apps und Einstellungen enthält, die auf den Ziel-PCs vorhanden sein werden. Außerdem sollten Sie bei Verwendung dieser Option die anderen XML-Migrationsdateien mit der Option /i angeben.

Nachdem Sie diese Datei erstellt haben, müssen Sie sie mit dem Befehl ScanState und der Option /config verwenden.

Die einzigen Optionen, die mit dieser Option angegeben werden können, sind die Optionen /i, /v und /l. StorePath kann nicht angegeben werden, weil die Option /genconfig keinen Speicher erstellt. Path kann ein relativer oder vollständiger Pfad sein. Wenn Sie die Path-Variable nicht angeben, wird FileName im aktuellen Verzeichnis erstellt.

Beispiele:

  • Im folgende Beispiel wird eine Datei „Config.xml“ im aktuellen Verzeichnis erstellt:

    scanstate /i:migapp.xml /i:migdocs.xml /genconfig:config.xml /v:13

/config:[Path\]FileName

Gibt die Datei „Config.xml“ an, die der Befehl ScanState zum Erstellen des Speichers verwenden soll. Diese Option kann in einer Befehlszeile nur einmal verwendet werden. Path kann ein relativer oder vollständiger Pfad sein. Wenn Sie die Path-Variable nicht angeben, muss sich FileName im aktuellen Verzeichnis befinden.

Im folgenden Beispiel wird ein Speicher mit den Dateien „Config.xml“, „MigDocs.xml“ und „MigApp.xml“ erstellt:

scanstate \\server\share\migration\mystore /config:config.xml /i:migdocs.xml /i:migapp.xml /v:13 /l:scan.log

Im folgenden Beispiel werden die Dateien und Einstellungen mit den Dateien Config.xml, MigDocs.xml und MigApp.xml zum Ziel-PC migriert:

loadstate \\server\share\migration\mystore /config:config.xml /i:migdocs.xml /i:migapp.xml /v:13 /l:load.log

/auto: Pfad zu Skriptdateien

Diese Option ermöglicht es Ihnen, den Speicherort der XML-Standarddateien anzugeben und anschließend die Migration zu starten. Wird kein Pfad angegeben, verweist USMT auf das Verzeichnis, in dem sich die USMT-Binärdateien befinden. Die Option /auto hat die gleiche Wirkung wie die Verwendung der folgenden Optionen: /i:MigDocs.xml/i:MigApp.xml /v:5.

/genmigxml: Pfad zu einer Datei

Diese Option gibt an, dass der Befehl ScanState mithilfe der Dokumentsuche eine XML-Datei erstellen und exportieren soll, die definiert, wie alle Dateien auf dem PC, auf dem der Befehl ScanState ausgeführt wird, migriert werden sollen.

/localonly

Migriert unabhängig von den Regeln in den in der Befehlszeile angegebenen XML-Dateien nur Dateien, die auf dem lokalen PC gespeichert sind. Sie sollten diese Option verwenden, wenn Sie die Daten von Wechseldatenträgern auf dem Quell-PC (z. B. USB-Speichersticks, bestimmte externe Festplatten usw.) ausschließen möchten und auf dem Quell-PC Netzlaufwerke zugeordnet sind. Wird die Option /localonly nicht angegeben, kopiert der Befehl ScanState Dateien von diesen Wechseldatenträgern oder Netzlaufwerken in den Speicher.

Alle Datenträger, die vom Betriebssystem nicht als lokale Festplattenlaufwerke eingestuft werden, werden von /localonly ausgeschlossen. In manchen Fällen werden große externe Festplatten als lokale Festplattenlaufwerke betrachtet. Diese Laufwerke können mithilfe einer benutzerdefinierten XML-Datei von der Migration ausgeschlossen werden. Weitere Informationen zum Ausschließen aller Dateien auf einem bestimmten Laufwerk finden Sie unter Ausschließen von Dateien und Einstellungen.

Die Befehlszeilenoption /localonly schließt Daten wie in der folgenden Tabelle angegeben in die Migration ein bzw. von ihr aus:

 

Laufwerktyp Verhalten bei Verwendung von /localonly

Wechseldatenträger wie z. B. USB-Speichersticks

Ausgeschlossen

Netzlaufwerke

Ausgeschlossen

Lokale Festplattenlaufwerke

Eingeschlossen

Überwachungsoptionen

USMT enthält mehrere Optionen, mit denen Sie während der Migration aufgetretene Probleme analysieren können.

Hinweis

Das ScanState-Protokoll wird standardmäßig erstellt, Sie können aber den Namen und Speicherort des Protokolls mit der Option /l angeben.

Befehlszeilenoption Beschreibung

/listfiles:<FileName>

Sie können die Befehlszeilenoption /listfiles mit dem Befehl ScanState verwenden, um eine Textdatei zu erstellen, die alle in der Migration enthaltenen Dateien auflistet.

/l:[Path\]FileName

Gibt den Speicherort und Namen des ScanState-Protokolls an.

Sie können keine Protokolldateien in StorePath speichern. Path kann ein relativer oder vollständiger Pfad sein. Wenn Sie die Path-Variable nicht angeben, wird das Protokoll im aktuellen Verzeichnis erstellt. Mit der Option /v können Sie den Umfang bzw. Ausführlichkeitsgrad der Protokollausgabe anpassen.

Falls Sie die Befehle ScanState oder LoadState für eine freigegebene Netzwerkressource ausführen, müssen Sie diese Option angeben. Andernfalls tritt bei der Ausführung von USMT der folgende Fehler auf: „USMT was unable to create the log file(s)“. Verwenden Sie zur Lösung des Problems den Befehl /l:scan.log.

/v: <VerbosityLevel>

(Verbosity)

Aktiviert die ausführliche Ausgabe in der ScanState-Protokolldatei. Der Standardwert ist 0.

Sie können VerbosityLevel auf einen der folgenden Ausführlichkeitsgrade festlegen:

 

Grad Erläuterung

0

Aktiviert nur die standardmäßigen Fehler und Warnungen.

1

Aktiviert die ausführliche Ausgabe.

4

Aktiviert die Fehler- und Statusausgabe.

5

Aktiviert die ausführliche Ausgabe und Statusausgabe.

8

Aktiviert die Fehlerausgabe an einen Debugger.

9

Aktiviert die ausführliche Ausgabe an einen Debugger.

12

Aktiviert die Fehler- und Statusausgabe an einen Debugger.

13

Aktiviert die ausführliche Ausgabe, Status- und Debuggerausgabe.

 
          </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.

noteHinweis
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.

noteHinweis
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.

Verhalten Befehl

Den Benutzer „User One“ in der Fabrikam-Domäne ausschließen.

/ue:"fabrikam\user one"

Den Benutzer „User1“ in der Fabrikam-Domäne ausschließen.

/ue:fabrikam\user1

Den lokalen Benutzer „User1“ ausschließen.

/ue:%computername%\user1

Alle Domänenbenutzer ausschließen.

/ue:Domain\*

Alle lokalen Benutzer ausschließen.

/ue:%computername%\*

Benutzer namens „User1“, „User2“ usw. in allen Domänen ausschließen.

/ue:*\user*

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.

Verhalten Befehl

Nur „User2“ aus der Fabrikam-Domäne einschließen und alle anderen Benutzer ausschließen.

/ue:*\* /ui:fabrikam\user2

Nur den lokalen Benutzer „User1“ einschließen und alle anderen Benutzer ausschließen.

/ue:*\* /ui:user1

Nur die Domänenbenutzer aus der Contoso-Domäne mit Ausnahme von „Contoso\User1“ einschließen.

Dieses Verhalten kann nicht mit einem einzigen Befehl herbeigeführt werden. Stattdessen müssen Sie Folgendes angeben, um diesen Satz von Benutzern zu migrieren:

  • Geben Sie in der ScanState-Befehlszeile Folgendes ein: /ue:*\* /ui:contoso\*

  • Geben Sie in der LoadState-Befehlszeile Folgendes ein: /ue:contoso\user1

Nur lokale (nicht in einer Domäne enthaltene) Benutzer einschließen.

/ue:*\* /ui:%computername%\*

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.

Hinweis

Bei Migrationen zu Windows Vista, Windows 7 oder Windows 8 werden EFS-Zertifikate automatisch migriert. Daher sollten Sie die Option /efs:copyraw mit dem Befehl ScanState angeben, um die verschlüsselten Dateien zu migrieren.

Warnung

Beim Migrieren verschlüsselter Dateien ist Vorsicht geboten. Wenn Sie eine verschlüsselte Datei migrieren, ohne auch das Zertifikat zu migrieren, können Endbenutzer nach der Migration nicht auf die Datei zugreifen.

Befehlszeilenoption Erläuterung

/efs:hardlink

Erstellt einen festen Link zur EFS-Datei, anstatt sie zu kopieren. Verwenden Sie diese Option nur mit den Optionen /hardlink und /nocompress.

/efs:abort

Legt fest, dass der Befehl ScanState mit einem Fehlercode fehlschlägt, wenn eine Datei des verschlüsselnden Dateisystems (EFS) auf dem Quell-PC gefunden wird. Diese Option ist standardmäßig aktiviert.

/efs:skip

Legt fest, dass EFS-Dateien vom Befehl ScanState ignoriert werden.

/efs:decryptcopy

Legt fest, dass der Befehl ScanState die Datei vor dem Speichern im Migrationsspeicher nach Möglichkeit entschlüsselt und fehlschlägt, wenn sie nicht entschlüsselt werden kann. Wenn der Befehl ScanState erfolgreich ausgeführt wird, ist die Datei im Migrationsspeicher unverschlüsselt. Beim Ausführen des Befehls LoadState wird die Datei dann auf den Ziel-PC kopiert.

/efs:copyraw

Legt fest, dass der Befehl ScanState die Dateien im verschlüsselten Format kopiert. Auf dem Ziel-PC kann erst nach dem Migrieren der EFS-Zertifikate auf die Dateien zugegriffen werden. EFS-Zertifikate werden automatisch migriert. USMT schlägt aber standardmäßig fehl, wenn eine verschlüsselte Datei gefunden wird und Sie keine /efs-Option angegeben haben. Daher sollten Sie die Option /efs:copyraw mit dem Befehl ScanState angeben, um die verschlüsselten Dateien zu migrieren. Wenn Sie anschließend den Befehl LoadState ausführen, werden die verschlüsselte Datei und das EFS-Zertifikat automatisch migriert.

Beispiel:

ScanState /i:migdocs.xml /i:migapp.xml \\server\share\migration\mystore /efs:copyraw

> [!IMPORTANT] > Alle Dateien müssen verschlüsselt werden, wenn der übergeordnete Ordner verschlüsselt ist. Falls das Verschlüsselungsattribut einer Datei in einem verschlüsselten Ordner entfernt wurde, wird die Datei während der Migration anhand der Anmeldeinformationen des Kontos verschlüsselt, das zum Ausführen von „LoadState“ verwendet wird. 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.

Befehlszeilenoption /keyfile /nocompress /genconfig /all

/i

/o

/v

/nocompress

X

Nicht verfügbar

/localonly

X

/key

X

X

/encrypt

Erforderlich*

X

X

/keyfile

Nicht verfügbar

X

/l

/progress

X

/r

X

/w

X

/c

X

/p

X

Nicht verfügbar

/all

X

/ui

X

X

/ue

X

X

/uel

X

X

/efs:<option>

X

/genconfig

Nicht verfügbar

/config

X

<StorePath>

X

Hinweis

Sie müssen die Option /key oder /keyfile mit der Option /encrypt angeben.

Siehe auch

Weitere Ressourcen

XML-Elementbibliothek