WScript – сервер сценариев Windows с графическим интерфейсом.
Сервер сценариев wscript.exe , начиная с Windows 98, является стандартным компонентом Windows Script Host (WSH), и предназначен для выполнения сценариев (скриптов), написанных на языках VBScript и Jscript. Возможности сценариев WSH значительно выше возможностей командных файлов Windows, что позволяет решать многие задачи управления и контроля системы стандартными средствами без использования дополнительного программного обеспечения.
Сценарии WSH могут исполняться в среде сервера сценариев Windows с помощью одной из двух программ — wscript.exe (с графическим интерфейсом) или cscript.exe (с консольным интерфейсом). Функционально, обе программы близки, но графический интерфейс более удобен для выполнения интерактивных сценариев, а консольный – для сценариев администрирования, не требующих диалога с пользователем. Диалоговый режим при выполнении сценариев как с использованием wscript.exe , та и с использованием cscript.exe может быть отключен специальным параметром командной строки. Большинство сценариев администрирования Windows (в том числе многие сценарии, предлагаемые Microsoft) требуют использовать CScript в качестве сервера сценариев. Также следует отметить, что некоторые из свойств объекта WScript (не путать с сервером сценариев WScript!) существуют только тогда, когда активным сервером сценариев является CScript . По умолчанию, в среде WSH используется сервер сценариев wscript.exe
При запуске wscript.exe без параметров, отображается окно Параметры сервера сценариев Windows :
Как видим, имеется всего лишь возможность ограничить время выполнения сценариев и изменить режим отображения сведений о программе в консольном режиме.
Для получения справки по работе с программой, можно воспользоваться командой:
Справка отображается в стандартном окне сообщений Windows:
Формат командной строки wscript.exe :
wccript имя_сценария.расширение [параметры. ] [аргументы. ]
Параметры командной строки:
//B — Пакетный режим: подавляются отображение ошибок и запросов сценария
//D — Включение режима Active Debugging
//E:ядро — Использование указанного ядра для выполнения сценария
//H:CScript — Стандартный сервер сценариев заменяется на CScript.exe
//H:WScript — Стандартный сервер сценариев заменяется на WScript.exe (по умолчанию)
//I — Диалоговый режим (по умолчанию, в противоположность //B)
//Job:xxxx — Выполнение указанного задания WSF
//Logo — Отображать сведения о программе (по умолчанию)
//Nologo — Не отображать сведения о программе во время выполнения
//S — Присвоить установкам сервера сценариев Windows значения по умолчанию.
//T:nn — Интервал ожидания (в секундах): максимальное время выполнения сценария
//X — Выполнение сценария в отладчике
Отличительная особенность параметров командной строки для сервера сценариев – это использование двойной косой черты (двойной прямой слэш – forward slash). Для получения подсказки по использованию, допускаются команды wscript /? и wscript -?
Примеры использования сервера сценариев CSCript
wscript //B hello1.vbs — выполнить сценарий hello1.vbs в графическом режиме.
wscript //D //X hello1.vbs — выполнить сценарий hello1.vbs в среде отладчика c использованием средств активной отладки. Порядок работы и возможности определяются отладчиком, установленным в системе по умолчанию.
wscript.exe /E:VBScript.Encode hello1.js — выполнить сценарий hello1.js но использовать исполняющее ядро VBScript.Encode . Надо отметить, что программный модуль wscript.exe , как и cscript.exe , будучи сервером сценариев, не является интерпретатором языка, на котором написан сценарий, и всего лишь выполняет вызов интерпретатора в соответствии с расширением файла или в соответствии со значением параметра //E: . В качестве интерпретаторов используются динамические библиотеки:
jscript.dll — для языка Jscript
vbscript.dll — для языка VBScript
wscript.exe /H:CScript — установить в качестве сервера сценариев, используемого по умолчанию cscript.exe . После выполнения команды, отображается стандартное окно сообщения Windows:
Используемый по умолчанию сервер сценариев: «cscript.exe».
Стандартно, сервером сценариев по умолчанию, является wscript.exe .
wscript //I hello1.vbs — выполнить сценарий hello1.vbs в интерактивном режиме. Сценарий будет выполнен с отображением сообщений и запросов пользователю ( противоположность параметру //B ).
wscript //Job:main job1.wsf — выполнить задачу с идентификатором main , параметры которой описываются содержимым файла job1.wsf . Файл с параметрами задачи представляет собой XML-файл, обрабатываемый сервером сценариев в соответствии с указанными XML — элементами. Обычно, файлы .wsf используются в тех случаях, когда необходимо в рамках одного сценария выполнить фрагменты исходного кода, написанные на разных языках программирования. Например:
В частности, использование задач .wsf продиктовано необходимостью реализации пользовательского ввода для сценариев на языке JScript. В реализации языка такой ввод отсутствует, но в VBScript есть функция InputBox которая как раз и позволяет это сделать. Обычно, в разделе на языке VBScript описывается пользовательская функция (например, InputString ) для ввода значения посредством функции InputBox . А из раздела на языке JScript выполняется обращение к функции InputString так, как будто она была написана на этом же самом языке.
Пример сценария, в котором выполняется запрос пользователю на ввод данных в графическом окне, выводимом фрагментом исходного кода на языке VBScript, и вывод введенных данных в окне, отображаемом фрагментом исходного кода на языке JScript:
Для запуска задачи используется команда:
wscript //Job:Str1 hello1.wsf — выполнить задачу с идентификатором Str1 из файла hello1.wsf
wscript //S — Присвоить установкам сервера сценариев Windows значения по умолчанию. В справке, отображаемой по команде wscript /? , параметр //S трактуется как ”Сохранить для данного пользователя текущие параметры командной строки”, что не совсем верно. Попробуйте в качестве сервера сценариев по умолчанию задать cscript.exe, а затем выполните команду wscript //S , в результате чего, сервером сценариев по умолчанию снова станет wscript.exe
wscript //T:5 //Job:Str1 hello1.wsf — аналогично рассмотренным выше примерам, но на выполнение сценария отводится 5 секунд. По истечении указанного времени сценарий будет принудительно завершен ( например, если пользователь не отвечает на запрос сценария). При использовании параметра //T:, ограничивается время выполнения текущего сценария, в отличие от настройки параметра ”Остановить сценарий после указанного числа секунд”, который ограничивает время выполнения всех сценариев. Если ограничение по времени в настройках сервера сценариев и заданное параметром //T: различаются, то будет применено значение указанное в //T:
Объект WshShell
1. Создание объекта
2. Свойства
2.1. CurrentDirectory
Возвращаемое значение: строка, путь к текущему каталогу.
Замечание: чтение и запись.
2.2. Environment
Возвращаемое значение: объект-коллекция «WshEnvironment», содержащая переменные среды. Необязательный параметр «Type» — строка, задаёт вид переменных. Возможные значения:
- «System» — переменные среды операционной системы (в Windows NT/2000 — это параметр по умолчанию).
- «User» — переменные среды пользователя.
- «Volatile» — временные переменные.
- «Process» — переменные среды текущего командного окна (в Windows 95/98/Me — это единственно возможный параметр).
Замечание: чтение и запись. В коллекцию можно добавлять элементы и удалять их.
2.3. SpecialFolders
Возвращаемое значение: объект-коллекция «SpecialFolders», содержащая пути к специальным папкам Windows. Некоторые специальные папки:
- AllUsersDesktop
- AllUsersStartMenu
- AllUsersPrograms
- AllUsersStartup
- Desktop
- Favorites
- Fonts
- MyDocuments
- NetHood
- PrintHood
- Programs
- Recent
- SendTo
- StartMenu
- Startup
- Template
Замечание: только чтение.
3. Методы
3.1. ExpandEnvironmentStrings
Назначение: возвращает значение переменной среды текущего командного окна.
- — строка, имя переменной. Должно быть окружено знаками «%».
3.2. Popup
Назначение: выводит на экран модальное окно сообщения.
— строка, текст сообщения.
- 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
Назначение: посылает одно или несколько нажатий клавиш в активное окно (имитация набора на клавиатуре).
- — строка, перечень клавиш в специальном формате.
Описание: каждая клавиша задаётся своим символом. Например, чтобы задать нажатие друг за другом клавиш А, Б и В, нужно указать в качестве параметра строку «АБВ». Некоторые специальные символы следует всегда задавать заключёнными в фигурные скобки. Перечень таких символов:
Задание неотображаемых символов и специальных клавиш:
Можно использовать скобки. Например, нажатие клавиш и при нажатом следует записывать как «+(GS)». Запись «+GS» приведёт к нажатию клавиши при нажатом , а затем клавиши уже без .
Задание нескольких нажатий: «
Метод не может быть использован для посылки нажатий клавиш в приложения MS-DOS.
3.4. Run
Назначение: создаёт новый независимый процесс, который запускает заданное приложение.
- — строка, командная строка запуска приложения.
- — необязательный, число. Определяет вид окна запускаемого приложения. Некоторые возможные значения:
- 0 — Не отображает окно.
- 1 — Активизирует и отображает окно.
- 2 — Активизирует окно и отображает его в свёрнутом виде.
- 3 — Активизирует окно и отображает его в максимизированном виде.
- — необязательный, булево (число). True — сценарий возобновит работу только после завершения вызванного процесса. False (по умолчанию) — управление передаётся сразу обратно в сценарий.
Описание: если параметр «WaitOnReturn» установлен в True, метод возвращает код выхода вызванного приложения. Иначе метод всегда возвращает ноль.
3.5. Exec
Назначение: создаёт новый дочерний процесс (т.е. процесс с теми же переменными среды), который запускает заданное консольное приложение. Возвращается объект «WshScriptExec», который позволяет контролировать ход выполнения запущенного приложения и обеспечивает доступ к потокам StdIn, StdOut и StdErr этого приложения.
- — строка, командная строка запуска приложения.
Описание: с помощью данного метода можно запускать и графические оконные приложения. В этом случае возвращаемый объект «WshScriptExec» полезен тем, что позволяет получить идентификатор запущенного процесса, который можно использовать, например, для активизации приложения с помощью метода AppActivate.
3.6. AppActivate
Назначение: активизирует указанное окно какого-либо приложения. Возвращает True в случае успеха и False в случае неудачи.
- — заголовок окна приложения или идентификатор процесса.
Описание: если в качестве параметра указан заголовок окна приложения, значение параметра сравнивается по очереди с заголовками окон всех запущенных приложений. Если не найдено ни одного точного совпадения, будет производиться поиск окна, заголовок которого начинается с указанной строки. Если и в этом случае не будет найдено ни одного подходящего окна, будет производиться поиск окна, заголовок которого заканчивается на указанную строку. Если будет найдено несколько подходящих окон, произойдёт активизация одного из них (произвольно).
3.7. 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
3.8. 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
3.9. RegWrite
Назначение: записываает в реестр заданный параметр или раздел.
- — строка, наименование параметра или раздела.
- — значение параметра или значение для раздела по умолчанию.
- — необязательный, тип значения. Возможные значения: «REG_SZ», «REG_EXPAND_SZ», «REG_DWORD», «REG_BINARY». Если указано «REG_SZ» или «REG_EXPAND_SZ», параметр «Type» конвертируется в строку, если указано «REG_DWORD», параметр «Type» конвертируется в целое число, если указано «REG_BINARY», параметр «Type» должен быть целым числом.
Описание: если «Name» оканчивается символом «\», метод записывает раздел, в противном случае записывается параметр. Параметр «Name» должен начинаться с одного из корневых ключей:
- HKEY_CURRENT_USER — HKCU
- HKEY_LOCAL_MACHINE — HKLM
- HKEY_CLASSES_ROOT — HKCR
- HKEY_USERS — HKEY_USERS
- HKEY_CURRENT_CONFIG — HKEY_CURRENT_CONFIG
3.10. LogEvent
Назначение: протоколирует событие в журнале WindowsNT или в файле WSH.log. Возвращает True в случае успеха и False в противном случае.
- — число, тип сообщения. Возможные значения:
- 0 — SUCCESS
- 1 — ERROR
- 2 — WARNING
- 4 — INFORMATION
- 8 — AUDIT_SUCCESS
- 16 — AUDIT_FAILURE
- — строка, текст сообщения.
- — строка, название системы, в которой протоколируется событие (по умолчанию — локальная система), может задаваться только в Windows NT/2000/XP.
Описание: в Windows NT/200/XP события записываются в системном журнале, а в Windows 9x — в файле WSH.log, который находится в каталоге пользователей.
3.11. CreateShortcut
Назначение: возвращает объект «WshShortcut» или «WshURLShortcut», указывающий на ярлык .lnk или .url.
— строка, полный путь к создаваемому или изменяемому файлу ярлыка.
4. Объект WshScriptExec
4.1. Создание объекта
4.2. Свойства
4.2.1. ExitCode
Возвращаемое значение: код выхода, устанавливаемый дочерней задачей при завершении выполнения.
Замечание: только чтение.
4.2.2. ProcessID
Возвращаемое значение: идентификатор запущенного процесса (PID).
Замечание: только чтение.
4.2.3. Status
Возвращаемое значение: состояние запущенного процесса. Возможные значения:
- 0 — приложение запущено.
- 1 — приложение завершено.
Замечание: только чтение.
4.2.4. StdOut
Возвращаемое значение: объект «TextStream», соответствующий стандартному выходному потоку запущенной задачи.
Замечание: только чтение.
4.2.5. StdIn
Возвращаемое значение: объект «TextStream», соответствующий стандартному входному потоку запущенной задачи.
Замечание: только чтение.
4.2.6. StdErr
Возвращаемое значение: объект «TextStream», соответствующий стандартному потоку ошибок запущенной задачи.
Замечание: только чтение.
4.3. Методы
4.3.1. Terminate
Назначение: пытается закрыть приложение, посылая ему сообщение WM_CLOSE. Если это не срабатывает, задача завершается принудительно.
5. Объект WshShortcut
5.1. Создание объекта
5.2. Свойства
5.2.1. Arguments
Возвращаемое значение: строка, параметры командной строки программы, запускаемой ярлыком.
Замечание: чтение и запись.
5.2.2. Description
Возвращаемое значение: строка, описание в поле «Комментарий» («Comment») в свойствах ярлыка.
Замечание: чтение и запись.
5.2.3. FullName
Возвращаемое значение: строка, полный путь к файлу ярлыка.
Замечание: только чтение.
5.2.4. Hotkey
Возвращаемое значение: строка, содержащая названия горячих клавиш, разделённые знаком «+».
Замечание: чтение и запись.
5.2.5. IconLocation
Возвращаемое значение: строка, содержащая расположение иконки для ярлыка в формате «путь к файлу, индекс иконки». Индексы иконок начинаются с нуля.
Замечание: чтение и запись.
5.2.6. TargetPath
Возвращаемое значение: строка, содержащая путь к исполняемому файлу.
Замечание: чтение и запись.
5.2.7. WindowStyle
Возвращаемое значение: число, определяющее вид окна запускаемого приложения. Возможные значения:
- 1 — Стандартное окно.
- 3 — Максимизированное окно.
- 7 — Минимизированное окно.
Замечание: чтение и запись.
5.2.8. WorkingDirectory
Возвращаемое значение: строка, путь к рабочему каталогу ярлыка.