Объект WshShell
С помощью объекта WshShell можно запускать новый процесс, создавать ярлыки, работать с системным реестром, получать доступ к переменным среды и специальным папкам Windows. Создается этот объект следующим образом:
Свойства
Методы
CurrentDirectory
Синтаксис
Возвращаемое значение
Строка, путь к текущему каталогу.
Пример
Environment
Синтаксис
Возвращаемое значение
Объект-коллекция WshEnvironment, содержащая переменные среды. Необязательный параметр sType — строка, задаёт вид переменных. Возможные значения:
- «System» — переменные среды операционной системы (по умолчанию).
- «User» — переменные среды пользователя.
- «Volatile» — временные переменные.
- «Process» — переменные среды текущего командного окна.
Если sType не указан, этот метод получает системные переменные в Windows.
Следующие переменные предоставляются операционной системой Windows. Скрипты могут также получить переменные окружения, которые были установлены другими прикладными программами.
| Название | Описание |
|---|---|
| NUMBER_OF_PROCESSORS | Число процессоров, используемых в компьютере. |
| PROCESSOR_ARCHITECTURE | Тип процессора автоматизированного рабочего места пользователя. |
| PROCESSOR_IDENTIFIER | Идентификатор процессора автоматизированного рабочего места пользователя. |
| PROCESSOR_LEVEL | Уровень процессора автоматизированного рабочего места пользователя. |
| PROCESSOR_REVISION | Версия процессора автоматизированного рабочего места пользователя. |
| OS | Операционная система на автоматизированном рабочем месте пользователя. |
| COMSPEC | Выполнимая программа для команды command prompt (обычно cmd.exe). |
| HOMEDRIVE | Первичный локальный диск (обычно диск C). |
| HOMEPATH | Основной каталог для пользователей по умолчанию (для Windows NT это — обычно \users\default. |
| PATH | Переменная окружения PATH. |
| PATHEXT | Расширения для исполняемых файлов (обычно .com, .exe, .bat, или .cmd). |
| PROMPT | Командная строка (обычно $P$G). |
| SYSTEMDRIVE | Локальный диск, на котором находится системный каталог (например, c:\). |
| SYSTEMROOT | Каталог ОС (например, c:\winnt). Аналогичен WINDIR. |
| WINDIR | Каталог ОС (например, c:\winnt). Аналогичен SYSTEMROOT. |
| TEMP | Каталог для хранения временных файлов (например, c:\temp). User, Volatile |
| TMP | Каталог для хранения временных файлов (например, c:\temp). User, Volatile |
Объект WshEnvironment
Объект WshEnvironment позволяет получить доступ к коллекции, содержащей переменные среды заданного типа (переменные среды операционной системы, переменные среды пользователя или переменные среды текущего командного окна). Объект имеет три свойства и один метод:
Примеры
SpecialFolders
Синтаксис
Возвращаемое значение
Объект-коллекция WshSpecialFolders, содержащая пути к специальным папкам Windows. Некоторые специальные папки:
- AllUsersDesktop
- AllUsersStartMenu
- AllUsersPrograms
- AllUsersStartup
- Desktop
- Favorites
- Fonts
- MyDocuments
- NetHood
- PrintHood
- Programs
- Recent
- SendTo
- StartMenu
- Startup
- Template
Объект-коллекция WshSpecialFolders
Объект имеет три свойства:
Пример
AppActivate()
Метод AppActivate() активизирует указанное окно какого-либо приложения. Возвращает true в случае успеха и false в случае неудачи.
Синтаксис
Параметры
Комментарии
Если в качестве параметра указан заголовок окна приложения, значение параметра сравнивается по очереди с заголовками окон всех запущенных приложений. Если не найдено ни одного точного совпадения, будет производиться поиск окна, заголовок которого начинается с указанной строки. Если и в этом случае не будет найдено ни одного подходящего окна, будет производиться поиск окна, заголовок которого заканчивается на указанную строку. Если будет найдено несколько подходящих окон, произойдёт активизация одного из них (произвольно).
Пример
Параметры
Пример
Метод Exec() создаёт новый дочерний процесс (т.е. процесс с теми же переменными среды), который запускает заданное консольное приложение. Возвращается объект «WshScriptExec, который позволяет контролировать ход выполнения запущенного приложения и обеспечивает доступ к потокам StdIn, StdOut и StdErr этого приложения.
Синтаксис
Параметры
Комментарии
С помощью данного метода можно запускать и графические оконные приложения. В этом случае возвращаемый объект WshScriptExec полезен тем, что позволяет получить идентификатор запущенного процесса, который можно использовать, например, для активизации приложения с помощью метода AppActivate.
Примеры
ExpandEnvironmentStrings()
Метод ExpandEnvironmentStrings() возвращает значение переменной среды текущего командного окна.
Синтаксис
Параметры
Пример
LogEvent()
Метод LogEvent() протоколирует событие в журнале Windows. Возвращает true в случае успеха и false в противном случае.
Синтаксис
Параметры
- 0 — SUCCESS
- 1 — ERROR
- 2 — WARNING
- 4 — INFORMATION
- 8 — AUDIT_SUCCESS
- 16 — AUDIT_FAILURE
Пример
Popup()
Метод Popup() выводит на экран модальное окно сообщения.
Синтаксис
Параметры
- 0 — кнопка ОК.
- 1 — кнопки ОК и Отмена.
- 2 — кнопки Стоп, Повтор, Пропустить.
- 3 — кнопки Да, Нет, Отмена.
- 4 — кнопки Да и Нет.
- 5 — кнопки Повтор и Отмена.
- 16 — значок Stop.
- 32 — значок Question.
- 48 — значок Exclamation.
- 64 — значок Information.
Комментарии
Возвращает целое значение, с помощью которого можно узнать, какая кнопка быля нажата пользователем. Возможные значения:
- -1 — таймаут.
- 1 — кнопка ОК.
- 2 — кнопка Отмена.
- 3 — кнопка Стоп.
- 4 — кнопка Повтор.
- 5 — кнопка Пропустить.
- 6 — кнопка Да.
- 7 — кнопка Нет.
- 10 — кнопка Try Again.
- 11 — кнопка Continue.
Пример
RegDelete()
Метод RegDelete() удаляет из реестра заданный параметр или раздел целиком.
Синтаксис
Параметры
Комментарии
Если «Name» оканчивается символом «\», метод удаляет ключ целиком, в противном случае удаляется параметр. Параметр «Name» должен начинаться с одного из корневых ключей:
- HKEY_CURRENT_USER — HKCU
- HKEY_LOCAL_MACHINE — HKLM
- HKEY_CLASSES_ROOT — HKCR
- HKEY_USERS — HKEY_USERS
- HKEY_CURRENT_CONFIG — HKEY_CURRENT_CONFIG
Пример
RegRead()
Метод RegRead() читает из реестра заданный параметр или значение по умолчанию для раздела.
Синтаксис
Параметры
Комментарии
Если «Name» оканчивается символом «\», метод считывает значение по умолчанию для раздела, в противном случае считывается параметр. Параметр «Name» должен начинаться с одного из корневых ключей:
- HKEY_CURRENT_USER — HKCU
- HKEY_LOCAL_MACHINE — HKLM
- HKEY_CLASSES_ROOT — HKCR
- HKEY_USERS — HKEY_USERS
- HKEY_CURRENT_CONFIG — HKEY_CURRENT_CONFIG
Пример
RegWrite()
Метод RegWrite() записываает в реестр заданный параметр или раздел.
Синтаксис
Параметры
- REG_SZ — Строка
- REG_DWORD — Число
- REG_BINARY — Массив чисел
- REG_EXPAND_SZ — Строка расширяемая, например,»%windir%\\calc.exe»
- REG_MULTI_SZ — Массив строк
Комментарии
Если «Name» оканчивается символом «\», метод записывает раздел, в противном случае записывается параметр. Параметр «Name» должен начинаться с одного из корневых ключей:
- HKEY_CURRENT_USER — HKCU
- HKEY_LOCAL_MACHINE — HKLM
- HKEY_CLASSES_ROOT — HKCR
- HKEY_USERS — HKEY_USERS
- HKEY_CURRENT_CONFIG — HKEY_CURRENT_CONFIG
Пример
Метод Run() создаёт новый независимый процесс, который запускает заданное приложение.
Синтаксис
Параметры
- 0 — Не отображает окно.
- 1 — Активизирует и отображает окно.
- 2 — Активизирует окно и отображает его в свёрнутом виде.
- 3 — Активизирует окно и отображает его в максимизированном виде.
- 4 — Отображает окно в его последнем виде (размер и положение). Активное окно остается активным.
- 5 — Активизирует окно и отображает его в текущем размере и позиции.
- 6 — Сводит к минимуму указанное окно и активирует следующее окно верхнего уровня в Z порядке.
- 7 — Отображает окно в минимальном виде. Активное окно остается активным.
- 8 — Отображает окно в его текущем состоянии. Активное окно остается активным.
- 9 — Активизирует и отображает окно. Если окно свернуто или развернуто, система восстанавливает его исходный размер и положение. Приложение должно указывать этот флаг при восстановлении свернутого окна.
Комментарии
Если параметр «WaitOnReturn» установлен в true , метод возвращает код выхода вызванного приложения. Иначе метод всегда возвращает ноль.
Пример
SendKeys()
Метод SendKeys() посылает одно или несколько нажатий клавиш в активное окно (имитация набора на клавиатуре).
Синтаксис
Параметры
Комментарии
Каждая клавиша задаётся своим символом. Например, чтобы задать нажатие друг за другом клавиш А, Б и В, нужно указать в качестве параметра строку «АБВ». Некоторые специальные символы следует всегда задавать заключёнными в фигурные скобки. Перечень таких символов:
Задание неотображаемых символов и специальных клавиш:
Для отправки символов, которые состоят из клавиши в сочетании с SHIFT, CTRL или ALT, создайте составной строковый аргумент, представляющий комбинацию клавиш.
| Ключ | Специальные символы |
|---|---|
| SHIFT | + |
| CTRL | ^ |
| ALT | % |
При использовании таким образом, эти специальные символы не заключаются в пару фигурных скобок.
Например, для отправки сочетания клавиш Ctrl + X аргумент будет ^ X. При использовании специальных символов допустимо использовать группировки. Так, +(GH) отправит знак G при нажатой клавише SHIFT, а затем знак H при нажатой клавише SHIFT. А + GH отправит знак G при нажатой клавише SHIFT, а затем знак H, но уже без нажатой клавише SHIFT.
Для не специальных символов можно указывать количество повторений. Так, <х 10>передаст нажатие клавиши x подряд 10 раз. Наличие пробела между символом и количеством повторений обязательно.
Можно отправить «х» в десять раз, но нельзя сделать то же самое для составных символов, например, «Ctrl + X» использую предыдущий шаблон.
Примеры VBS: объект WScript.Shell
Возвращаемое значение: строка, путь к текущему каталогу.
Замечание: чтение и запись.
2.2. Environment
Возвращаемое значение: объект-коллекция "WshEnvironment", содержащая переменные среды. Необязательный параметр "Type" — строка, задаёт вид переменных. Возможные значения:
System — переменные среды операционной системы (в Windows NT/2000 — это параметр по умолчанию).
User — переменные среды пользователя.
Volatile — временные переменные.
Process — переменные среды текущего командного окна (в Windows 95/98/Me — это единственно возможный параметр).
Замечание: чтение и запись. В коллекцию можно добавлять элементы и удалять их.
2.3. SpecialFolders
- AllUsersDesktop
- AllUsersStartMenu
- AllUsersPrograms
- AllUsersStartup
- Desktop
- Favorites
- Fonts
- MyDocuments
- NetHood
- PrintHood
- Programs
- Recent
- SendTo
- StartMenu
- Startup
- Template
3.1. ExpandEnvironmentStrings
Назначение: возвращает значение переменной среды текущего командного окна.
Параметры:
<String> — строка, имя переменной. Должно быть окружено знаками "%".
Назначение: выводит на экран модальное окно сообщения.
Параметры:
<Text> — строка, текст сообщения.
<SecondsToWait> — необязательный, число. Количество секунд, по истечении которого окно будет автоматически закрыто.
<Title> — необязательный, строка. Текст заголовка окна сообщения.
<Type> — необязательный, число. Комбинация флагов, определяет тип кнопок и значка. Возможные значения флагов:
0 — кнопка ОК.
1 — кнопки ОК и Отмена.
2 — кнопки Стоп, Повтор, Пропустить.
3 — кнопки Да, Нет, Отмена.
4 — кнопки Да и Нет.
5 — кнопки Повтор и Отмена.
16 — значок Stop.
32 — значок Question.
48 — значок Exclamation.
64 — значок Information.
Описание: возвращает целое значение, с помощью которого можно узнать, какая кнопка быля нажата пользователем. Возможные значения:
-1 — таймаут.
1 — кнопка ОК.
2 — кнопка Отмена.
3 — кнопка Стоп.
4 — кнопка Повтор.
5 — кнопка Пропустить.
6 — кнопка Да.
7 — кнопка Нет.
3.3. SendKeys
Назначение: посылает одно или несколько нажатий клавиш в активное окно (имитация набора на клавиатуре).
Параметры:
<String> — строка, перечень клавиш в специальном формате.
Описание: каждая клавиша задаётся своим символом. Например, чтобы задать нажатие друг за другом клавиш А, Б и В, нужно указать в качестве параметра строку "АБВ". Некоторые специальные символы следует всегда задавать заключёнными в фигурные скобки. Перечень таких символов:
Можно использовать скобки. Например, нажатие клавиш <G> и <S> при нажатом <Shift> следует записывать как "+(GS)". Запись "+GS" приведёт к нажатию клавиши <G> при нажатом <Shift>, а затем клавиши <S> уже без <Shift>.
Задание нескольких нажатий: "
Метод не может быть использован для посылки нажатий клавиш в приложения MS-DOS.
Объект WScript.Shell метод Run — запуск внешних программ
Доброго времени суток всем читателям блога scriptcoding.ru. В этой статье мы подробно рассмотрим метод Run Wscript.Shell объекта. Данный метод служит для запуска внешних приложений из тела сценариев Windows Script Host.
Для начала мы рассмотрим теоретическую часть, а потом приступим к программированию.
Run (strCommand, [intWindowStyle], [bWaitOnReturn]) – данный метод служит для запуска другого приложения как в консольном режиме (командная строка), так и в оконном. При открытии исполняемого файла создается новый процесс. Ему передаются следующие параметры:
strCommand – данный параметр является обязательным, поскольку задает путь для файла или команды. Стоит учитывать, что если путь содержит пробелы, то его обязательно стоит заключать в двойные кавычки, иначе, возникнет ошибка » The system cannot find the file specified » – система не может найти указанный файл. Также полезно, использовать переменные окружения в пути к приложению, это экономит время.
intWindowStyle – является необязательным, и задает стиль окна. Параметр может принимать целые значения от 0 до 10. Согласно документации, в языке vbscript можно использовать именованные константы, но, они не всегда дают ожидаемый результат, и так как эти значения между собой повторяются, я упомянул лишь три:
- 0 – скрывает окно, будет виден только процесс в диспетчере задач.
- 1 – нормальный режим
- 2 – свернутый вид
- 3 – развернутый вид
bWaitOnReturn – может принимать true – сценарий будет ожидать завершения работы запущенного приложения, и только потом перейдет к выполнению следующей строчки кода, false – будет продолжатся выполнение сценария независимо от того, завершилась работа запущенного приложения или нет. Также следует учесть, что если установлено true, то метод вернет код выхода вызванного приложения, если установлено false – всегда будет возвращаться ноль.
Хорошо, теперь настало время заняться программирование. Для начала напишем программный код на языке VBScript:
‘******************************************************* ‘ метод wscript shell run ‘ Запуск бл0кн0та и калькулятора ‘ wshshell_run.vbs ‘******************************************************* Option Explicit dim path, WshShell ‘ задаем путь к системной папке path = "%WINDIR%\System32\" ‘ Создаем ссылку на объект WscriptShell set WshShell = WScript.CreateObject("Wscript.Shell") ‘ Открываем notepad (Wshshell Run) WshShell.Run path & "notepad.exe", ,true MsgBox "Текстовый редактор завершил работу. " & vbCrLf & "Запускаем калькулятор" ‘ Открываем calc WshShell.Run path & "calc.exe",2,false MsgBox "Этот текст выводится сразу"
Давайте проанализируем логику работы данного сценария. Переменная path хранит путь к папке System32, так как в ней у нас лежат исполняемые файлы notepad и calc. Переменная окружения » %WINDIR% » позволяет сократить строки кода и не писать » C:\\Windows «. WshShell содержит ссылку на экземпляр объекта Wscript.Shell, видим, чтобы создать саму ссылку, мы перед переменной прописали ключевое слово set, после чего идет вызов метода CreateObject класса WScript, подробней о работе с объектами читайте «Урок 8 по VBScript: Объекты и классы» и «Урок 4 по JScript: Создание собственных объектов». Далее мы запускаем блокнот с помощью метода Run Wscript Shell класса, через переменную WshShell. Для программы notepad мы третий параметр команды Run поставили в true, поэтому, исполняемый файл calc запустится только после закрытия приложения блокнот, плюс, перед этим появится информационное сообщение.
Хорошо, теперь давайте посмотрим на аналогичный пример, но написанный уже на языке jscript.
//******************************************************* // метод wscript shell run // Запуск бл0кн0та и калькулятора // wshshell_run.js //******************************************************* var path, WshShell; // задаем путь к системной папке path = "%WINDIR%\\System32\\"; // Создаем ссылку на WscriptShell WshShell = WScript.CreateObject("Wscript.Shell"); // Запускаем notepad (Wshshell Run) WshShell.Run (path + "notepad.exe",1,true); WScript.Echo ("Текстовый редактор завершил работу. " + "\n" + "Запускаем калькулятор"); // Запускаем calc WshShell.Run (path + "calc.exe",2,false); WScript.Echo ("Этот текст выводится сразу");
В данном примере, мы видим, что для команды Run мы прописали второй параметр (1 – нормальный режим), если этого не сделать, то произойдет ошибка, язык jscript не дает нам возможности пропустить параметр. Также видим, что тут не нужно использовать дополнительное ключевое слово типа set.
WScript Shell Run
Хорошо, теперь давайте посмотрим на еще один пример на языке vbscript.
‘******************************************************* ‘ метод wscript run ‘ Запуск бл0кн0та и передача ему текста ‘ wscript_run.vbs ‘******************************************************* Option Explicit dim WshShell ‘ Создаем ссылку на WscriptShell set WshShell = WScript.CreateObject("Wscript.Shell") ‘ Открываем текстовый редактор и вставляем в него содержимое сценария WshShell.Run "notepad.exe " & WScript.ScriptFullName,1,true MsgBox "Мы открывали текстовый редактор"
В этом примере мы также запустили приложение notepad, но, не прописывали путь к нему. Дело в том, что команда Run объекта Wscript.Shell работает как команда » Windows Пуск/Выполнить «, и при запуске приложения, сперва идет его поиск в переменных средах Windows, в которые, и входит папка System32 . Также видим, что мы передали программе содержимое нашего сценария (строка WScript.ScriptFullName), фактически, скопировали в него весть текст скрипта.
Ну и напоследок, аналогичный пример, но уже на языке jscript:
//******************************************************* // метод wscript run // Запуск бл0кн0та ему текста // wscript_run.js //******************************************************* var WshShell; // Создаем ссылку на WscriptShell WshShell = WScript.CreateObject("Wscript.Shell"); // Открываем текстовый редактор и вставляем в него содержимое сценария WshShell.Run ("notepad.exe " + WScript.ScriptFullName,1,true); WScript.Echo ("Это был запуск текстового редактора");
И так, давайте все подытожим… В этой статье мы разобрали метод Run класса Wscript Shell, который позволяет запускать заданное приложение, и передавать ему нужные параметры, так, мы можем открыть текстовый редактор и вставить в него нужный текст. Аналогично, можно использовать и метод Exec, который тоже позволяет запускать исполняемый файл, но в отличии от метода Run, он позволяет контролировать работу исполняемого файла.
Спасибо за внимание. Автор блога Владимир Баталий