replace

Ersetzen vorhandener Dateien in einem Verzeichnis. Bei Verwendung mit der Option /a fügt dieser Befehl einem Verzeichnis neue Dateien hinzu, anstatt vorhandene Dateien zu ersetzen.

Syntax

replace [<drive1>:][<path1>]<filename> [<drive2>:][<path2>] [/a] [/p] [/r] [/w]
replace [<drive1>:][<path1>]<filename> [<drive2>:][<path2>] [/p] [/r] [/s] [/w] [/u]

Parameter

Parameter Beschreibung
[<drive1>:][<path1>]<filename> Gibt den Speicherort und den Namen der Quelldatei oder des Dateisatzes an. Die Dateinamenoption ist erforderlich und kann Platzhalterzeichen ( und ?) enthalten.
[<drive2>:][<path2>] Gibt den Speicherort der Zieldatei an. Sie können keinen Dateinamen für Dateien angeben, die Sie ersetzen. Wenn Sie kein Laufwerk oder Pfad angeben, verwendet dieser Befehl das aktuelle Laufwerk und das aktuelle Verzeichnis als Ziel.
/a Fügt dem Zielverzeichnis neue Dateien hinzu, anstatt vorhandene Dateien zu ersetzen. Sie können diese Befehlszeilenoption nicht mit der Befehlszeilenoption /s oder /u verwenden.
/p Fordert Sie zur Bestätigung auf, bevor Sie eine Zieldatei ersetzen oder eine Quelldatei hinzufügen.
/r Ersetzt schreibgeschützte und ungeschützte Dateien. Wenn Sie versuchen, eine schreibgeschützte Datei zu ersetzen, aber / r nicht angeben, wird ein Fehler ausgegeben, und der Ersetzungsvorgang wird beendet.
/w Wartet, bis Sie einen Datenträger einfügen, bevor die Suche nach Quelldateien beginnt. Wenn Sie /w nicht angeben, beginnt dieser Befehl sofort mit dem Ersetzen oder Hinzufügen von Dateien, nachdem Sie die EINGABETASTE gedrückt haben.
/s Durchsucht alle Unterverzeichnisse im Zielverzeichnis und ersetzt übereinstimmende Dateien. Sie können /s nicht mit der Befehlszeilenoption /a verwenden. Der Befehl durchsucht keine Unterverzeichnisse, die in Path1 angegeben sind.
/U Ersetzt nur die Dateien im Zielverzeichnis, die älter sind als die Dateien im Quellverzeichnis. Sie können /u nicht mit der Befehlszeilenoption /a verwenden.
/? Zeigt die Hilfe an der Eingabeaufforderung an.

Bemerkungen

  • Wenn dieser Befehl Dateien hinzufügt oder ersetzt, werden die Dateinamen auf dem Bildschirm angezeigt. Nach Abschluss dieses Befehls wird eine Zusammenfassungszeile in einem der folgenden Formate angezeigt:

    nnn files added
    nnn files replaced
    no file added
    no file replaced
    
  • Wenn Sie Disketten verwenden und datenträger wechseln müssen, während Sie diesen Befehl ausführen, können Sie die Befehlszeilenoption /w angeben, damit dieser Befehl darauf wartet, dass Sie die Datenträger wechseln.

  • Sie können diesen Befehl nicht verwenden, um ausgeblendete Dateien oder Systemdateien zu aktualisieren.

  • Die folgende Tabelle zeigt jeden Exitcode und eine kurze Beschreibung seiner Bedeutung:

    Exitcode BESCHREIBUNG
    0 Dieser Befehl hat die Dateien erfolgreich ersetzt oder hinzugefügt.
    1 Dieser Befehl hat eine falsche Version von MS-DOS festgestellt.
    2 Dieser Befehl konnte die Quelldateien nicht finden.
    3 Dieser Befehl konnte den Quell- oder Zielpfad nicht finden.
    5 Der Benutzer hat keinen Zugriff auf die Dateien, die Sie ersetzen möchten.
    8 Es ist nicht genügend Systemspeicher vorhanden, um den Befehl auszuführen.
    11 Der Benutzer hat in der Befehlszeile die falsche Syntax verwendet.

Hinweis

Sie können den ERRORLEVEL-Parameter in der if-Befehlszeile in einem Batchprogramm verwenden, um Exitcodes zu verarbeiten, die von diesem Befehl zurückgegeben werden.

Beispiele

Geben Sie Folgendes ein, um alle Versionen einer Datei namens Phones.cli (die in mehreren Verzeichnissen auf Laufwerk C:) angezeigt wird, mit der neuesten Version der Datei Phones.cli von einem Diskettendatenträger auf Laufwerk A: zu aktualisieren:

replace a:\phones.cli c:\ /s

Weitere Verweise