replace

  • Artikel

Ersetzt vorhandene 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 Quelldateisatzes an. Die Option filename 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 den Befehlszeilenoptionen /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 nicht geschützte Dateien. Wenn Sie versuchen, eine schreibgeschützte Datei zu ersetzen, aber /r nicht angeben, tritt ein Fehler auf 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 nach dem Drücken der EINGABETASTE mit dem Ersetzen oder Hinzufügen von Dateien.
/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 Es werden nur jene Dateien im Zielverzeichnis ersetzt, die älter als die Dateien im Quellverzeichnis sind. 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. Nachdem dieser Befehl ausgeführt wurde, 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 während der Ausführung dieses Befehls die Datenträger wechseln müssen, können Sie die Befehlszeilenoption /w angeben, damit dieser Befehl wartet, während Sie die Datenträger wechseln.

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

  • In der folgenden Tabelle sind alle Exitcodes und eine Kurzbeschreibung ihrer Bedeutung aufgeführt:

    Exitcode BESCHREIBUNG
    0 Dieser Befehl hat die Dateien erfolgreich ersetzt oder hinzugefügt.
    1 Dieser Befehl hat eine falsche Version von MS-DOS gefunden.
    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 die falsche Syntax in der Befehlszeile verwendet.

Hinweis

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

Beispiele

Um alle Versionen einer Datei mit dem Namen Phones.cli (die in mehreren Verzeichnissen auf Laufwerk C: angezeigt werden), mit der neuesten Version der Datei Phones.cli von einer Diskette im Laufwerk A: zu aktualisieren, geben Sie Folgendes ein:

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