To run superUser from a script (batch file) and wait for the child process to
finish before continuing, use the /w option.
superUser returns the exit code of the completed process, unless it fails itself. In this case, it returns a code from -1000001 to -1000005 instead of the normal code from 1 to 5.
By default, the child process is executed in a new console (window). If you additionally specify the
/s option, it shares the console of the parent. In other words, it doesn't open
another window. This is useful for running commands or small scripts.
So the /ws options allow you to run a process in a completely transparent way:
- The new process runs in the same window and performs its inputs and outputs there.
- The exit code of the new process is returned and you can retrieve it with the errorlevel variable.
If you prefer to open a new window but minimize it (temporarily or not), use the /m option.
You can make the window visible later in the script.
A script calling superUser must always be run as administrator.
This example returns the exit code of the child process (or the superUser error code if it fails):
superUser64 /w child_process.exe
echo Exit code is: %errorlevel%
As above, but the child process uses the current console:
superUser64 /ws child_process.exe
echo Exit code is: %errorlevel%
This example starts a script in a minimized window and restores the window size five seconds later:
superUser64 /wm my_script.cmd
my_script.cmd:
@echo off
echo Waiting...
timeout /t 5 >nul
echo Restore the window size
powershell -window normal -command ""
pause
exit