Detailed Explanation of PECMD in WinPE—- PECMD.INI File Configuration (2)

[IFEX]
Format : IFEX < condition >, [ Command 1 ] [ ! Command 2 ]
Function: According to whether the conditional expression is established, execute command 1 if it is established, while execute command 2 if it is not.
Parameters:
■ Condition: judgment for [ available memory ], [ disk free space ], [ key ], [ numeric variable ] or [ file directory ]
■ Available memory: MEM < comparison operators > value
■ Disk free space: R: \ < comparison operator > value. “R:” represents the drive letter .
■ Key: KEY < comparison operator > value
■ File directory: file directory name. Wildcards can be used.
■ Numeric variable: $%numeric variable name%< comparison operator > numerical value or numeric variable name. The numeric variable is a variable set by CALC or ENVI assignment.
■Comparison operators: The comparison operators include “<” , “>” and “=” which respectively represents ” less than” , “greater than ” and ” equal “.
■ Numerical value: values for comparison. The unit of disk and memory is MB. And the key value is the key code.
Example:
◆ IFEX KEY = 17, TEAM TEXT search fonts | FONT \ WINDOWS! TEAM TEXT install fonts | FONT% CurDrv% \ external program \ FONT
◆ IFEX C: \ Windows,! MESS directory C: \ Windows not exist, \ n please click [ OK ] . @ directory check # OK
Remarks :
※ This command is very powerful and complex. It can be used by nesting IFEX or FIND, to judge multiple conditions. The function of FIND is similar to this command’s.
※ The ” , ” after < conditional expression> can be replaced by ” * “.
※ When this command is nesting IFEX or FIND command, the nested command can not use the ” ! ” separator.
※ When the IFEX command is used to detect keys, if user presses keys of ‘A’ ~ ‘Z’ or ‘0 ‘ ~ ‘9 ‘, the key result will be stored in the %PressKey%.
※ When the command is used to judge the variables, all variables should be processed according to double data type. ( Up to four decimal places can be reserved.)

[IMAG]
Format : IMAG < picture box name >, [ picture box shape ], [ image filename ]
Function: Establish a picture box in a window defined by _SUB command.
Parameters:
■ Picture box name : string. The picture box name should be unique, and can not be same as other controls names or environment variables names.
■ Picture box shape: Picture box’s size and location. Its format is <LTWH>, in which L stands for Left, T for Top, W for Width, H for Hight. And all of them are numerical values.
■ Image file name: Image files ( all image files supported by Windows) will be displayed in the specified picture boxes.
Example:
◆ IMAG Image1, L8T380W140H70,%CurDir% \ logo.gif
Remarks :
※ IMAG command must be located between _SUB command and _END command. IMAG command placed at any other locations is invalid. Please refer to descriptions of  _SUB and CALL commands.
※ Because PECMD.EXE is script interpreter, so it is not recommended to load the large size image file. Otherwise, the display will be slow.

[INIT]
Format : INIT [C] [I] [K] [U]
Function: Perform basic initialization, register Windows shell, initialize user folders and environment variables, install the keyboard hook, and create the following directories:
Favorites, Programs, Desktop, SendTo, StartMenu, Personal, Startup, QuickLaunch
Parameters:
■ Parameter “C” indicates writing the drive letter into environment variable; parameter “I” means installing some functions of PECMD in the tray icon menu.
■ Parameter “K” indicates executing INIT command to immediately install low-level keyboard hook. Otherwise, install low-level keyboard hook after loading SHELL.
■ Parameter “U” means writing the USB letter into environment variable. (The function is not perfect.)
Example:
◆ INIT
◆ INIT C
◆ INIT CH
◆ INIT CIK
◆ INIT CIKU
Remarks :
※ After executing INIT command, perform the SHEL to load the specified SHELL. Then a minimized WinPE can be booted.
※ Make sure that there is writable space in the partition where %USERPROFILE% is before executing INIT command. Otherwise, INIT command can not complete the work.
※ With parameter “C”, the drive letter is stored in the environment variables starting with CDROM. (These environment variables will take effect after restarting and refreshing.)
※ Parameter “K” indicates instantly installing the keyboard hook, taking charge of Ctrl + Alt + Del, and calling out Task Manager.
※ With parameter “U”, USB drive letter is stored in the environment variables starting with USB. (These environment variables will take effect after restarting and refreshing.)
※ The public offering WinPE INIT command is not recommended to have “K” parameter. This command can not be used in the command line. It can only be used in the configuration file.

[ITEM]
Format : ITEM < button name >, < button shape >, [ button title ], [ button event ], [ button icon ], [ button state ]
Function: Establish a button in a window defined by _SUB command.
Parameters:
■ Button name: string. The button name should be unique, and can not be the same as other controls names or environment variables names.
■ Button shape: button’s location and size. Its format is <LTWH>, in which L stands for Left, T for Top, W for Width, H for Hight. And all of them are numerical values.
■ Button title: text on the button, used for describing the button’s function or executing command.
■ Button event: the command executed by clicking the button. It must be a valid command supported by PECMD.
■ Button icon: the icon displayed on the button. Its format is < icon file name # ID>, icon size = button height – 6.
■ Button state: number. If the default value is 0, it indicates that the button is available button; if the value is non-zero, it means that the button is gray unavailable button.
Example:
◆ ITEM Button3, L32T108W300H54, resource manager, EXEC explorer.exe, %SystemRoot% \ explorer.exe
Remarks :
※ ITEM command must be located between _SUB command and _END command. ITEM command placed at any other locations is invalid. Please refer to the illustrations of  _SUB and CALL commands. http://www.dabaicai.com/
※ To set the text on the button, you can use “ENVI @ button name = button text “. Please make reference to the explanation of ENVI command.
※ Use “ENVI @ button name. Enable = value ” to set the edit box’s available state. 0 stands for unavailable state, while non-zero value represents available state.

[KILL]
Format : KILL [[<\> window title ] | [ process name ] ]
Function: Close the window of specified title or forcefully terminate specified process
Parameters:
■ The leading character ” \ ” indicates closing the window of specified title. If the window title is omitted, the window defined by _SUB command will be closed.
■ Omitting the leading character ” \ ” indicates ending the process of the specified name (EXE filename, no path). If the process name is omitted, the PECMD’s parent process will be terminated.
Example:
◆ KILL WinLogon.EXE
◆ KILL \ Calculator
Remarks :
※ Process name without window title should be ended up with process name.
※ When ending the process, all processes matching with the process name will be terminated.

[LABE]
Format : LABE < text label name >, < text label shape >, [ text label content ]
Function: Establish a static text label in a window defined by _SUB command.
Parameters:
■ Label name : string. Label name should be unique, and can not be same as other controls names or environment variables names.
■ Label shape: label’s location and size. Its format is <LTWH>, in which L stands for Left, T for Top, W for Width, H for Hight. And all of them are numerical values.
■ Label content: string; text displayed by the label, supporting multiple lines display. Use “\ n” between lines.
Example:
◆ LABE Label1, L32T280W128H48, please click the “Open” button to browse the file.
Remarks :
※ LABE must be located between _SUB command and _END command. LABE command placed at any other location is invalid. Please refer to the introductions of  _SUB and CALL commands.
※ To set the text on the label, you can use the “ENVI @label name = label text”. Please make reference to the description of ENVI command.
[LINK]
Format : LINK [!] < shortcut path >, < target path >, [ operating parameters ], [ icon path [ # icon index ] ], [ target remark ], [ initial position ]
Function : Create a shortcut.
Parameters:
■ Shortcut : Specify the path of a shortcut to be generated. The “. LNK” extension name is not needed.
■ Target path: Specify a shortcut’s target file directory (available relative path) . If the target does not exist, it will not create a shortcut.
■ Operating parameters: target program’s operating parameters.
■ Icon path: shortcut icon path.
■ Icon index: the serial number of a shortcut icon in the file resources. 0 stands for the first one, while nothing filled means default.
■ Icon remarks: strings, description for the target program or directory.
■ Initial position: the working directory commanded by the target program.
Example:
◆ LINK!% Desktop% \ broadband connection, RASPPPOE.CMD, RASDIAL.DLL # 19
Remarks :
※ Leading character ” ! ” indicates starting up a program in the minimizing form, and can be used to minimize command windows when executing batch files.

[LIST]
Format : LIST < combo box name >, < combo box shape >, < combo box content >, [ combo box event ], [ default selected entry ]
Function: Establish a combo box in the window defined by _SUB command.
Parameters:
■ Combo box name: string. The combo box name should be exclusive, and can not be same as other controls names or environment variables names.
■ Combo box shape: combo box’s position and size. Its format is <LTWH>, in which L stands for Left, T for Top, W for Width, H for Hight. And all of them are numerical values.
■ Combo box content : entries to be selected in the combo box. Use “|” between the entries.
■ Combo box event: the command to be executed when changes occur in the entries for selection of the combo box. It must be a valid command supported by PECMD.
■ Default selected entries: Initialize the drop-down list box and set the selected entry.
Example:
◆ LIST List1, L200T360W128H32, EXPLORER | XPLORER2 | CMD, ENVI @ Label1 =% List1%, EXPLORER
Remarks :
※ LIST command must be located between _SUB command and _END command. LIST command placed at any other location is invalid. Please refer to the descriptions of  _SUB and CALL commands.
※ The environment variable, % environment variable name%, is the selected entry ( string ) in the combo box.
※ Use “ENVI @combo box name. Enable = numerical value ” to set the edit box’s available state. 0 means unavailable state, while non-zero value represents available state.

[LOAD]
Format : LOAD < file path >
Function: Run the commands in the configuration file in order.
Parameters:
■ Specified file name ( including the path; supporting environment variables)
Example:
◆ LOAD \ external program \ PECMD.INI
Remarks :
※ Each command is in a single line. The main process’s orders is executed sequentially. Incorrect command or an empty line is negligible.
※ It supports text files of ANSI and UNICODE formats. UNICODE format text file is recommended to use.
※ Configuration file supports whole-line comments and after-line comments. It is suggested to use ” ` ” ( the character below the Esc key) as a comment starting.
※ In the configuration file, use the environment variable “%CurDrv%” to indicate the current drive letter.
※ If the first character of the file path is ” \ “, files in the specified directory of all disks will be searched. “LOAD \ MyWinPE \ PECMD.INI” is an example here.
※ The configuration file directory is set as the current directory. Then when creating a shortcut, the shortcut’s target path can use relative path.
※ Regarding to other information, please refer to the illustration of MAIN command.

[LOGO]
Format : LOGO [[# background color ] | [ image file ] ], [ position and size ]
Function : Set or close the login screen.
Parameters:
■ Background color: numerical values. There must be a leading character ” # ” when setting the background color. If the color set is invalid, the default color in the registry will be used.
■ Image files : supporting BMP / JPG / PNG / GIF format, needing the support of GDI+. Only choose one between the background color and the image file.
■ Position and size : LOGO window’s position and size. Its format is <LTWH>, in which L stands for Left, T for Top, W for Width, H for Hight. And all of them are numerical values.
■ If there are no parameters, turn off the splash screen ( fade out ).
Example:
◆ LOGO% SystemRoot% \ LOGON.JPG
◆ LOGO # 0xFF0000, L100T100W300H200
Remarks :
※ This command is executed with non-blocking mode. After finishing this command , the next command will be executed at once.
※ This command can only be used in the configuration file. If it is used in the command line, the program exits immediately, so the result can not be saw.
※ If the “LT” is omitted, the window is centered; If the “WH” is omitted, the window is  full-screen size; If “LTWH” is omitted, the window is a full screen one.
※ Before the end of the configuration file, a “LOGO” command without parameters must be called once so as to close the splash screen.
※ When booting WinPE, it is recommended to use full screen window ( position and size ). The use of a LOGO image requires large LOGO memory.

[LOGS]
Format : LOGS [ file path ] , [ numerical value ]
Function: Enables logs so as to record the executing results of each command, and help users verify the correctness of the configuration file.
Parameters:
■ File path: the log file name, including the path.
■ Numerical value: the memory space (unit is KB) applied for the log file. The more log records are, the more memory space is needed. If it is omitted, the default value, 16K, is applied.
Example:
◆ LOGS% SystemRoot% \ PECMD.LOG
Remarks :
※ Before the end of the configuration file, a “LOGO” command without parameters must be called once so as to close the splash screen. (make sure the log is written in file)
※ This command can not be used in the command line. (It must be used in the configuration file.)
※ It is not recommended to enable log file in public offering WinPE.
[LPOS]
Format : LPOS < variable name > <= > < string >, < characters >, < value >
Function: Return to the specified character’s position where it appears from the left of the ” string”.
Parameters:
■ Variable name: variable name used for saving the command result
■ String: string to be detected. Its length can not exceed 2K.
■ Characters: characters to be detected. They are not case-insensitive.
■ Value: Specify the detected characters’ appearance number.
Example:
◆ LPOS iPos = 123A56 | 1234A6 | abcdef, a, 2
◆ LPOS iPos = 123A56 | 1234A6 | abcdef, a, 3
Remarks :
※ When the “value” is less than 1, it is returned to the rightmost detected character’s position. For instance, the result of the above example is 15. If the return result is 0, it means “not found”.
※ This command is processed according to Unicode string. The return value of example 1 is 12, and that of example 2 is 15. ( Its result is the same as the result when the value is 0.)

[LSTR]
Format : LSTR < variable name > <= > < string >, <number >
Function: Intercept characters of specified number from the left of specified “string”, and return the result to the variable with assigned name.
Parameters:
■ Variable name: variable name used for saving command result
■ String: source string. Its length can not exceed 2K.
■ Number: Specify the number of intercepting characters.
Example:
◆ LSTR aStr = 1234567890,2
◆ LSTR aStr = 1234567890,5
Remarks :
※ When the “value” is less than 1 or exceeds the length of the source string, the result is the entire source string ( equivalent to string copy ).
※ This command is processed according to Unicode strings. The return value of example 1 is “12” and that of example 2 is “12345 “.

[MAIN]
Format : MAIN [ file path ]
Function : Initialize the desktop, take over Ctrl + Alt + Del, and create a new process to execute LOAD function .
Parameters:
■ Specified initialization configuration file path
Example:
◆ MAIN %SystemRoot% \ PECMD \ PECMD.INI
Remarks :
※ After MAIN command creates a LOAD process and executes the LOAD function, it will stay in the memory, install key hook, and mount “ExitWindowsEx” function.
※ PECMD’s stay takes up larger memory. You can use the PECMD’s LAOD function, while the MAIN function is replaced by PELOGON.EXE.
※ After LOAD command completes loading file function, it will automatically exit from the memory. For other information, please make reference to the illustration of the LOAD command.

[MD5C]
Format : MD5C [ file name | $ string ], [ variable name ]
Function: Calculate MD5 check code of file or string, and use it for setting or verifying the MD5 verification of WinPE login password.
Parameters:
■ File name: the full name of the file whose MD5 check code is to be calculated; String: the string whose MD5 check code is to be calculated.
■ The leading character ” $”: It means the thing to be calculated is the string’s MD5. If the first character of the string is “$”, please add another “$” at the beginning of the string.
■ Variable name: variable name used to save the calculated result.
Example:
◆ MD5C% SystemRoot% \ System32 \ UserInit.EXE, UserInitMD5
◆ MD5C $ Lxl1638, PassWordMD5
Remarks :
※ When using MD5C command to calculate string’s MD5 check code, the string’s number of character is limited within 256. ( The character “,” can not be included.)
※ File name can not contain “,” character. The system exclusive file’s MD5 check code is “d41d8cd98f00b204e9800998ecf8427e” or all “0”.
※ The verified string can include Chinese and English letters, and they are case sensitive.
※ If the variable name is given, MD5C command will save the calculation result to the specified variable. Example 2 can be referenced through the environment variable %PassWordMD5%.
※ If the variable name is omitted, MD5C command’s calculation result will be displayed in the message window, and will also be saved to a paste board.

[MEMO]
Format : MEMO < edit box name >, < edit box shape >, [ edit box content ] , [ target file name ], [ edit box type ]
Function: Create a multiple-line text edit box in the window defined by _SUB command. Parameters:
■ Edit box name: string. The edit box name should be unique, and can not be same as other controls names or environment variables names.
■ Edit box shape: edit box’s position and size. Its format is <LTWH>, in which L stands for Left, T for Top, W for Width, H for Hight. And all of them are numerical values.
■ Edit box content: the content filled when initializing the edit box, supporting multiple lines text. Use “\ n” between lines to indicate line break. And the total length must be less than 1K.
■ Target file name : Specified text file name. The content of multiple-line text edit box is loaded by the file.
■ Edit box type: numeric number. Default, omission or 0 means that it is an editable multiple-line text edit box, while non-zero value indicates that it is a read-only one.
Example:
◆ MEMO Memo1, L304T268W280H88,,%CurDir% \ Readme.TXT, 0
Remarks :
※ MEMO command must be located between _SUB command and _END command. MEMO command placed at any other location is invalid. Please refer to the introductions of  _SUB and CALL commands.
※ If the “edit box content ” is not empty, the ” target file name ” will be ignored. If it is empty, the specified content of ” target file name ” will be loaded. Overlong ” edit box content ” can connect as a new string variable through environment variable assignment, which makes it easy to read in the Notepad.
※ Use “ENVI @edit box name. Enable = numerical value” to set the edit box available state. 0 represents unavailable state, while non-zero value stands for available state.
※ Use “ENVI @edit box name. ReadOnly =numerical value ” to set the edit box read-only status. 0 means non-read-only status, non-zero value represents read-only status.
[MENU]
Format : MENU < menu item name >, [ menu item title ], [ menu item event ], [ menu item state ]
Function: Add a menu in a custom tray icon menu.
Parameters:
■ Menu item name: string. Apart from the separation line, the menu item name should be unique, and can not be same as other controls names or environment variables names. When the menu item name or the first character of the menu item name is ” – “, it indicates separation line. Otherwise, it means normal menu.
■ Menu item title: the text on the menu item, used for describing the function or description of the menu item.
■ Menu item event: The command is executed by clicking the menu item. It must be a valid command supported by PECMD.
■ Menu item status: The default value is 0 which means available state, while non-zero value stands for gray unavailable status.
Example:
◆MENU Menu2, resolution 1024X768 color 32-bit refresh rate 85, DISP W1024H768B32F85
◆ MENU –
Remarks :
※ MENU command must be located between _SUB command and _END command. MENU command placed at any other location is invalid. Please refer to the descriptions of  _SUB and CALL commands.
※ During the period of running, the support to modify the menu item title is temporarily not provided. That is, it can not use environment variable %menu item name% to refer to the menu item title, nor support using “ENVI @ menu item name ” to set or modify the menu item title.
※ The icon of the tray icon menu is decided by the window title defined by the _SUB command. If it is omitted, the main icon of PECMD will be applied.
※ Use “ENVI @ menu item name. Enable = numerical value ” to set the edit box available state. 0 means unavailable state, while non-zero value represents available status.

[MESS]
Format : MESS < message window text > < @message window text title > <#message window type > [ * automatic turn off time ( ms ) ] [ $ default option ]
Function: Display a [ Yes / No ] selection message window or display a message window with [ OK ] button.
Parameters:
■ ” Message window text ” supports multiple-line text and the “\ n” should be used between lines to disconnect them. “Message window type ” currently supports “YN” and “OK” types.
■ When the auto-off time is set as 0 or not set, the message window does not close automatically. The default option is represented by Y or N, such as $ Y or $ N.
Example:
◆ MESS find insufficient physical memory, \ n whether to set virtual memory? @ set virtual memory # YN * 10000 $ N
Remarks :
※ Users’ selection result of “YN” type message window is stored in the environment variable %YESNO%. When[ YES ] is selected, the value of the environment variable % YESNO% is YES; when the window is closed because of timeout or [ No ] is selected, the value of the environment variable % YESNO% is NO. IFEX or FIND command can be used to judge the environment variable value.
※ When “YN” type message window omits the default choice parameters, the return value of auto-off is NO.
※ The “OK” type message window does not have return value. It only display the prompt message to users.

[MOUN]
Format : MOUN [!] [Wim file name ] , <Mount target directory> , [ image ID ], [WimFltr temporary working directory ]
Function: Mount certain image of WIM file to specified directory or remove the mounted image file.
Parameters:
■ Wim file name: Microsoft Windows Imaging Format (WIM) image format file.
■ Mount target directory: the directory which a WIM image file is mounted to.
■ Wim file image ID: the image ID in Wim file, represented by numerical value. When the mount image is read-only or the image ID is 1, it can be omitted.
■ WimFltr temporary directory: During the process of setting WimFltr temporary working directory, if it indicates mounting by RW way, this directory is recommended to set to hard disk.
Example:
◆ MOUN% CurDrv% \ external program \ PROGRAMS.WIM,% ProgramFiles%, 1
Remarks :
※ File directory name supports environment variables explanation. When using FBWF command, it must be used after MOUN command.
※ If ” \ ” is at the beginning of the file name, it means searching specified directory files of all partitions (including hidden partitions). e.g.: MOUN \ MyPE \ OP.WIM,% PF%, 1
※ The leading character ” ! ” indicates that after successfully mounting WIM in a hidden partition, a drive letter should be given to the hidden partition. e.g.: MOUN! \ MyPE \ OP.WIM,% PF%, 1
※ Omitting Wim file name means unmounting the image. If the image ID is non-zero value, it indicates saving the changes when unmounting the image. If the image ID is 0, it means not saving the changes.

[MSTR]
Format : MSTR < variable name > <=> < string >, <location >, <length>
Function: Intercept the characters of specified length from the starting position of assigned “string” and return the result to the specified variable.
Parameters:
■ Variable name: variable name used for saving command result.
■ String: source string. Its length can not exceed 2K.
■ Location: numerical value. Specify the starting position of the source string.
■ Length: numeric value, specifying the length of interception.
Example:
◆ MSTR aStr = 1234567890,2,4
◆ MSTR aStr = 1234567890,5,7
Remarks :
※ When the “position” value is less than 1, it is processed as 1. When the ” length” value is less than 1 or exceeds the length of the source string, return all characters after the starting position.
※ This command is processed according to Unicode string. The return value of example 1 is “2345”, and that of example 2 is “567890”.

[NAME]
Format : NAME < variable name > <= > < file name >
Function : Return the base name ( without directory and extension ) of the specified file name.
Parameters:
■ Variable name: variable name used for saving command return value.
■ File name: detected legal file name
Example:
◆ NAME aFileName = C: \ WINDOWS \ NOTEPAD.EXE
◆ NAME aName =% CurDir% \ Path1 \ Path2 \ FileName
Remarks :
※ When the specified file name is the partition’s root directory, the command’s returns result is a null value.
※ The return result of example 1 is “NOTEPAD”, and that of example 2 is “FileName”.
[NUMK]
Format : NUMK <numerical value>
Function: Control the switching state of the small numeric keypad.
Parameters:
■ When the value is 0, the state is off; When it is non-zero value, the status is open.
Example:
◆ NUMK 1
Remarks :
※ The original SEND command can achieve the same function, but it is not very accurate. When NUMK is on, it will turn off by sending a button again.

[PAGE]
Format : PAGE < page file path > < initial size > [ Max ]
Function : Set the page file ( virtual memory ).
Parameters:
■ Specified path to the page file: It can only use path of DOS 8.3 format, such as “C: \ PageFile.sys”.
■ The unit of initial size and maximum value is MB. When the max is omitted, it will automatically set “max = initial size”.
Example:
◆ PAGE C: \ PAGEFILE.SYS 128 256
Remarks :
※ If the page file is set, the partition is not able to perform operations such as formatting and other operations.
※ When available memory is larger than initial size, the command will not set the page file. That is, defining the initial size can be a setting condition of page file.
※ This command has intelligent function. In other words, it will start searching from the partition where the page file name ( including the drive letter ) you defined is for eligible    ( hard drives and capacity ) partition to set the page file, avoiding slow U-disk and removable hard disk. When booting with U disk or removable hard disk, the page file defined by the configuration file may be in the U disk or removable hard disk. Only after searching and qualified hard disk partition for setting page file cannot be found, can you use U disk or removable hard disk to set the page file.
[PATH]
Format : PATH [@] [#] [ directory name ]
Function: Operate directory, set the current working directory of PECMD.EXE, create a directory, or delete directory.
Parameters:
■ Directory name (Containing environment variable is supported.)
Example:
◆ PATH @% CurDrv% \ external program or PATH %TEMP%
Remarks :
※ The leading character “@” indicates setting the current working directory of PECMD.EXE, facilitating EXEC, DEVI and other commands to use relative paths so as to shorten the length of command line.
※ The leading character “#” means deleting directory. Please note that this operation can also delete a homonymous file.
※ When the leading characters “@” and “#” are omitted, PATH is used to create a directory. ( It is able to build multi-level directory. )
※ It must be careful to use PATH command with the leading character “@” in the configuration file so as to avoid causing confusion.
※ When the parameter is empty, the PECMD.EXE defaulted current directory (%SystemRoot% \ SYSTEM32) will be restored.

[PBAR]
Format : PBAR < progress bar name >, < progress bar shape >, [ progress bar schedule]
Function: Build a progress bar in the window defined by _SUB command.
Parameters:
■ Progress bar name: string. The progress bar name should be unique, and can not be same as other controls names or environment variables names.
■ Progress bar shape: progress bar’s position and size. Its format is <LTWH>, in which L stands for Left, T for Top, W for Width, H for Hight. And all of them are numerical values.
■ Progress bar schedule: Value ( 1 to 100 ), initializing the schedule percentage of the progress bar. The default value is 0.
Example:
◆ PBAR Pbar1, L360T11W428H16, 0
Remarks :
※ PBAR command must be located between _SUB command and _END command. PBAR command placed at any other location is invalid. Please refer to the descriptions of  _SUB and CALL commands.
※ To set the progress bar schedule, you can use “ENVI @ progress bar name = numerical value”. Please make reference to the description of ENVI command. When the set value is less than 0, the progress bar will be hidden. The value greater than 100 will be ignored .

[RADI]
Format : RADI < single marquee name >, < single marquee shape >, [ single marquee title ], [ single marquee event ], [ single marquee state ], [ single marquee group ID]
Function: Establish a single marquee control in the window defined by _SUB command.
Parameters:
■ Single marquee name: string. It should be unique, and can not be same as other controls names or environment variables names.
■ Single marquee shape: single marquee’s position and size. It is format is <LTWH>, in which L stands for Left, T for Top, W for Width, H for Hight. And all of them are numerical values.
■ Single marquee title: text on the single marquee, used to describe the single marquee’s function or illustration.
■ Single marquee event: The command is executed by clicking the single marquee. It must be a valid command supported by PECMD command.
■ Single marquee status: numbers. 1 or -1 stands for checked state, 0, 2 or -2 for not checked state, and value less than 0 for gray unavailable state.
■ Single marquee group ID: numeric number. The default value is 0. You can divide multiple single marquees into groups, and select one from many in a group. Meanwhile, groups will not influence each other.
Example:
◆ RADI RadioButton1, L32T314W100H20, uninstall WimShExt.DLL, ENVI @ Group1 =% RadioButton1%, 1,1
Remarks :
※ RADI command must be located between _SUB command and _END command. RADI command placed at any other location is invalid. Please refer to the explanations of  _SUB and CALL commands.
※ To set a single marquee title, use “ENVI @ single marquee name = single marquee title “. Please refer to the illustration of ENVI command.
※ Use “ENVI @ single marquee name. Check = numeric value” to set the single marquee’s available state. 0 represents non-checked state, while non-zero value stands for checked state.
※ Use “ENVI @single marquee name. Enable = numerical value” to set the single marquee’s available state. 0 means disabled status, while non-zero value indicates available state.

[RAMD]
Format : RAMD [P percentage of available memory ] [L min ] [H max ]
Function : Set the size of RamDisk
Parameters:
■ The unit for maximum value and minimum value is MB.
Example:
◆ RAMD P20 L32 H64
Remarks :
※ The three parameters can be used alone. For example, if RAMD P10 is used, it indicates that 10% of available memory is set as the size of RamDisk.

[REGI]
Format : REGI [ leading character ] <HKLM|HKCU|HKCR|HKU|HKCC> <\ subkey \ > { <key name, variable name > | [[ key name ] [ operator ] [ [ type character ] data value ] ] }
Function: Read, set or delete the registry data.
Parameters:
■ The leading characters ” $”, “#” and “@” respectively denote reading type data of REG_SZ, REG_DWORD, REG_BINARY in the registry. If they are omitted, it means setting and deleting registry data. And the variable name (The default is RegDat.) is used to save the return value.
■ Subkey name: the full name of the registry in the selected ROOTKEY.
■ Key name: the key value name to be operated. If it is omitted, operate the default key. If the operator is ” ! ” and without “=”, it is used to delete the entire subkey.
■ Operator: Operator ” ! ” means deleting the entire subkey; operator “=” and without data indicates deletion; operator “=” and with data denotes setting data.
■ Type character: data type. If it is omitted, the data type is string; if it is “#”, the data type is REG_DWORD data type such as “# 0x20”; if it is “@”, the data type is REG_BINARY data type such as ” @ 233490255 “.
■ Data value: string. A null value is represented by ” “. REG_DWORD REG_BINARY data types support hexadecimal value.
Example:
◆ REGI HKCU \ SOFTWARE \ WinCMD \ Version = # 1200
◆ REGI HKCR \ lnkfile \ IsShortcut = “”
◆ REGI $ HKCU \ Software \ Microsoft \ Windows \ CurrentVersion \ Explorer \ Shell Folders \ Cache, IECache
Remarks :
※ This command is very complex. Please carefully read the notes. Example 3 is to read the location of IE cache.

[RPOS]
Format : RPOS < variable name > <= > < string >, <characters>, <value>
Function: Return to the specified character’s location where it appears from the right of the “string”.
Parameters:
■ Variable name: variable name used for saving command result.
■ String: the string to be detected. Its length can not exceed 2K.
■ Character: the character to be detected. It is not case-insensitive.
■ Value: Specify the detected character’s occurrence number.
Example:
◆ RPOS iPos = 123A56 | 1234A6 | abcdef, a, 2
◆ RPOS iPos = 123A56 | 1234A6 | abcdef, a, 3
Remarks :
※ When the “value” of less than 1, it is returned to the leftmost detected character’s position. For instance, the result of the above example is 4. If the return result is 0, it means “not found”.
※ This command is processed according to Unicode string. The return value of example 1 is 12, and that of example 2 is 4.

[RSTR]
Format : RSTR < variable name > <= > < string >, <numeric value>
Function: Intercept characters of specified number from the right of the appointed string  and return the result to the assigned variable name.
Parameters:
■ Variable name: variable name used to save the command result.
■ String: source string. Its length can not exceed 2K.
■ Numeric value: Specify the number of intercepted characters.
Example:
◆ RSTR aStr = 1234567890,2
◆ RSTR aStr = 1234567890,5
Remarks :
※ When the “value” is less than 1 or exceeds the length of the source string, the return result is the entire source string ( equivalent to string copy ).
※ This command is processed according to Unicode string. The return value of example 1 is “90”, and that of example 2 is ” 67890 “.

[RUNS]
Format : RUNS < program command > <* |,> < starting item name >
Function: Set the starting item of Windows
Parameters:
■ Program command includes EXE, CMD, BAT and other executable commands which can be with parameters. The startup item name is text.
Example:
◆ RUNS PECMD.EXE EXEC!% CurDrv% \ external program \ DRIVER \ STARTDRIVER.CMD, install driver.
Remarks :
※ The original REGI order can achieve the same functionality. But when using REGI command, long text is needed to make this functionality into a command.
※ The separators between program command and startup item name are right “*” and left “|”.  http://www.dabaicai.com/
※ This command can not be used in the command line and it can only be used in the configuration file.

[SEND]
Format : SEND < key code 1 [_ | ^]>, [ key code 2 ], [ key code 3 ] …
Function : Simulate button.
Parameters:
■ Virtual key code: VK_NUMLOCK is an example. Please refer to the relevant programming documentation. If the key code is ended with ” _ “, only simulate key down; “^ ” means only simulate key up. Otherwise, simulate down and up.
Example:
◆ SEND 0x12_, 0x09_, 0x09 ^, 0x12 ^
Remarks :
※ The above example simulates Alt + Tab. Key code supports hexadecimal and decimal.

[SERV]
Format : SERV [!] < service name >
Function : Start or stop service or driver program.
Parameters:
■ Specified service name: The leading character ” ! ” means stopping a service. And without it indicates starting the service.
Example:
◆ SERV FBWF
Remarks :
※ This command is used to start the FBWF service ( if you install it ), which can increase the system disk’s writable space. Then PE can run on the disk.

[SHEL]
Format : SHEL < file name ( including the path ) > [ Password MD5 string ], [ number of retry ]
Function: Load the specified SHELL and lock it.
Parameters:
■ File name: SHELL file name ( including the path; environment variable can be used.).
■ Password: English letters and numbers. The password is case-sensitive and its maximum length is 12 characters.
■ If the password MD5 string is omitted, it will automatically log in. The default number of retry is 3.
Example:
◆ SHEL% SystemRoot% \ EXPLORER.EXE, e10adc3949ba59abbe56e057f20f883e, 5
Remarks :
※ This command’s functionality is similar to EXEC $’s. It can modify in-process shutdown code ( mount “ExitWindowsEx” function ).
※ This command also has the function of locking SHELL. When the SHELL is deleted, it will automatically load SHELL.
※ It is recommended to open LOGO command before opening the SHELL command with a login password .
※ Parameters of TEXT command after SHEL command may need reset.
※ SHEL command must be after HOTK command. Meanwhile, it can not be used in the command line, and can only be used in the configuration file.

[SHOW]
Format : SHOW [ hard disk number | identifier ] [ : partition number ], [ letter ]
Function: Display the hidden partitions of removable hard disks or fixed one in the system, and assign drive letters to the partitions.
Parameters:
■ Hard disk number: the hard disks in the computer. “0” means “hd0”; “1” indicates “hd1”; “2” indicates “hd2”, etc.
■ Identifier: identified used for representing hard disk type. The fixed hard disks are represented by “F”, while the removable hard disks are denoted by “R”. Between identifier or hard disk number, only one of them can be selected.
■ Partition number: “0” indicates all partitions which have not been assigned drive letter. “1” represents the first partition; “2” indicates the second partition; and so on.
■ Drive letter: Drive letter is represented by letter of “C ~ Z” ( without “:” ). If the letter is omitted or the drive letter is set unreasonably, PECMD.EXE will automatically assign drive letters.
Example:
◆ SHOW 0:1, H
◆ SHOW R: 1, U
◆ SHOW F: 0
◆ SHOW
Remarks :
※ Some models can identify removable hard disk after starting WinPE mobile hard disk, but do not assign drive letters to them. So SHOW command’s “R” identifier can be used to allocate letters to removable hard disks. Example 2 means assigning drive letter ” U: ” to the first partition of removable hard disks.
※ Example 1 means assigning drive letter “H:” to “hidden partition 1 of hard disk 0″; Example 3 indicates automatically allocating letters to ” all hidden partitions of fixed hard disk.
※ SUBJ command can be used to delete drive letters. When SHOW command cooperates with SUBJ command, they can load hidden partition’s external program and keep the original hidden attribute of hidden partition.

[SHUT]
Format : SHUT [H | E | R | S]
Function: Shut down or restart the computer and so forth.
Parameters:
■ No parameters: The default is shutting down system.
■ Parameter “H”: Perform dormancy operation. It can only be used in normal system which supports dormancy ( It can be enabled in the control panel.).
■ Parameter “E”: Pop up drive before closing the system, and then turn off the system after 10 seconds.
■ Parameter “R”: Execute restart the system operation.
■ Parameter “S”: Perform suspend system operation. It can only be used in the normal system.
Example:
◆ SHUT E
◆ SHUT R
◆ SHUT H
◆ SHUT S
Remarks :
※ This command can be used in command line. Its feature is fast shutdown by which all data may not be saved.

[SITE]
Format : SITE < file directory path >, < file directory attribute >
Function: Set or remove the file directory attribute. SITE command supports the four properties of A, H, R and S.
Parameters:
■ Setting the attribute with the ” +” and clear it with “-“. (A = ARCHIVE; H = HIDDEN; R = READONLY; S = SYSTEM)
Example:
◆ SITE%SystemRoot% \ System32 \ PELOGON.EXE, + H + R
Remarks :
※ SITE command can set file attribute and directory property.

[STRL]
Format : STRL < variable name > <=> < string >
Function: Returns specified string’s length.
Parameters:
■ Variable name: variable name used for saving command result.
■ String: string to be detected. Its length can not exceed 2K.
Example:
◆ STRL iLen = 1234567890
◆ STRL dLen = 12345
Remarks :
※ The return result of this command is the length of Unicode string. The return value of example 1 is 10, and that of example 2 is 5.

[SUBJ]
Format : SUBJ < virtual drive >, [ the path assigned to virtual drive ]
Function: Associate the path with the drive number. The command is equivalent to SUBST command of CMD.
Parameters:
■ If ” the path assigned to virtual drive” is omitted, the specified virtual drive will be removed.
Example:
◆ SUBJ B:, X: \ PE_Tools
Remarks :
※ During the virtual process, the virtual drive must be non-existent. When deleting the virtual drive, the drive letter must be accurate. Otherwise, the physical drive may be removed.

[TEAM]
Format : TEAM [ command 1] [| command 2] [| command 3] … [| command n]
Function: Execute the specified command group’s each command in order.
Parameters:
■ One or many commands: Use “|” between commands to separate multiple commands.
Example:
◆ TEAM TEXT loading the desktop | LOGO | SHEL%SystemRoot% \ EXPLORER.EXE | WAIT 3000
Remarks :
※ The command after TEAM command can not nest IFEX or FIND command.

[TEMP]
Format : TEMP <[@] Delete | Setting>
Function: Clean up user temporary folder, or reset the location of user temporary folder.
Parameters:
■ Delete means cleaning up temporary directory. The leading character “@” indicates direct cleaning up without user’s confirmation. Setting denotes resetting the location of the temporary directory.
Example:
◆ TEMP Delete
Remarks :
※ Do not use this command in the configuration file. It must be used by booting to the desktop. This command is to read temporary directory location from the registry.

[TEXT]
Format : TEXT [ text line 1] [\ n] text line 2 [\ n] text line 3 … ] [ # color ] [L left ] [T top ] [R right ] [B bottom ] [ $ font size ]
Function: Display text in the login screen or desktop window.
Parameters:
■ If the text is empty, remove the recently defined text in rectangular area. The default color is white; The default coordinate is roughly in the top left corner; The “*” at the end means that before the new text is displayed, the originally displayed text is not removed.
Example:
◆ TEXT registering components …… # 0xFFDDDD L4 T720 R300 B768 $ 20
Remarks :
※ This command supports multiple-line display text. Use “\ n” to indicate line break between text lines.
※ Font size: The default font size is 14 ( equivalent to Song typeface’s small five font ).
※ The specified location [ left, top, right, bottom ] is related with the text length and font size.
※ If this command is used in the configuration file during the login process, the text will display in the login screen; If it is used in Windows after login, the text will display desktop window; If the text is empty, remove the recently defined text in rectangular area.

[TIME]
Format : TIME < timer name >, < timer period >, [ timer event ]
Function: Build a timer control within the window defined by _SUB command.
Parameters:
■ Timer name: string. It should be unique, and can not be same as other controls names environment variables names.
■ Timer period: numerical value. Its unit is ms. If the value is greater than 0, it indicates that the timer works immediately; If the value is 0, it means that the timer pauses working.
■ Timer event: The command is executed when triggering the timer. And it must be a valid command supported by PECMD command.
Example:
◆ TIME Timer1, 10000, FILE% TEMP% \ *. *
Remarks :
※ TIME command must be located between _SUB command and _END command. TIME at any other location is invalid. Please make reference to the descriptions of _SUB and CALL commands.
※ Environment variable, %timer name%, is the timer’s working status. 0 represents “suspend”, non-zero value stands for “started”.
※ Use “ENVI @ timer name = 0” to suspend timer; Use “ENVI @ timer name = timer period( value )” to restart the timer.

[TIPS]
Format : TIPS [ prompt box title ], < prompt box content >, [ prompt box life ], [ icon style ID], [<@ [A] prompt box location > | [ tray bar icon ] ]
Function: Display a bubble prompt box in the specified location or tray bar of a screen. If all parameters are omitted, it indicates removing invalid icons in tray bar.
Parameters:
■ Prompt box title: string; text displayed at the prompt box title. It can not be longer than 64 characters, and the exceeding part is invalid.
■ Prompt box content: string; body content displayed at the prompt. It can not be longer than 256 characters. Meanwhile, “\ n” can be used as line break.
■ Prompt box life: number, used for representing the prompt box’s continuous display time( ms ). If it is omitted, the default is 10 seconds. And the longest display time is determined by the system.
■ Icon style ID: number. 0, the default value, stands for no icon; 1 for information icon; 2 for warning icon; 3 for error icon; 4 or value larger than 4 for tray icon.
■ Prompt box location: It must be with a leading character “@”, which represents displaying prompt box in specified location of the screen. The leading character “A” represents arrow type prompt box. If it is omitted, rectangular prompt box will display. The position is expressed by LxxTyy (xx and yy represents numbers.) And this parameter can not be used together with tray bar icon.
■ Tray bar icon: Its format is ” file name # number”. When omitting the “file name”, use the specified icon in PECMD.EXE program resource.
Example:
◆ TIPS title, content \ n can branch \ n line 3 , 5000,1 , # 1
◆ TIPS title, content \ n can branch \ n line 3 , 5000,2, @ aL600T400
Remarks:
※ Tray bar bubble prompt box can continue to display after the end of PECMD.EXE. When the PECMD.EXE life is longer than the prompt box life, the PECMD.EXE will end the prompt box after the specified time. After the end of PECMD.EXE life, the still existing prompt box will be processed by the system or user.
※ The screen prompt box will end after the end of PECMD. So make sure that PECMD lifetime is slightly longer than prompt box’s (WAIT command delay) .

[UPNP]
Format : UPNP [$] < parameter >
Function: Perform the functionality of BartPE.EXE.
Parameters:
■ The leading character “$” indicates displaying the execution interface of BartPE.EXE.
■ Parameter: BartPE.EXE’s command line parameter.
Example:
◆ UPNP-pnp
◆ UPNP $-pnp
Remarks:
※ This command embeds execute code of new BartPE.EXE. Without BartPE.EXE file, WinPE can also implement the functionality of BartPE.EXE.
※ The command is executed in blocking mode. The command must be finished before executing the next command. Please pay attention to BartPE.EXE parameters and their case sensitivity.

[USER]
Format : USER < user name > <* |,> < company name >
Function: Set the user name and company name in context menu properties of “My Computer”.
Parameters:
■ Parameters are texts.
Example:
◆ USER Laojiu*Worry-free Start Forum
◆ USER Laojiu, Worry-free Start Forum
Remarks :
※ The separator between user name and company name must be “*” or “,”. This command can only be used in the configuration file.

[WAIT]
Format : WAIT [-] [ wait time ], [ quantitative change name ]
Function: Pause or continue to execute the command after waiting for a specified time.
Parameters:
■ Leading character ” – “: Stop waiting when encountering any key during the specified wait time. Otherwise, wait until the end of waiting time.
■ Wait time: numerical value (unit is ms.). When the value is 0, suspend on encountering any key; Without keys, wait indefinitely ( equivalent to any key to continue ).
■ Quantitative change name: It is used to save keys’ variables during wait time. The user’s key results will be saved in the specified variable.
Example:
◆ WAIT 2000
◆ WAIT 0, PKey
Remarks :
※ When the parameter is 0, pause. Press any key to continue. Do not continuously use pause functionality in short intervals, and it is recommended to use pause functionality only once. WAIT 0 can detect the user’s key of ‘A’ ~ ‘Z’ or ‘0 ‘~’ 9 ‘. When omitting the variable name, the key result is stored in the environment variable %PressKey%.

[WALL]
Format : WALL < wallpaper file name >
Function: Set wallpaper
Parameters:
■ Wallpaper file name
Example:
◆ WALL%CurDrv% \ external program \ WallPage.JPG
Remarks :
※ It supports environment variables and different formats’ picture files. WALL command of setting wallpaper must be before SHEL command of loading the desktop.
※ This command can not be used in command line. It can only be used in the configuration file.

 

Related Article:

• Detailed Explanation of PECMD in WinPE—- PECMD.INI File Configuration (1)