Home
> Commands N-Z
> Commands R
REPLACE
Description
| Syntax
| Parameters
| Switches
| Related
| Notes
| Examples
| Errorlevels
| Availability
Replaces files in a destination directory with files in a source
directory that have the same name. You can also use REPLACE to add
unique filenames to the destination directory.
Syntax
REPLACE
/?
REPLACE
[drive1:][path1]filename
[drive2:][path2]
[[/A]
| [/S]
[[/D]
| [/U]]]
[/P]
[/R]
[/W]
Parameters
- drive1:
( path1
filename
v3.2
Win95
NT3.1)
- Specifies the location and name of the source file or set of
files.
- drive2:
( path2
v3.2
Win95
NT3.1)
- Specifies the location of the destination file. You cannot
specify a filename for files you replace. If you specify neither
a drive nor a directory, REPLACE uses the current drive and
directory as the destination.
Switches
- /?
(NTXP)
- Displays help.
- /A
(v3.2
Win95
NT3.1)
- Adds new (missing) files to the destination directory instead of
replacing existing files. You cannot use this switch with the
/S or /U switch.
- /P
(v3.2
Win95
NT3.1)
- Prompts you for confirmation before replacing a destination
file or adding a source file.
- /R
(v3.2
Win95
NT3.1)
- Replaces read-only files as well as unprotected files. If you
do not specify this switch but attempt to replace a read-only
file, an error results and stops the replacement operation.
- /S
(v3.2
Win95
NT3.1)
- Searches all subdirectories of the destination directory and
replaces matching files. You cannot use the /S switch with the /A switch. The REPLACE command does not
search subdirectories specified in path1.
- /D
(v3.30 through
v4.0)
- /U
(v5.0
Win95
NT3.1)
- Replaces (updates) only those files on the destination
directory that are older than those in the source directory. You
cannot use the /U (or /D) switch with the /A
switch.
- /W
(v3.2
Win95
NT3.1)
- Waits for you to insert a disk before REPLACE begins to
search for source files. If you do not specify /W, REPLACE begins
replacing or adding files immediately after you press ENTER.
Related
ATTRIB - Changing file attributes.
ROBOCOPY - Robust File and Folder copy.
MOVE - Move files from one folder to another folder on the same drive.
DEL - Delete one or more files.
COPY - Copy one or more files to another location.
Equivalent Linux BASH commands:
install - Copy files and set attributes.
Notes
REPLACE messages
As REPLACE adds or replaces files, the operating system
displays their filenames on the screen. After the REPLACE command
is finished, the operating system displays a summary line in one
of the formats:
nnn files added
nnn files replaced
no file added
no file replaced
Replacing files on a floppy disk system
If you have a floppy disk system and need to switch disks during
the REPLACE operation, you can specify the
/W switch so that REPLACE will wait
for you to switch disks, as necessary.
Limitations on REPLACE
You cannot use the REPLACE command to update hidden files or
system files such as IO.SYS and MSDOS.SYS. For information about
changing hidden and system attributes, see the
ATTRIB command.
Examples
Suppose that several directories on drive C contain different
Versions of a file named PHONES.CLI, which contains client names
and phone numbers. To replace all of these files with the latest
version of the PHONES.CLI file from the disk in drive A, type:
REPLACE A:\PHONES.CLI C:\ /S
Suppose you want to add new printer device drivers to a
directory on drive C named TOOLS, which already contains several
printer device-driver files for a word processor. To do this, type:
REPLACE A:*.PRD C:\TOOLS /A
This command searches the current directory on drive A for any
files that have the extension .PRD and then adds these files to the
TOOLS directory on drive C. Because the
/A switch is included, REPLACE adds
only those files from drive A that do not exist on drive C.
Errorlevels
- 0 REPLACE successfully replaced or added the files
- 1 The computer has a version of the operating system that is incompatible with REPLACE?
- 2 REPLACE could not find the source files
- 3 REPLACE could not find the source or destination path
- 5 The user does not have access to the files you want to replace
- 8 There is insufficient system memory to carry out the command
- 11 The user used the wrong syntax on the command-line
- 15 Invalid drive specified
- 22 The computer has a version of the operating system that is incompatible with REPLACE?
Availability
- External
-
- DOS
-
v3.20
v3.05
v3.1
v3.21
v3.25
v3.30
v3.3A
v3.3R
v3.3T
v3.31
v3.40
v4.0
v4.01
v4.01A
v5.0
v5.0A
v5.00.02
v5.001A
v5.01
v5.02
v6.0
v6.10
v6.2
v6.21
v6.22
v6.23
v7.00
v7.0R1
v7.10
- Windows
-
Win95
Win98
- Windows NT
-
NT3.1
NT3.5
NT3.51
NT4
NT2000
NTXP
NT2003
Last Updated: 2006/12/01
Direct corrections or suggestions to:
Rick Lively