/AutoHotkey.docset/Contents/Resources/Documents/commands/RunAs.htm

https://gitlab.com/ahkscript/Autohotkey.docset · HTML · 44 lines · 36 code · 8 blank · 0 comment · 0 complexity · ab35af79e057e4d6eb852371153cba64 MD5 · raw file 

    

  1. <!DOCTYPE HTML>
    2. 

  2. <html>
    3. 

  3. <head>
    4. 

  4. <title>RunAs</title>
    5. 

  5. <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
    6. 

  6. <meta http-equiv="X-UA-Compatible" content="IE=edge">
    7. 

  7. <link href="../static/theme.css" rel="stylesheet" type="text/css" />
    8. 

  8. <script src="../static/content.js" type="text/javascript"></script>
    9. 

  9. </head>
    10. 

  10. <body>
    11. 

  11. 

  12. <h1>RunAs</h1>
    13. 

  13. 

  14. <p>Specifies a set of user credentials to use for all subsequent uses of <a href="Run.htm">Run</a> and <a href="Run.htm">RunWait</a>.</p>
    15. 

  15. 

  16. <pre class="Syntax">RunAs [, User, Password, Domain]</pre>
    17. 

  17. <h3>Parameters</h3>
    18. 

  18. <dl>
    19. 

  19. 

  20.   <dt>User</dt>
    21. 

  21.   <dd><p>If this and the other parameters are all omitted, the RunAs feature will be turned off, which restores <a href="Run.htm">Run</a> and <a href="Run.htm">RunWait</a> to their default behavior. Otherwise, this is the username under which new processes will be created.</p></dd>
    22. 

  22. 

  23.   <dt>Password</dt>
    24. 

  24.   <dd><p><em>User</em>'s password.</p></dd>
    25. 

    26. 

  26.   <dt>Domain</dt>
    27. 

  27.   <dd><p><em>User</em>'s domain. To use a local account, leave this blank. If that fails to work, try using @YourComputerName.</p>
    28. 

  28.     </dd>
    29. 

  29. 

  30. </dl>
    31. 

  31. <h3>Remarks</h3>
    32. 

  32. <p>This command does nothing other than notify AutoHotkey to use (or not use) alternate user credentials for all subsequent uses of <a href="Run.htm">Run</a> and <a href="Run.htm">RunWait</a>.</p>
    33. 

  33. <p><a href="../misc/ErrorLevel.htm">ErrorLevel</a> is not changed by this command. If an invalid <em>User</em>, <em>Password</em>, or <em>Domain</em> is specified, <a href="Run.htm">Run</a> and <a href="Run.htm">RunWait</a> will display an error message explaining the problem (unless their <a href="Run.htm#UseErrorLevel">UseErrorLevel option</a> is in effect).</p>
    34. 

  34. <p>While the RunAs feature is in effect, <a href="Run.htm">Run</a> and <a href="Run.htm">RunWait</a> will not able to launch documents, URLs, or system verbs. In other words, the file to be launched must be an executable file.</p>
    35. 

  35. <p>The &quot;Secondary Logon&quot; service must be set to manual or automatic for this command to work (the OS should automatically start it upon demand if set to manual).</p>
    36. 

  36. <h3>Related</h3>
    37. 

  37. <p><a href="Run.htm">Run</a>, <a href="Run.htm">RunWait</a></p>
    38. 

  38. <h3>Example</h3>
    39. 

  39. <pre class="NoIndent">RunAs, Administrator, MyPassword
    40. 

  40. Run, RegEdit.exe
    41. 

  41. RunAs  <em>; Reset to normal behavior.</em></pre>
    42. 

  42. 

  43. </body>
    44. 

  44. </html>
    45.