CINXE.COM

<!doctype html><html lang="en"> <head><meta charset="UTF-8"> <meta name="viewport" content="width=768, initial-scale=1"> <link rel="stylesheet" href="../main.css" type="text/css"> <link rel="icon" href="/favicon.ico" sizes="48x48"> <link rel="icon" href="/favicon.svg" sizes="any" type="image/svg+xml"> <title>Set - Environment Variable - Windows CMD - SS64.com</title> <link rel="canonical" href="https://ss64.com/nt/set.html"> <script async src="/js/q.js"></script> <script async src="/js/content.js"></script> </head><body><div id="tnav"><ul> <li class="tbtn"><a href="../">SS64</a></li> <li class="tbtn"><a href="../nt">CMD <svg viewBox="0 0 13 20.1" width="13" height="13" style="transform: rotate(0deg);"><path d="M0 2.9l7.2 7.2-7.1 7.1L3 20.1l7.1-7.1 2.9-2.9L2.9 0 0 2.9"></path></svg></a></li> <li class="tbtn"><a href="syntax.html">How-to <svg viewBox="0 0 13 20.1" width="13" height="13" style="transform: rotate(0deg);"><path d="M0 2.9l7.2 7.2-7.1 7.1L3 20.1l7.1-7.1 2.9-2.9L2.9 0 0 2.9"></path></svg></a></li> <li><div id="search"><form action="https://www.google.com/search" method="get"> <input type="text" name="q" id="qu" size="27" maxlength="255" aria-label="Search text"> <input class="submit mousetrap" value="Search" id="btn" type="submit"> <input type="hidden" name="sitesearch" value="ss64.com/nt/"><input type="hidden" name="udm" value="14"></form></div></li> </ul></div><h1>SET</h1> Display, set, or remove CMD environment variables. Changes made with SET will remain only for the duration of the current CMD session. <pre>Syntax SET variable SET variable=string SET "variable=string" SET "variable=" SET /A "variable=expression" SET /P variable=[promptString] SET " Key variable A new or existing environment variable name e.g. _num string A text string to assign to the variable. /A Arithmetic expression see full details <a href="#expressions">below</a>. /P Prompt for user input.</pre> Variable names are not case sensitive but the contents can be. It is good practice to avoid using any <a href="syntax-esc.html#delimiters">delimiter</a> characters (spaces, commas etc) in the variable name. Delimiter characters can be used in the value if the complete assignment is surrounded with double quotes to prevent the delimiter being interpreted. Any extra spaces around either the variable name or the string, will not be ignored, SET is not forgiving of extra spaces like many other scripting languages. So use SET alpha=beta, not SET alpha = beta The first character of the name must <a href="syntax-percent.html">not be numeric</a>. It is a common practice to prefix variable names with either an underscore or a dollar sign _variable or $variable, these prefixes are not required but help to prevent any confusion with the standard built-in <a href="syntax-variables.html">Windows Environment variables</a> or any other command strings. SET PATH... the command SET PATH is functionaly identical to the <a href="path.html">PATH</a> command for modifying the user’s PATH variable, see the <a href="path.html">PATH</a> page for more detail. The CMD shell will fail to read an environment variable if it contains more than <a href="https://support.microsoft.com/help/830473/">8,191</a> characters. SET is an <a href="syntax-internal.html">internal</a> command. If <a href="cmd.html">Command Extensions</a> are disabled all SET commands are disabled other than simple assignments like: _variable=MyText <h2>Display a variable:</h2> <blockquote> In most contexts, surround the variable name with %’s and the variable’s value will be used e.g. To display the value of the _department variable with the ECHO command: ECHO %_department% If the variable name is not found in the current environment then SET will set %ERRORLEVEL% to 1 . This can be detected using <a href="if.html">IF</a> ERRORLEVEL ... Including extra characters can be useful to show any white space: ECHO [%_department%] ECHO "%_department%" Type SET without parameters to display all the current environment variables. Type SET with a variable name to display that variable SET _department The SET command invoked with a string (and no equal sign) will display a wildcard list of all matching variables Display variables that begin with 'P': SET p Display variables that begin with an underscore SET _ </blockquote> <h2>Set a variable:</h2> <blockquote> Example of storing a text string: C:\> SET "_dept=Sales and Marketing" C:\> set _ _dept=Sales and Marketing Set a variable that contains a <a href="syntax-redirection.html">redirection</a> character, note the position of the quotes which are not saved: SET "_dept=Sales & Marketing" One variable can be based on another, but this is not dynamic E.g. C:\> set "xx=fish" C:\> set "msg=%xx% chips" C:\> set msg msg=fish chips C:\> set "xx=sausage" C:\> set msg msg=fish chips C:\> set "msg=%xx% chips" C:\> set msg msg=sausage chips Avoid starting variable names with a number, this will avoid the variable being mis-interpreted as a <a href="syntax-args.html">parameter</a> %123_myvar% < > %1 23_myvar To display undocumented system variables: SET " </blockquote> <h2>Values with Spaces - using Double Quotes</h2> <blockquote> There is no hard requirement to add quotation marks even when assigning a value that includes spaces: SET _variable=one two three ECHO %_variable% Adding quotation marks is a best practise and will account for any trailing spaces and special characters like '&'. The variable contents will not include the surrounding quotes: SET "_variable=one & two" ECHO "%_variable%" If you place quotation marks around just the value, then those quotes will be stored: SET _variable="one & two" ECHO %_variable% This can be used for long filenames: SET _QuotedPath="H:\Config files\config 64.xml" COPY %_QuotedPath% C:\Demo\final.xml Alternatively you can add quotes at the point where they are needed: SET "_Filename=config 64.xml" COPY "H:\Config files\%_Filename%" C:\Demo\final.xml </blockquote> <h2>Variable names with spaces</h2> <blockquote> A variable can contain spaces and also the variable name itself can contain spaces, therefore the following assignment: SET _var =MyText will create a variable called "_var " ← note the trailing space. </blockquote> <h2>Prompt for user input</h2> <blockquote> The /P switch allows you to set a variable equal to a line of input entered by the user. The Prompt string is displayed before the user input is read. <pre>@echo off Set /P _ans=Please enter Department: || Set _ans=NothingChosen :: remove &’s and quotes from the answer (via string <a href="syntax-replace.html">replace</a>) Set _ans=%_ans:&=% Set _ans=%_ans:"=% If "%_ans%"=="NothingChosen" goto sub_error If /i "%_ans%"=="finance" goto sub_finance If /i "%_ans%"=="hr" goto sub_hr goto:eof :sub_finance echo You chose the finance dept goto:eof :sub_hr echo You chose the hr dept goto:eof :sub_error echo Nothing was chosen</pre> Both the Prompt string and the answer provided can be left empty. If the user does not enter anything (just presses return) then the variable will be unchanged and the <a href="errorlevel.html">errorlevel</a> will be set to 1. The script above strips out any '&' and " characters but may still break if the string provided contains both. For user provided input, it is a good idea to fully sanitize any input string for potentially problematic characters (unicode/smart quotes etc). The <a href="choice.html">CHOICE</a> command is an alternative for user input, CHOICE accepts only one character/keypress, when selecting from a limited set of options it will be faster to use. </blockquote> <h2>Echo a string with no trailing CR/LF</h2> <blockquote> The standard ECHO command will always add a CR/LF to the end of each string displayed, returning the cursor to the start of the next line. SET /P does not do this, so it can be used to display a string. Feed a NUL character into SET /P like this, so it doesn’t wait for any user input: Set /P _scratch="This is a message to the user " <nul </blockquote> <h2>Place the first line of a file into a variable:</h2> <blockquote> Set /P _MyVar=<MyFilename.txt Echo %_MyVar% The second and any subsequent lines of text in the file will be discarded. In very early versions of CMD, any carriage returns/new lines (CR+LF) before the first line containing text were ignored. </blockquote> <h2>Delete a variable</h2> <blockquote> Type SET with just the variable name and an equals sign: SET _department= Better still, to be sure there is no trailing space after the = place the expression in parentheses or quotes: (SET _department=)   or SET "_department=" </blockquote> <h2><a name="expressions" id="expressions"></a>Arithmetic expressions (SET /a)</h2> <blockquote> Placing expressions in "quotes" is optional for simple arithmetic but required for any expression using logical operators or parentheses. A best practice is to use quotes around all SET /A expressions, then they will always be in place when needed. When referring to a variable in your expression, SET /A allows you to omit the %’s so _myvar instead of %_myvar% The expression to be evaluated can include the following operators: For the Modulus operator use (%) on the command line, or in a batch script it must be <a href="syntax-percent.html">doubled up</a> to (%%) as below. This is to distinguish it from a <a href="for.html">FOR</a> parameter. <pre> + Add set /a "_num=_num+5" += Add variable set /a "_num+=5" - Subtract set /a "_num=_num-5" -= Subtract variable set /a "_num-=5" * Multiply set /a "_num=_num*5" *= Multiply variable set /a "_num*=5" / Divide set /a "_num=_num/5" /= Divide variable set /a "_num/=5" %% <a href="https://en.wikipedia.org/wiki/Modular_arithmetic">Modulus</a> set /a "_num=17%%5" %%= Modulus set /a "_num%%=5" ! Logical negation 0 (FALSE) ⇨ 1 (TRUE) and any non-zero value (TRUE) ⇨ 0 (FALSE) ~ Bitwise invert & AND set /a "_num=5&3" 0101 <a href="https://www.guru99.com/c-bitwise-operators.html">AND</a> 0011 = 0001 (decimal 1) &= AND variable set /a "_num&=3" | OR set /a "_num=5|3" 0101 <a href="https://www.guru99.com/c-bitwise-operators.html">OR</a> 0011 = 0111 (decimal 7) |= OR variable set /a "_num|=3" ^ XOR set /a "_num=5^3" 0101 <a href="https://www.guru99.com/c-bitwise-operators.html">XOR</a> 0011 = 0110 (decimal 6) ^= XOR variable set /a "_num=^3" << Left <a href="https://www.bbc.co.uk/bitesize/guides/z6qqmsg/revision/4">Shift</a>. (sign bit ⇨ 0) An arithmetic shift. >> Right <a href="https://www.bbc.co.uk/bitesize/guides/z6qqmsg/revision/4">Shift</a>. (Fills in the sign bit such that a negative number always remains negative.) Neither ShiftRight nor ShiftLeft will detect overflow. <<= Left Shift variable set /a "_num<<=2" >>= Right Shift variable set /a "_num>>=2" ( ) Parenthesis group expressions set /a "_num=(2+3)*5" , Commas separate expressions set /a "_num=2,_result=_num*5" </pre> Any SET /A calculation that returns a fractional result will be rounded down to the nearest whole integer. Floating point arithmetic is not supported but you can call <a href="../ps/powershell.html">PowerShell</a> for that: powershell.exe 12.9999999 + 2105001.01 or in a batch file: For /F %%G in ('powershell.exe 12.9999999 + 2105001.01') do Echo Result: %%G If a variable name is specified as part of the expression, but is not defined in the current environment, then SET /a will use a value of 0. SET /A arithmetic shift operators do not detect overflow which can cause problems for any non-trivial math, e.g. the bitwise invert often incorrectly reverses the + / - sign of the result. See <a href="#expressions">SET /a examples</a> below and <a href="../forum/set.html">this forum thread</a> for more. also see <a href="setx.html">SetX</a>, <a href="syntax-replace.html">VarSearch</a> and <a href="syntax-substring.html">VarSubstring</a> for more on variable manipulation. SET /A should work within the full range of 32 bit signed integer numbers (-2,147,483,648 through 2,147,483,647) but in practice for negative integers it will not go below -2,147,483,647 because the correct two’s complement result 2,147,483,648 would cause a positive overflow. <h3><a id="e" tabindex="-1"></a>Examples</h3> SET /A "_result=2+4" (=6) SET /A "_result=5" (=5) SET /A "_result+=5" (=10) SET /A "_result=2<<3" (=16) { 2 Lsh 3 = binary 10 Lsh 3 = binary 10000 = decimal 16 } SET /A "_result=5%%2" (=1) { 5/2 = 2 + 2 remainder 1 = 1 } SET /A "_var1=_var2=_var3=10" (sets 3 variables to the same value - undocumented syntax.) SET /A will treat any character string in the expression as an environment variable name. This allows you to do arithmetic with environment variables without having to type any % signs to get the values. SET /A "_result=5 + _MyVar" Multiple calculations can be performed in one line, by separating each calculation with commas, for example: Set "_year=1999" Set /a "_century=_year/100, _next=_century+1" The numbers must all be within the range of 32 bit signed integer numbers (-2,147,483,648 through 2,147,483,647) to handle larger numbers use <a href="/ps/">PowerShell</a> or <a href="/vb/">VBScript</a>. You can also store a math expression in a variable and substitute in different values, rather like a <a href="syntax-macros.html">macro</a>. SET "_math=(#+6)*5" SET /A _result="%_math:#=4% Echo %_result% SET /A _result="%_math:#=10% Echo %_result% </blockquote> <h2>Leading Zero will specify Octal</h2> <blockquote> Numeric values are decimal numbers, unless prefixed by 0x for hexadecimal numbers, 0 for octal numbers. So 0x10 = 020 = 16 decimal The octal notation can be confusing - all numeric values that start with zeros are treated as octal but 08 and 09 are not valid octal digits. For example SET /a "_month=07" will return the value 7, but SET /a "_month=09" will return an error. </blockquote> <h2>Permanent changes</h2> <blockquote> Changes made using the SET command are NOT permanent, they apply to the current CMD prompt only and remain only until the CMD window is closed. To permanently change a variable at the command line use <a href="setx.html">SetX</a> or with the GUI: Control Panel ➞ System ➞ Environment ➞ System/User Variables Changing a variable permanently with SetX will not affect any CMD prompt that is already open. Only new CMD prompts will get the new setting. You can of course use SetX in conjunction with SET to change both at the same time: Set _Library=T:\Library\ SetX _Library T:\Library\ /m </blockquote> <h2>Change the environment for other sessions</h2> <blockquote> Neither SET nor SetX will affect other CMD sessions that are already running on the machine. This as a good thing, particularly on multi-user machines, your scripts won’t have to contend with a dynamically changing environment while they are running. It is possible to add permanent environment variables to the registry (HKCU\Environment), but this is an undocumented (and likely unsupported) technique and still it will not take effect until the users next login. System environment variables can be found in the registry here: HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment </blockquote> <h2>CALL SET</h2> <blockquote> The CALL SET syntax will expand any variables passed on the same line, which is useful if you need to set one variable based on the value of another variable. CALL SET can also evaluate a <a href="syntax-substring.html">variable substring</a>, the <a href="call.html">CALL</a> page has more detail on this technique, though in many cases a faster to execute solution is to use Setlocal <a href="delayedexpansion.html">EnableDelayedExpansion</a>. </blockquote> <h2>Autoexec.bat</h2> <blockquote> Any SET statement in c:\autoexec.bat will be parsed at boot time Variables set in this way are not available to 32 bit gui programs - they won’t appear in the control panel. They will appear at the CMD prompt. If autoexec.bat CALLS any secondary batch files, the additional batch files will NOT be parsed at boot. This behaviour can be useful on a dual boot PC. </blockquote> <h2>Errorlevels</h2> <blockquote> When <a href="cmd.html">CMD Command Extensions</a> are enabled (the default): <table> <caption> </caption> <tr> <th>Event</th> <th>Errorlevel</th> </tr> <tr> <td>If the variable was successfully changed.</td> <td><a href="errorlevel.html">Errorlevel</a> = unchanged, </td> </tr> <tr> <td>SET No variable found or invalid name. SET _var=value when _var name starts with "/" and not enclosed in quotes. SET /P Empty response from user.</td> <td class="code">1</td> </tr> <tr> <td>SET /A Unbalanced parentheses</td> <td class="code">1073750988</td> </tr> <tr> <td>SET /A Missing operand</td> <td class="code">1073750989</td> </tr> <tr> <td>SET /A Syntax error</td> <td class="code">1073750990</td> </tr> <tr> <td>SET /A Invalid number</td> <td class="code">1073750991</td> </tr> <tr> <td>SET /A Number larger than 32-bits</td> <td class="code">1073750992</td> </tr> <tr> <td>SET /A Division by zero</td> <td class="code">1073750993</td> </tr> </table> If the Errorlevel is unchanged, typically it will be 0 but if a previous command set an errorlevel, that will be preserved (this is a bug). </blockquote> # I got my mind set on you # I got my mind set on you... - Rudy Clark (<a href="https://www.youtube.com/watch?v=k68Fob0QA_k">James Ray</a>/<a href="https://www.youtube.com/watch?v=_71w4UA2Oxo">George Harrison</a>) <h3>Related commands</h3> <a href="syntax-substring.html">Syntax - VarSubstring</a> Extract part of a variable (substring). <a href="syntax-replace.html">Syntax - VarSearch</a> Search & replace part of a variable. <a href="syntax-variables.html">Syntax - Environment Variables</a> - List of default variables. <a href="call.html">CALL</a> - Evaluate environment variables. <a href="choice.html">CHOICE</a> - Accept keyboard input to a batch file. <a href="endlocal.html">ENDLOCAL</a> - End localisation of environment changes, use to return values. <a href="exit.html">EXIT</a> - Set a specific ERRORLEVEL. <a href="path.html">PATH</a> - Display or set a search path for executable files. <a href="reg.html">REG</a> - Read or Set Registry values. <a href="setlocal.html">SETLOCAL</a> - Begin localisation of environment variable changes. <a href="setx.html">SETX</a> - Set an environment variable permanently. <a href="syntax-args.html">Parameters</a> - get a full or partial pathname from a command line variable. <a href="https://stackoverflow.com/questions/6379619/explain-how-dos-batch-newline-variable-hack-works">StackOverflow</a> - Storing a Newline in a variable. Equivalent PowerShell: <a href="../ps/set-variable.html">Set-Variable</a> - Set a variable and a value (set/sv). Equivalent PowerShell: <a href="../ps/read-host.html">Read-Host</a> - Prompt for user input. Equivalent bash command (Linux): <a href="../bash/env.html">env</a> - Display, set, or remove environment variables. <div id="27677x300x250x4627x_ADSLOT1" clickTrack="%%CLICK_URL_ESC%%"></div> <script async src="https://served-by.pixfuture.com/www/delivery/headerbid.js" slotId="27677x300x250x4627x_ADSLOT1" refreshTime="5" refreshInterval="120"></script> <hr> <div id=bl> </div> <div id=br>Copyright © 1999-2025 <a href="https://ss64.com/">SS64.com</a> Some rights reserved</div></body> </html>