Cmd.exe

Template:Short description Template:Distinguish {{#invoke:other uses|otheruses}} Template:Redirect Template:Lowercase title Template:Use mdy dates {{#invoke:Infobox|infobox}}Template:Template other{{#invoke:Check for unknown parameters | check | showblankpositional=1 | unknown = Template:Main other | preview = Page using Template:Infobox software with unknown parameter "_VALUE_"|ignoreblank=y | AsOf | author | background | bodystyle | caption | collapsetext | collapsible | developer | discontinued | engine | engines | genre | included with | language | language count | language footnote | latest preview date | latest preview version | latest release date | latest release version | latest_preview_date | latest_preview_version | latest_release_date | latest_release_version | licence | license | logo | logo alt | logo caption | logo upright | logo size | logo title | logo_alt | logo_caption | logo_upright | logo_size | logo_title | middleware | module | name | operating system | operating_system | other_names | platform | programming language | programming_language | released | replaced_by | replaces | repo | screenshot | screenshot alt | screenshot upright | screenshot size | screenshot title | screenshot_alt | screenshot_upright | screenshot_size | screenshot_title | service_name | size | standard | title | ver layout | website | qid }}Template:Main other cmd.exe, a.k.a. Command Prompt, is a shell program on later versions of Windows (NT and CE families), OS/2,<ref>{{#invoke:citation/CS1|citation |CitationClass=web }}</ref>, eComStation, ArcaOS, and ReactOS<ref name="ReactOS" />. In some versions of Windows (CE .NET 4.2,<ref>{{#invoke:citation/CS1|citation |CitationClass=web }}</ref> CE 5.0<ref>{{#invoke:citation/CS1|citation |CitationClass=web }}</ref> and Embedded CE 6.0<ref>{{#invoke:citation/CS1|citation |CitationClass=web }}</ref>) it is referred to as the Command Processor Shell. Implementation differs between operating systems, but with significant consistency of behavior and available commands.

Older, related operating systems, DOS and Windows 9x, provided Template:Mono as the shell. Template:Mono replaced Template:Mono in the Windows product line with the introduction of NT. Current versions of Windows include PowerShell as an alternative shell that runs side-by-side with Template:Mono.

The initial version of Template:Mono for Windows NT was developed by Therese Stowell.<ref name="Zachary_1994">Template:Cite book</ref> Windows CE 2.11 was the first embedded Windows release to support a console and a Windows CE version of Template:Mono.<ref>Template:Cite book</ref> The ReactOS implementation of Template:Mono is derived from FreeCOM, the FreeDOS command line interpreter.<ref name="ReactOS" />

Use

Desktop integration

In Windows, the shell is presented in the desktop via Windows Terminal or on older versions via Windows Console.

Concurrent piping

In OS/2 and Windows, the shell supports pipes to allow both sides of a pipeline to run concurrently. As a result, it is possible to redirect the standard error stream. In contrast, Template:Mono uses temporary files, and runs the two sides serially, one after the other.

Command separator

Multiple commands can be included in a single line using the command separator <syntaxhighlight lang="text" class="" style="" inline="1">&</syntaxhighlight> or <syntaxhighlight lang="text" class="" style="" inline="1">&&</syntaxhighlight>.<ref name="docs.microsoft.com">{{#invoke:citation/CS1|citation |CitationClass=web }}</ref>

With the <syntaxhighlight lang="text" class="" style="" inline="1">&</syntaxhighlight> separator, a subsequent command is executed even if the previous command indicates an error.<ref>{{#invoke:citation/CS1|citation |CitationClass=web }}</ref> In the following example, each of the three commands is executed, one after the other, and regardless of their result code.

<syntaxhighlight lang="doscon"> >CommandA & CommandB & CommandC </syntaxhighlight>

With the <syntaxhighlight lang="text" class="" style="" inline="1">&&</syntaxhighlight> separator, a command must complete successfully for the subsequent command to execute. In the following example, <syntaxhighlight lang="text" class="" style="" inline="1">CommandB</syntaxhighlight> only executes if <syntaxhighlight lang="text" class="" style="" inline="1">CommandA</syntaxhighlight> completes successfully, and <syntaxhighlight lang="text" class="" style="" inline="1">CommandC</syntaxhighlight> only executes if <syntaxhighlight lang="text" class="" style="" inline="1">CommandB</syntaxhighlight> also completes successfully.

<syntaxhighlight lang="doscon"> >CommandA && CommandB && CommandC </syntaxhighlight>

Command line limit

The shell limits the length of a command line which includes entered text, individual environment variables that are inherited by other processes, and all environment variable expansions<ref>Command prompt (Cmd.exe) command-line string limitation</ref> On Windows XP and later, the maximum length is 8191 (2¹³-1) characters. On earlier versions, such as Windows 2000 or Windows NT 4.0, the maximum length is 2047 (2¹¹-1) characters.

Escaping special characters

The shell reserves the following characters as special:<ref name="docs.microsoft.com"/> &<>[]{}^=;!'+,`~ and whitespace. In some cases, an argument that contains such characters must be enclosed in double quotes to escape from the special character handling. For example:

<syntaxhighlight lang="doscon">>echo me & you me 'you' is not recognized as an internal or external command, operable program or batch file.

>echo "me & you" "me & you" </syntaxhighlight>

Internal commands

The following sections list internal commands for implementations of the shell on various operating systems.

OS/2

File:Microsoft OS 2 Version 1.3 cmd.exe OS 2 Window 640x373.png

Template:Mono running in OS/2 Window on OS/2 version 1.3

Internal commands in OS/2:<ref>Template:Cite book</ref>

• break
• chcp
• cd
• chdir
• cls
• copy
• date
• del
• detach
• dir
• dpath
• echo
• erase
• exit
• for
• goto
• if
• md
• mkdir
• path
• pause
• prompt
• rd
• rem
• ren
• rename
• rmdir
• set
• shift
• start
• time
• type
• ver
• verify
• vol

Windows NT family

File:Windows11Terminal uk.png

Template:Mono running in Windows Terminal on Ukrainian Windows 11

Internal commands in Windows NT and later:<ref>Template:Cite book</ref>

• assoc
• break
• call
• cd
• chdir
• cls
• color
• copy
• date
• del
• dir
• dpath
• echo
• endlocal
• erase
• exit
• for
• ftype
• goto
• help
• if
• keys
• md
• mkdir
• mklink
• move
• path
• pause
• popd
• prompt
• pushd
• rd
• rem
• ren
• rename
• rmdir
• set
• setlocal
• shift
• start
• time
• title
• type
• ver
• verify
• vol

Windows CE

File:Microsoft Windows CE Version 3.0 (Build 126) cmd.exe Command Prompt 800x574.png

Pocket CMD v 3.0 (cmd.exe) on Windows CE 3.0

Internal commands in Windows CE .NET 4.2,<ref>{{#invoke:citation/CS1|citation |CitationClass=web }}</ref> Windows CE 5.0<ref>{{#invoke:citation/CS1|citation |CitationClass=web }}</ref> and Windows Embedded CE 6.0:<ref>{{#invoke:citation/CS1|citation |CitationClass=web }}</ref>

• attrib
• call
• cd
• chdir
• cls
• copy
• date
• del
• dir
• echo
• erase
• exit
• goto
• help
• if
• md
• mkdir
• move
• path
• pause
• prompt
• pwd
• rd
• rem
• ren
• rename
• rmdir
• set
• shift
• start
• time
• title
• type

The Template:Mono command is available as an external command.

ReactOS

File:ReactOS-0.4.13 cmd.exe Command Prompt 667x434.png

Template:Mono on ReactOS

Internal commands in ReactOS:<ref name="ReactOS">{{#invoke:citation/CS1|citation |CitationClass=web }}</ref>

• ?
• alias
• assoc
• beep
• call
• cd
• chdir
• choice
• cls
• color
• copy
• ctty
• date
• del
• delete
• delay
• dir
• dirs
• echo
• echos
• Template:Not a typo
• Template:Not a typo
• endlocal
• erase
• exit
• for
• free
• goto
• history
• if
• memory
• md
• mkdir
• mklink
• move
• path
• pause
• popd
• prompt
• pushd
• rd
• rmdir
• rem
• ren
• rename
• replace
• screen
• set
• setlocal
• shift
• start
• time
• timer
• title
• type
• ver
• verify
• vol

Comparison with COMMAND.COM

On Windows, Template:Mono provides various user experience enhancments as compared to Template:Mono, including:

• More detailed error reporting for malformed commands than the generic Template:Mono "Bad command or file name". In OS/2, errors are reported in the chosen language of the system, their text being taken from the system message files. The HELP command can then be issued with the error message number to obtain further information.
• Supports using of arrow keys to scroll through command history. With Template:Mono, this functionality was only available in DR DOS; via HISTORY) and later via an external component called Template:Mono.
• Adds rotating command-line completion for file and folder paths, where the user can cycle through results for the prefix using the Template:Keypress, and Template:Keypress for reverse direction.
• Treats the caret character (Template:Mono) as the escape character; the character following it is to be taken literally. There are special characters in Template:Mono and Template:Mono that are meant to alter the behavior of the command line processor. The caret character forces the command line processor to interpret them literally.
• Supports delayed variable expansion with <syntaxhighlight lang="text" class="" style="" inline="1">SETLOCAL EnableDelayedExpansion</syntaxhighlight>, allowing values of variables to be calculated at runtime instead of during parsing of script before execution (Windows 2000 and later), fixing DOS idioms that made using control structures hard and complex.<ref name="Delay"/> The extensions can be disabled, providing a stricter compatibility mode.
• The Template:Mono DELTREE command was merged into the rd command via the <syntaxhighlight lang="text" class="" style="" inline="1">/S</syntaxhighlight> switch.
• <syntaxhighlight lang="text" class="" style="" inline="1">SetLocal</syntaxhighlight> and <syntaxhighlight lang="text" class="" style="" inline="1">EndLocal</syntaxhighlight> commands limit the scope of changes to the environment. Changes made to the command line environment after <syntaxhighlight lang="text" class="" style="" inline="1">SetLocal</syntaxhighlight> are local to the batch file. <syntaxhighlight lang="text" class="" style="" inline="1">EndLocal</syntaxhighlight> restores the previous settings.<ref name="SetLocal"/>
• The <syntaxhighlight lang="text" class="" style="" inline="1">call</syntaxhighlight> command allows subroutines within batch file. The Template:Mono <syntaxhighlight lang="text" class="" style="" inline="1">CALL</syntaxhighlight> command only supports calling external batch files.
• File name parser extensions to the <syntaxhighlight lang="text" class="" style="" inline="1">set</syntaxhighlight> command are comparable with C shell.Template:Explain
• The <syntaxhighlight lang="text" class="" style="" inline="1">set</syntaxhighlight> command can perform expression evaluation.
• An expansion of the for command supports parsing files and arbitrary sets in addition to file names.
• The new pushd and popd commands provide access past navigated paths similar to forward and back buttons in a web browser or File Explorer.
• The conditional <syntaxhighlight lang="text" class="" style="" inline="1">if</syntaxhighlight> command can perform case-insensitive comparisons and numeric equality and inequality comparisons in addition to case-sensitive string comparisons. This was available in DR-DOS, but not in PC DOS or MS-DOS.

See also

• Template:Annotated link
• Template:Annotated link

Further reading

• Template:Cite book
• Template:Cite book

External links

• {{#invoke:citation/CS1|citation

|CitationClass=web }}

• {{#invoke:citation/CS1|citation

|CitationClass=web }}

• {{#invoke:citation/CS1|citation

|CitationClass=web }}

• {{#invoke:citation/CS1|citation

|CitationClass=web }}

• {{#invoke:citation/CS1|citation

|CitationClass=web }}

• Most important CMD commands in Windows - colorconsole.de