Share via


Set

Applies To: Windows Server 2003, Windows Server 2003 R2, Windows Server 2003 with SP1, Windows Server 2003 with SP2

Set

Displays, sets, or removes environment variables. Used without parameters, set displays the current environment settings.

Syntax

set [[/a [Expression]] [/p [Variable**=**]] String]

Parameters
  • /a
    Sets String to a numerical expression that is evaluated.
  • /p
    Sets the value of Variable to a line of input.
  • Variable
    Specifies the variable you want to set or modify.
  • String
    Specifies the string you want to associate with the specified variable.
  • /?
    Displays help at the command prompt.
Remarks
  • Using set at the Recovery Console

    The set command, with different parameters, is available from the Recovery Console.

  • Using special characters

    The characters <, >, |, &, ^ are special command shell characters and must be either preceded by the escape character (^) or enclosed in quotation marks when used in String (that is, "StringContaining&Symbol". If you use quotation marks to enclose a string containing one of the special characters, the quotation marks are set as part of the environment variable value.

  • Using environment variables

    Use environment variables to control the behavior of some batch files and programs and to control the way Windows XP and the MS-DOS subsystem appears and works. The set command is often used in the Autoexec.nt file to set environment variables.

  • Displaying the current environment settings

    When you type the set command alone, the current environment settings are displayed. These settings usually include the COMSPEC and PATH environment variables that are used to help find programs on disk. Two other environment variables used by Windows XP are PROMPT and DIRCMD.

  • Using parameters

    When you specify values for variable and string, the specified variable value is added to the environment and the string is associated with that variable. If the variable already exists in the environment, the new string value replaces the old string value.

    If you specify only a variable and an equal sign (without a string) for the set command, the string value associated with the variable is cleared (as if the variable is not there at all).

  • Using /a

    The following table lists the operators supported for /a in descending order of precedence.

    Operator Operation performed

    < >

    Grouping

    * / % + -

    Arithmetic

    << >>

    Logical shift

    &

    Bitwise AND

    ^

    Bitwise exclusive OR

    |

    Bitwise OR

    = *= /= %= += -= &= ^= |= <<= >>=

    Assignment

    ,

    Expression separator

    If you use logical (&& ||) or modulus (%) operators, enclose the expression string in quotation marks. Any non-numeric strings in the expression are considered environment variable names whose values are converted to numbers before being processed. If you specify an environment variable name that is not defined in the current environment, a value of zero is allotted, which allows you to do arithmetic with environment variable values without using the % to retrieve a value.

    If you run set /a from the command line outside of a command script, it displays the final value of the expression.

    Numeric values are decimal numbers unless prefixed by 0× for hexadecimal numbers or 0 for octal numbers. Therefore, 0×12 is the same as 18 is the same as 022. The octal notation can be confusing. For example, 08 and 09 are not valid numbers because 8 and 9 are not valid octal digits.

  • Using /p

    You are not required to include a prompt string.

  • Supporting delayed environment variable expansion

    Delayed environment variable expansion support has been added. This support is disabled by default, but you can enable or disable it by using cmd /v.

  • Working with command extensions

    When command extensions are enabled (that is, the default) and you run set alone, it displays all current environment variables. If you run set with a value, it displays the variables that match that value.

  • Using set in batch files

    When creating batch files, you can use set to create variables and use them in the same way that you would the numbered variables %0 through %9. You can also use the variables %0 through %9 as input for set.

  • Calling a set variable from a batch file

    When you call a variable value from a batch file, enclose the value with percent signs (%). For example, if your batch program creates an environment variable named BAUD, you can use the string associated with BAUD as a replaceable parameter by typing %baud% at the command line.

Examples

To set an environment variable named TEST^1, type:

set testVar=test^^1

To set an environment variable named TEST&1, type:

set testVar=test^&1

Set sets the variable value as everything following the equals sign (=). If you type:

set testVar="test^1"

You get the following result:

testVar="test^1"

To set an environment variable named INCLUDE so that the string C:\Inc (the \Inc directory on drive C) is associated with it, type:

set include=c:\inc

You can then use the string C:\Inc in batch files by enclosing the name INCLUDE with percent signs (%). For example, you might include the following command in a batch file so that you can display the contents of the directory associated with the INCLUDE environment variable:

dir %include%

When this command is processed, the string C:\Inc replaces %include%.

You can also use set in a batch program that adds a new directory to the PATH environment variable. For example:

@echo off

rem ADDPATH.BAT adds a new directory

rem to the path environment variable.

set path=%1;%path%

set

When command extensions are enabled (that is, the default) and you run set with a value, it displays the variables that match that value. For example, if you type setp at the command prompt, you get the following results:

Path=C:\WINNT\system32;C:\WINNT;C:\WINNT\System32\Wbem

PATHEXT=.COM;.EXE;.BAT;.CMD;.VBS;.VBE;.JS;.JSE;.WSF;.WSH

PROCESSOR_ARCHITECTURE=x86PROCESSOR_IDENTIFIER=x86

Family 6 Model 8 Stepping 1, GenuineIntel

PROCESSOR_LEVEL=6PROCESSOR_REVISION=0801

ProgramFiles=C:\Program Files

PROMPT=$P$G

Formatting legend

Format Meaning

Italic

Information that the user must supply

Bold

Elements that the user must type exactly as shown

Ellipsis (...)

Parameter that can be repeated several times in a command line

Between brackets ([])

Optional items

Between braces ({}); choices separated by pipe (|). Example: {even|odd}

Set of choices from which the user must choose only one

Courier font

Code or program output

See Also

Concepts

Command-line reference A-Z
Command shell overview
Cmd