Windows Script Host для Windows 2000/XP - читать бесплатно онлайн полную версию книги автора Андрей Владимирович Попов (Глава 1 Первое знакомство с Windows Script Host) #3

Глава 1 Первое знакомство с Windows Script Host

В ранних версиях Windows стандартным средством для автоматизации однотипных повторяющихся задач служили командные (пакетные) файлы и утилиты пакета Resource Kit для соответствующей версии. Однако даже с помощью имеющегося в Windows NT/2000/XP усовершенствованного командного интерпретатора cmd.exe трудно написать какую-либо сложную программу-сценарий (script): отсутствует полноценная интерактивность, нельзя напрямую работать с рабочим столом Windows и системным реестром и т.д.

Для исправления этой ситуации компанией Microsoft был разработан сервер сценариев WSH — Windows Script Host, с помощью которого можно выполнять сценарии, написанные, в принципе, на любом языке (при условии, что для этого языка установлен соответствующий модуль (scripting engine), поддерживающий технологию ActiveX Scripting). В качестве стандартных языков поддерживаются Visual Basic Script Edition (VBScript) и JScript.

Вообще говоря, принцип работы сценариев, поддерживаемых WSH, состоит в использовании объектов ActiveX, поэтому вначале мы очень кратко опишем возможности самой технологии ActiveX компании Microsoft.

Возможности технологии ActiveX

Напомним, что в Windows с самого начала для обеспечения обмена данными между приложениями была разработана технология связывания и внедрения объектов (OLE, Object Linking and Embedding). Вначале технология OLE использовалась для создания составных документов, а затем для решения более общей задачи — предоставления приложениями друг другу собственных функций (служб) и правильного использования этих функций. Технология, позволяющая одному приложению (клиенту автоматизации), вызывать функции другого приложения (сервера автоматизации), была названа OLE Automation. В основе OLE и OLE Automation лежит разработанная Microsoft базовая "компонентная" технология COM (Component Object Model).

В общих словах, компонентное программное обеспечение — это способ разработки программ, при котором используются технологии создания программных модулей, подобные технологиям, применяемым для разработки аппаратных средств. Сложные элементные схемы собираются из стандартизированных микросхем, которые имеют четко определенные документированные функции. Разработчик может эффективно пользоваться такими микросхемами, не задумываясь об их внутренней структуре. В программных компонентах, написанных на каком-либо языке программирования, детали реализации используемых алгоритмов также скрыты внутри компонента (объекта), а на поверхности находятся общедоступные интерфейсы, которыми могут пользоваться и другие приложения, написанные на том же или другом языке.

В настоящее время, по заявлению Microsoft, термин OLE используется только по историческим причинам. Вместо него Microsoft с 1996 года применяет новый термин — ActiveX, первоначально обозначавший WWW (World Wide Web) компоненты (объекты), созданные на базе технологии СОМ.

Технология ActiveX до последнего времени являлась ключевой в продуктах Microsoft. Наиболее полное воплощение она нашла в программах Microsoft Office, Internet Explorer, IIS (Internet Information Service). В эти продукты для управления соответствующими объектами автоматизации были встроены интерпретаторы специальных языков сценариев: VBScript (используется в Microsoft Office, Internet Explorer, IIS) и JScript (используется в Internet Explorer, IIS). Однако непосредственно в операционной системе, вне этих продуктов, выполнять сценарии, написанные на VBScript или JScript, было нельзя.

Сервер сценариев WSH является мощным инструментом, предоставляющим единый интерфейс (объектную модель) для специализированных языков (VBScript, JScript, PerlScript, REXX, TCL, Python и т.п.), которые, в свою очередь, позволяют использовать любые внешние объекты ActiveX. С помощью WSH сценарии могут быть выполнены непосредственно в операционной системе Windows, без встраивания в HTML-страницы.

Нумерация версий WSH

Скажем несколько слов относительно нумерации версий WSH. Самая первая версия WSH, входившая в качестве стандартного компонента в Windows 98, имела номер 1.0. С другой стороны, эта версия опиралась на языки сценариев JScript и VBScript версии 5.0, которые поддерживались Internet Explorer 5.0, поэтому можно к самой первой версии WSH относиться и как к WSH 5.0. Следующей версии WSH, входившей в поставку Windows 2000, был присвоен номер 2.0; в этой версии использовались языки JScript и VBScript версии 5.1. Наконец, номер последней версии WSH, являющейся неотъемлемой частью Windows ХР, компания Microsoft решила все же привязать к номеру версии языков JScript и VBScript — таким образом появился сервер сценариев WSH 5.6.

Отметим также, что даже сама аббревиатура "WSH" сначала расшифровывалась Microsoft как "Windows Scripting Host", а затем было принято название "Windows Script Host".

Замечание

Несмотря на то, что WSH 5.6 является стандартной частью Windows ХР, эту версию можно также установить и использовать во всех предыдущих 32-разрядных версиях Windows 95/98/ME/NT/2000. Для этого необходимо скачать инсталляционный файл для WSH 5.6 с сервера Microsoft (http://msdn.microsoft.com/scripting); там же можно найти и документацию по WSH 5.6.

Назначение и основные свойства WSH

WSH предъявляет минимальные требования к объему оперативной памяти и является очень удобным инструментом для автоматизации повседневных задач пользователей и администраторов операционной системы Windows. Используя сценарии WSH, можно непосредственно работать с файловой системой компьютера, а также управлять работой других приложений (серверов автоматизации). При этом возможности сценариев ограничены только средствами, которые предоставляют доступные серверы автоматизации.

Перечислим только наиболее очевидные задачи, для автоматизации которых прекрасно подходят сценарии WSH.

□ Организация резервного копирования на сетевой сервер файлов с локальной машины, которые отбираются по какому-либо критерию.

□ Быстрое изменение конфигурации рабочего стола Windows в зависимости от задач, выполняемых пользователем.

□ Автоматический запуск программ Microsoft Office, создание там сложных составных документов, распечатка этих документов и закрытие приложений.

□ Управление работой приложений, не являющихся серверами автоматизации, с помощью посылки в эти приложения нажатий клавиш.

□ Подключение и отключение сетевых ресурсов (дисков и принтеров).

□ Создание сложных сценариев регистрации для пользователей.

□ Выполнение задач администрирования локальной сети (например, добавление или удаление пользователей).

Создание и запуск простейших сценариев JScript и VBScript

Простейший WSH-сценарий, написанный на языке JScript или VBScript, — это обычный текстовый файл с расширением js или vbs соответственно, создать его можно в любом текстовом редакторе, способном сохранять документы в формате "Только текст".

Замечание

Специальные мощные программы, позволяющие создавать и отлаживать сценарии, описаны в приложении 3.

Размер сценария может изменяться от одной до тысяч строк, предельный размер ограничивается лишь максимальным размером файла в соответствующей файловой системе.

В качестве первого примера создадим JScript-сценарий, выводящий на экран диалоговое окно с надписью "Привет!" (рис. 1.1).

Рис. 1.1. Простое диалоговое окно

Для вывода такого окна достаточно с помощью, например, стандартного Блокнота Windows (notepad.exe) создать файл First.js, содержащий всего одну строку:

WScript.Echo("Привет!");

Тот же самый сценарий на языке VBScript, естественно, отличается синтаксисом и выглядит следующим образом:

WScript.Echo "Привет!"

Несмотря на то, что для работы наших сценариев достаточно всего одной строки, желательно сразу приучить себя к добавлению в начало файла информации о находящемся в нем сценарии: имя файла, используемый язык, краткое описание выполняемых действий. На языке JScript такая информация, оформленная в вице комментариев, может выглядеть следующим образом:

/*******************************************************************/

/* Имя: First.js                          */

/* Язык: JScript                          */

/* Описание: ВЫВОД на экран приветствия               */

/*******************************************************************/

Рис. 1.2. Сценарий First.js

На языке VBScript то же самое выглядит следующим образом:

'*******************************************************************

' Имя: First.vbs

' Язык: VBScript

' Описание: Вывод на экран приветствия

'*******************************************************************

Для запуска сценариев WSH существует несколько способов.

Запуск сценария из командной строки в консольном режиме

Можно выполнить сценарий из командной строки с помощью консольной версии WSH cscript.exe. Например, чтобы запустить сценарий, записанный в файле C:\Script\First.js, нужно загрузить командное окно и выполнить в нем команду

cscript С:\Script\First.js

В результате выполнения этого сценария в командное окно выведется строка "Привет!" (рис. 1.3).

Рис. 1.3. Результат выполнения First.js в консольном режиме (cscript.exe)

Запуск сценария из командной строки в графическом режиме

Сценарий можно выполнить из командной строки с помощью (оконной) графической версии WSH wscript.exe. Для нашего примера в этом случае нужно выполнить команду

wscript C:\Script\First.js

Тогда в результате выполнения сценария на экране появится нужное нам диалоговое окно (рис. 1.4).

Таким образом, мы видим, что при запуске сценария в консольном режиме вывод текстовой информации происходит в стандартный выходной поток (на экран), при запуске в графическом режиме — в диалоговое окно.

Рис. 1.4. Результат выполнения First.js в графическом режиме (wscript.exe)

Запуск сценария с помощью меню Пуск

Для запуска сценария с помощью пункта Выполнить (Run) меню Пуск (Start), достаточно написать полное имя этого сценария в поле Открыть (Open) (рис. 1.5).

Рис. 1.5. Запуск сценария из меню Пуск в Windows ХР

В этом случае по умолчанию сценарий будет выполнен с помощью wscript.exe, т.е. вывод информации будет вестись в графическое диалоговое окно.

Запуск сценария с помощью Проводника Windows (Windows Explorer)

Самым простым является запуск сценария в окнах Проводника Windows или на рабочем столе — достаточно просто выполнить двойной щелчок мышью на имени файла со сценарием или на его значке (рис. 1.6).

Рис. 1.6. Запуск сценария с помощью Проводника Windows

При этом, как и в случае запуска с помощью меню Пуск (Start), сценарий по умолчанию выполняется с помощью wscript.exe.

Установка и изменение свойств сценариев

В случае необходимости для сценариев можно задавать различные параметры, влияющие на ход их выполнения. Для консольной (cscript.exe) и графической (wscript.exe) версий сервера сценариев эти параметры задаются по-разному.

Свойства и параметры сценариев, выполняемых с помощью cscript.exe

В этом случае исполнение сценария контролируется с помощью параметров командной строки для cscript.exe (табл. 1.1), которые включают или отключают различные опции WSH (все эти параметры начинаются с символов //).

Таблица 1.1. Параметры командной строки cscript.exe

Параметр	Описание
`//I`	Выключает пакетный режим (по умолчанию). При этом на экран будут выводиться все сообщения об ошибках в сценарии
`//B`	Включает пакетный режим. При этом на экран не будут выводиться никакие сообщения
`//Т:nn`	Задает тайм-аут в секундах, т.е. сценарий будет выполняться nn секунд, после чего процесс прервется. По умолчанию время выполнения не ограничено
`//Logo`	Выводит (по умолчанию) перед выполнением сценария информацию о версии и разработчике WSH
`//Nologo`	Подавляет вывод информации о версии и разработчике WSH
`//H:CScript` или `//H:Wscript`	Делает cscript.ехе или wscript.exe приложением для запуска сценариев по умолчанию. Если эти параметры не указаны, то по умолчанию подразумевается wscript.exe
`//S`	Сохраняет установки командной строки для текущего пользователя
`//?`	Выводит встроенную подсказку для параметров командной строки
`//E:engine`	Выполняет сценарий с помощью модуля, заданного параметром engine
`//D`	Включает отладчик
`//X`	Выполняет программу в отладчике
`//Job:`	Запускает задание с индексом `JobID` из многозадачного WS-файла (структура WS-файлов будет описана в главе 3)
`//U`	Позволяет использовать при перенаправлении ввода/вывода с консоли кодировку Unicode

Например, команда

cscript //Nologo C:\Script\First.js

запустит сценарий First.js без информации о версии WSH (рис. 1.7).

Сценарий можно запускать с параметрами командной строки, которые указываются после имени этого сценария (процедура обработки таких параметров будет описана ниже, при рассмотрении объектов

WshArguments

WshNamed

WshUnnamed

). Например, команда

cscript //В C:\Script\First.js /а /b

запустит сценарий First.js в пакетном режиме, при этом

/а

/b

будут являться параметрами этого сценария, а

//B

— параметром приложения cscript.exe.

Рис. 1.7. Результат выполнения First.js в консольном режиме без информации о версии WSH

Свойства и параметры сценариев, выполняемых с помощью wscript.exe

При использовании для запуска модуля wscript.exe свойства сценария можно устанавливать с помощью вкладки Сценарий (Script) диалогового окна, задающего свойства файла в Windows (рис. 1.8).

После задания свойств сценария автоматически создается файл с именем этого сценария и расширением wsh, который имеет структуру наподобие ini-файла, например:

[ScriptFile]

Path=C:\Script\First.js

[Options]

Timeout=0

DisplayLogo=1

Если дважды щелкнуть в Проводнике Windows по wsh-файлу или запустить такой файл из командной строки, то соответствующий сервер сценариев (wscript.exe или cscript.exe) запустит сценарий, которому соответствует wsh- файл, с заданными в секции Options параметрами.

Замечание

Если wsh-фaйл не запускается, нужно проверить наличие на диске файла, указанного в секции ScriptFile.

Рис. 1.8. Установка свойств сценария First.js

При запуске сценариев с помощью wscript.exe для задания параметров командной строки сценария можно использовать технологию drag-and-drop — если выделить в Проводнике Windows несколько файлов и перетащить их на ярлык сценария, то этот сценарий запустится, а имена выделенных файлов передадутся ему в качестве параметров.

Стандартные объекты WSH5.6

Перейдем теперь к описанию собственной объектной модели WSH 5.6. С помощью внутренних объектов этой версии WSH из сценариев можно выполнять следующие основные задачи:

□ выводить информацию в стандартный выходной поток (на экран) или в диалоговое окно Windows;

□ читать данные из стандартного входного потока (т. е. вводить данные с клавиатуры) или использовать информацию, выводимую другой командой;

□ использовать свойства и методы внешних объектов, а также обрабатывать события, которые генерируются этими объектами;

□ запускать новые независимые процессы или активизировать уже имеющиеся;

□ запускать дочерние процессы с возможностью контроля их состояния и доступа к их стандартным входным и выходным потокам;

□ работать с локальной сетью: определять имя зарегистрировавшегося пользователя, подключать сетевые диски и принтеры;

□ просматривать и изменять переменные среды;

□ получать доступ к специальным папкам Windows;

□ создавать ярлыки Windows;

□ работать с системным реестром.

В WSH 5.6 входят перечисленные ниже объекты:

□

WScript

. Это главный объект WSH, который служит для создания других объектов или связи с ними, содержит сведения о сервере сценариев, а также позволяет вводить данные с клавиатуры и выводить информацию на экран или в окно Windows.

□

WshArguments

. Обеспечивает доступ ко всем параметрам командной строки запущенного сценария или ярлыка Windows.

□

WshNamed

. Обеспечивает доступ к именным параметрам командной строки запущенного сценария.

□

WshUnnamed

. Обеспечивает доступ к безымянным параметрам командной строки запущенного сценария.

□

WshShell

. Позволяет запускать независимые процессы, создавать ярлыки, работать с переменными среды, системным реестром и специальными папками Windows.

□

WshSpecialFolders

. Обеспечивает доступ к специальным папкам Windows.

□

WshShortcut

. Позволяет работать с ярлыками Windows.

□

WshUrlShortcut

. Предназначен для работы с ярлыками сетевых ресурсов.

□

WshEnvironment

. Предназначен для просмотра, изменения и удаления переменных среды.

□

WshNetwork

. Используется при работе с локальной сетью: содержит сетевую информацию для локального компьютера, позволяет подключать сетевые диски и принтеры.

□

WshScriptExec

. Позволяет запускать консольные приложения в качестве дочерних процессов, обеспечивает контроль состояния этих приложений и доступ к их стандартным входным и выходным потокам.

□

WshController

. Позволяет запускать сценарии на удаленных машинах.

□

WshRemote

. Позволяет управлять сценарием, запущенным на удаленной машине.

□

WshRemoteError

. Используется для получения информации об ошибке, возникшей в результате выполнения сценария, запущенного на удаленной машине.

Кроме этого, имеется объект FileSystemObject, обеспечивающий доступ к файловой системе компьютера (этот объект будет подробно описан в главе 5).

Перейдем теперь к рассмотрению свойств и методов внутренних объектов WSH.

Замечание

Примеры всех сценариев, приведенных далее в этой главе, написаны на JScript. Так как эти сценарии только иллюстрируют свойства и методы WSH и не используют особенностей, характерных только для JScript, перевод их на VBScript не представляет никакого труда.

Объект WScript

Свойства объекта

WScript

позволяют получить полный путь к использующемуся серверу сценариев (wscript.exe или cscript.exe), параметры командной строки, с которыми запущен сценарий, режим его работы (интерактивный или пакетный). Кроме этого, с помощью свойств объекта

WScript

можно выводить информацию в стандартный выходной поток и читать данные из стандартного входного потока. Также

WScript

предоставляет методы для работы внутри сценария с объектами автоматизации и вывода информации на экран (в текстовом режиме) или в окно Windows.

Отметим, что в сценарии WSH объект

WScript

можно использовать сразу, без какого-либо предварительного описания или создания, т. к. его экземпляр создается сервером сценариев автоматически. Для использования же всех остальных объектов нужно применять либо метод

CreateObject

, либо определенное свойство другого объекта.

Свойства объекта

WScript

представлены в табл. 1.2.

Таблица 1.2. Свойства объекта

WScript

Свойство	Описание
`Application`	Предоставляет интерфейс `IDispatch` для объекта `WScript`
`Arguments`	Содержит указатель на коллекцию `WshArguments` , в которой находятся параметры командной строки для исполняемого сценария
`FullName`	Содержит полный путь к исполняемому файлу сервера сценариев (в Windows ХР обычно это C:\WINDOWS\SYSTEM32\CSCRIPT.EXE или C:\WINDOWS\SYSTEM32\WSCRIPT.EXE)
`Name`	Содержит название объекта `Wscript` (Windows Script Host)
`Path`	Содержит путь к каталогу, в котором находится cscript.exe или wscript.exe (в Windows ХР обычно это C:\WINDOWS\SYSTEM32)
`ScriptFullName`	Содержит полный путь к запущенному сценарию
`ScriptName`	Содержит имя запущенного сценария
`StdErr`	Позволяет запущенному сценарию записывать сообщения в стандартный поток для ошибок
`StdIn`	Позволяет запущенному сценарию читать информацию из стандартного входного потока
`StdOut`	Позволяет запущенному сценарию записывать информацию в стандартный выходной поток
`Version`	Содержит версию WSH

Опишем более подробно те свойства объекта WScript, которые требуют дополнительных пояснений.

Свойство Arguments

В следующем примере (листинг 1.1) с помощью цикла for на экран выводятся все параметры командной строки, с которыми был запущен сценарий.

Листинг 1.1. Вывод на экран всех параметров сценария

/*******************************************************************/

/* Имя: ShowArgs.js                         */

/* Язык: JScript                          */

/* Описание: Вывод на экран параметров запущенного сценария     */

/*******************************************************************/

var i, objArgs;

objArgs = WScript.Arguments; //Создаем объект WshArguments

for (i=0; i<=objArgs.Count()-1; i++)

 WScript.Echo(objArgs(i)); //Выводим на экран i-й аргумент

/*************  Конец *********************************************/

Другие примеры работы с аргументами командной строки приведены в листингах 1.4, 1.5, 2.22 и 2.23.

Свойства StdErr, StdIn, StdOut

Доступ к стандартным входным и выходным потокам с помощью свойств

StdIn

StdOut

StdErr

можно получить только в том случае, если сценарий запускался в консольном режиме с помощью cscript.exe. Если сценарий был запущен с помощью wscript.exe, то при попытке обратиться к этим свойствам возникнет ошибка "

Invalid Handle

" (рис. 1.9).

Рис. 1.9. Ошибка при обращении к

StdIn

в графическом режиме

Работать с потоками

StdOut

StdErr

можно с помощью методов

Write

WriteLine

WriteBlankLines

, а с потоком

StdIn

— с помощью методов

Read

ReadLine

ReadAll

Skip

SkipLine

. Эти методы кратко описаны в табл. 1.3.

Таблица 1.3. Методы для работы с потоками

Метод	Описание
`Read(n)`	Считывает из потока `StdIn` заданное параметром n число символов и возвращает полученную строку
`ReadAll()`	Читает символы из потока `StdIn` до тех пор, пока не встретится символ конца файла ASCII 26 (+), и возвращает полученную строку
`ReadLine()`	Возвращает строку, считанную из потока `StdIn`
`Skip(n)`	Пропускает при чтении из потока `StdIn` заданное параметром n число символов
`SkipLine()`	Пропускает целую строку при чтении из потока `StdIn`
`Write(string)`	Записывает в поток `StdOut` или `StdErr` строку `string` (без символа конца строки)
`WriteBlankLines(n)`	Записывает в поток `StdOut` или `StdErr` заданное параметром n число пустых строк
`WriteLine(string)`	Записывает в поток `StdOut` или `StdErr` строку `string` (вместе с символом конца строки)

Напомним, что операционная система Windows поддерживает механизм конвейеризации (символ "|" в командной строке). Этот механизм делает возможным передачу данных от одной программы к другой. Таким образом, используя стандартные входные и выходные потоки, можно из сценария обрабатывать строки вывода другого приложения или перенаправлять выводимые сценарием данные на вход программ-фильтров (

FIND

или

SORT

). Например, следующая команда будет сортировать строки вывода сценария example.js и выводить их в файл sort.txt:

cscript //Nologo example.js | sort > sort.txt

Опция //Nologo здесь нужна для того, чтобы в файл sort.txt не попадали строки с информацией о разработчике и номере версии WSH.

Кроме этого, с помощью методов, работающих с входным потоком StdIn, можно организовывать диалог с пользователем, т. е. создавать интерактивные сценарии. Пример такого сценария представлен в листинге 1.2.

Листинг 1.2. Пример интерактивного сценария

/*******************************************************************/

/* Имя: Interact.js                         */

/* Язык: JScript                          */

/* Описание: Ввод/вывод строк в консольном режиме          */

/*******************************************************************/

var s;

//Выводим строку на экран

WScript.StdOut.Write("Введите число: ");

//Считываем строку

s = WScript.StdIn.ReadLine();

//Выводим строку на экран

WScript.StdOut.WriteLine("Вы ввели число " + s);

/*************  Конец *********************************************/

Объект

WScript

имеет несколько методов, которые описаны в табл. 1.4.

Таблица 1.4. Методы объекта

WScript

Метод	Описание
`CreateObject(strProgID [, strPrefix])`	Создает объект, заданный параметром `strProgID`
`ConnectObject(strObject, strPrefix)`	Устанавливает соединение с объектом `strObject` , позволяющее писать функции-обработчики его событий (имена этих функций должны начинаться с префикса `strPrefix` )
`DisconnectObject(obj)`	Отсоединяет объект `obj` , связь с которым была предварительно установлена в сценарии
`Echo([Arg1] [, Arg2] [,…])`	Выводит текстовую информацию на консоль или в диалоговое окно
`GetObject(strPathname [, strProgID], [strPrefix])`	Активизирует объект автоматизации, определяемый заданным файлом (параметр `strPathName` ), или объект, заданный параметром `strProgID`
`Quit([intErrorCode])`	Прерывает выполнение сценария с заданным параметром `intErrorCode` кодом выхода. Если параметр `intErrorCode` не задан, то объект `WScript` установит код выхода равным нулю
`Sleep(intTime)`	Приостанавливает выполнения сценария (переводит его в неактивное состояние) на заданное параметром `intTime` число миллисекунд

Приведем дополнительные пояснения и примеры использования для методов, приведенных в табл. 1.4.

Метод CreateObject

Строковый параметр

strProgID

, указываемый в методе

CreateObject

, называется программным идентификатором объекта (Programmic Identifier, ProgID).

Если указан необязательный параметр

strPrefix

, то после создания объекта в сценарии можно обрабатывать события, возникающие в этом объекте (естественно, если объект предоставляет интерфейсы для связи с этими событиями). Когда объект сообщает о возникновении определенного события, сервер сценариев вызывает функцию, имя которой состоит из префикса strPrefix
и имени этого события. Например, если в качестве strPrefix
указано "

MYOBJ_

", а объект сообщает о возникновении события "

OnBegin

", то будет запущена функция "

MYOBJ_OnBegin

", которая должна быть описана в сценарии.

В следующем примере метод

CreateObject

используется для создания объекта

WshNetwork

var WshNetwork = WScript.Createobject("WScript.Network");

Отметим, что объекты автоматизации из сценариев можно создавать и без помощи WSH. В JScript для этого используется объект

ActiveXObject

, например:

var WshNetwork = new ActiveXObject("WScript.Network");

В VBscript для создания объектов может использоваться специальная функция

CreateObject

, например:

Set WshNetwork = CreateObject("WScript.Network")

Однако организовать в сценарии обработку событий создаваемого объекта можно только при использовании метода

WScript.CreateObject

Метод ConnectObject

Объект, соединение с которым осуществляется с помощью метода

ConnectObject

, должен предоставлять интерфейс к своим событиям.

В следующем примере в переменной

MyObject

создается абстрактный объект "

SomeObject

", затем из сценария вызывается метод

SomeMetod

этого объекта. После этого устанавливается связь с переменной

MyObject

и задается префикс "

MyEvent

" для процедур обработки события этого объекта. Если в объекте возникнет событие с именем "

Event

", то будет вызвана функция

MyEvent_Event

. Метод

DisconnectObject

объекта

WScript

производит отсоединение объекта

MyObject

var MyObject = WScript.CreateObject("SomeObject");

MyObject.SomeMethod();

WScript.ConnectObject(MyObject, "MyEvent");

function MyEvent_Event(strName) {

 WScript.Echo(strName);

WScript.DisconnectObject(MyObject);

Метод DisconnectObject

Если соединения с объектом

obj

не было установлено, то метод

DisconnectObject(obj)

не будет производить никаких действий. Пример применения

DisconnectObject

был приведен выше.

Метод Echo

Параметры

Arg1

,
Arg2
задают аргументы для вывода. Если сценарий был запущен с помощью wscript.exe, то метод

Echo

направляет вывод в диалоговое окно, если же для выполнения сценария применяется cscript.exe, то вывод будет направлен на экран (консоль). Каждый из аргументов при выводе будет разделен пробелом. В случае использования cscript.exe вывод всех аргументов будет завершен символом новой строки. Если в методе Echo не задан ни один аргумент, то будет напечатана пустая строка.

Например, после выполнения сценария EchoExample.js (листинг 1.3) с помощью cscript.exe на экран будут выведены пустая строка, три числа и строка текста (рис. 1.10).

Листинг 1.3. Сценарий EchoExample.js

/*******************************************************************/

/* Имя: EchoExample.js                       */

/* Язык: JScript                          */

/* Описание: Использование метода WScript.Echo           */

/*******************************************************************/

WScript.Echo();  //Выводим пустую строку

WScript.Echo(1,2,3); //Выводим числа

WScript.Echo("Привет!"); //Выводим строку

/*************  Конец *********************************************/

Рис. 1.10. Вывод информации с помощью метода Echo

Другие примеры использования метода

Echo

приведены в главе 2 (см. листинги 2.1, 2.2, 2.4 и 2.5).

Метод Sleep

В следующем примере сценарий переводится в неактивное состояние на 5 секунд:

WScript.Echo("Сценарий запущен, отдыхаем...");

WScript.Sleep(5000);

WScript.Echo("Выполнение завершено");

Метод

Sleep

необходимо применять при асинхронной работе сценария и какой-либо другой задачи, например, при имитации нажатий клавиш в активном окне с помощью метода

WshShell.SendKeys

(см. листинги 1.13, 2.31, 2.32).

Объекты-коллекции

В WSH входят объекты, с помощью которых можно получить доступ к коллекциям, содержащим следующие элементы:

□ параметры командной строки запущенного сценария или ярлыка Windows (объекты

WshArguments

WshNamed

WshUnnamed

);

□ значения переменных среды (объект

WshEnvironment

);

□ пути к специальным папкам Windows (объект

WshSpecialFolders

Объект WshArguments

Объект

WshArguments

содержит коллекцию всех параметров командной строки запущенного сценария или ярлыка Windows. Этот объект можно создать только с помощью свойства

Arguments

объектов

WScript

WshShortcut

В принципе, работать с элементами коллекции

WshArguments

можно стандартным для JScript образом — создать объект

Enumerator

и использовать его методы

moveNext

item

atEnd

. Например, вывести на экран все параметры командной строки, с которыми запущен сценарий, можно следующим образом (листинг 1.4).

Листинг 1.4. Вывод всех параметров сценария (стандартные коллекции JScript)

/********************************************************************/

/* Имя: EnumArgs.js                         */

/* Язык: JScript                           */

/* Описание: Вывод на экран параметров запущенного сценария     */

/********************************************************************/

var objArgs, e, x;

objArgs = WScript.Arguments; //Создаем объект WshArguments

//Создаем объект Enumerator для коллекции objArgs

e = new Enumerator(objArgs);

for (;!e.atEnd();e.moveNext()) {

 x = e.item();  //Получаем значение элемента коллекции

 WScript.Echo(x); //Выводим значение параметра на экран

/*************  Конец *********************************************/

Однако намного удобнее использовать методы

Count

Item

самого объекта

WshArguments

(метод

Item

имеется у всех коллекций WSH). Метод

Count

возвращает число элементов в коллекции, т. е. количество аргументов командной строки, а метод

Item(n)

— значение n-го элемента коллекции (нумерация начинается с нуля). Более того, чтобы получить значение отдельного элемента коллекции

WshArguments

, можно просто указать его индекс в круглых скобках после имени объекта.

Замечание

Число элементов в коллекции хранится и в свойстве

Length

объекта

WshArguments

Таким образом, предыдущий пример можно переписать более компактным образом (листинг 1.5).

Листинг 1.5. Вывод всех параметров сценария (методы WSH)

/*******************************************************************/

/* Имя: ShowArgs.js                         */

/* Язык: JScript                          */

/* Описание: Вывод на экран параметров запущенного сценария     */

/*******************************************************************/

var i, objArgs;

objArgs = WScript.Arguments; //Создаем объект WshArguments

for (i=0; i<=objArgs.Count()-1; i++)

 WScript.Echo(objArgs(i)); //Выводим на экран i-й аргумент

/*************  Конец *********************************************/

С помощью объекта

WshArguments

можно также выделять и отдельно обрабатывать аргументы сценария, у которых имеются имена (например,

/Name:Andrey

) и безымянные аргументы. Ясно, что использование именных параметров более удобно, т. к. в этом случае нет необходимости запоминать, в каком порядке должны быть записаны параметры при запуске того или иного сценария.

Для доступа к именным и безымянным аргументам используются соответственно два специальных свойства объекта

WshArguments

Named

Unnamed

Свойство

Named

содержит ссылку на коллекцию

WshNamed

, свойство

Unnamed

— на коллекцию

WshUnnamed

Таким образом, обрабатывать параметры командной строки запущенного сценария можно тремя способами:

□ просматривать полный набор всех параметров (как именных, так и безымянных) с помощью коллекции

WshArguments

;

□ выделить только те параметры, у которых есть имена (именные параметры) с помощью коллекции

WshNamed

;

□ выделить только те параметры, у которых нет имен (безымянные параметры) с помощью коллекции

WshUnnamed

У объекта

WshArguments

имеется еще один метод

ShowUsage

. Этот метод служит для вывода на экран информации о запущенном сценарии (описание аргументов командной строки, пример запуска сценария и т.д.). В свою очередь, подобную информацию можно задать только при использовании WSH-сценариев с разметкой XML; более подробно о применении метода

ShowUsage

идет речь в главе 3 при рассмотрении элементов

Объект WshNamed

Объект

WshNamed

содержит коллекцию параметров командной строки запущенного сценария, у которых имеется уникальное имя (именные параметры). В WSH 5.6 именной параметр всегда начинается с символа "/", после чего приводится имя этого параметра, затем ставится двоеточие ":" и пишется значение параметра, например:

/Name:Andrey

В качестве значения именного параметра рассматривается набор символов, начинающихся после двоеточия и заканчивающихся перед первым встретившимся пробелом. Для того чтобы значением параметра командной строки была строка, состоящая из нескольких слов, необходимо заключить эту строку в кавычки. Например:

/Name:"Andrey Popov"

Создается объект WshNamed с помощью свойства

Named

коллекции

WshArguments

. Для того чтобы получить значение определенного аргумента, его имя используется в качестве индекса коллекции.

Замечание

Узнать число именных параметров можно только с помощью свойства

Length

коллекции

WshNamed

; метода

Count

у этой коллекции нет.

Например, пусть сценарий MyScript.js запущен с двумя именными параметрами:

MyScript.js /User:Andrey /Computer:Server1

Тогда вывести на экран значение параметров Name и Computer можно двумя способами:

var objNamedArgs;

objNamedArgs=WScript.Arguments.Named;

WScript.Echo("Имя пользователя: "+objNamedArgs.Item("User"));

WScript.Echo("Имя компьютера: "+objNamedArgs.Item ("Computer"));

или просто

var objNamedArgs;

objNamedArgs=WScript.Arguments.Named;

WScript.Echo("Имя пользователя: "+objNamedArgs("User"));

WScript.Echo("Имя компьютера: "+objNamedArgs("Computer"));

Отметим также, что значением именного параметра, как и безымянного, может служить целая строка, состоящая из нескольких литералов и заключенная в кавычки, например:

MyScript.js /User:"Andrey Popov" /Computer:Server1

Тогда в результате выполнения в сценарии MyScript.js следующей строки:

WScript.Echo("Имя пользователя: "+ WScript.Arguments.Named("User"));

на экран будет выведено

Имя пользователя: Andrey Popov

Для того чтобы узнать, был ли указан при запуске сценария тот или иной именной параметр, используется метод

Exists

объекта

WshNamed

. Например,

if (WScript.Arguments.Named.Exists("User"))

 WScript.Echo("Имя пользователя: "+ WScript.Arguments.Named("User"));

Примеры, иллюстрирующие использование объекта WshNamed, приведены также в главе 2 (см. листинги 2.22 и 2.23).

Объект WshUnnamed

В коллекции

WshUnnamed

содержатся параметры командной строки запущенного сценария, у которых нет имени (безымянные параметры). Создается этот объект с помощью свойства

Unnamed

коллекции

WshArguments

. Для того чтобы получить значение определенного аргумента, его номер используется в качестве индекса коллекции (нумерация начинается с нуля).

Замечание

Узнать число безымянных параметров можно только с помощью свойства

Length

коллекции

WshUnnamed

; метода

Count

у этой коллекции нет.

Например, сценарий MyScript.js запущен с двумя безымянными параметрами:

MyScript.js "Andrey Popov" Server1

Тогда после выполнения в сценарии MyScript.js любого из следующих двух блоков:

var objUnnamedArgs;

obUnnamedArgs=WScript.Arguments.Unnamed;

WScript.Echo("Имя пользователя: "+objUnnamedArgs.Item(0));

WScript.Echo("Имя компьютера: "+objUnnamedArgs.Item(1));

или

var objUnnamedArgs;

obUnnamedArgs=WScript.Arguments.Unnamed;

WScript.Echo("Имя пользователя: "+objUnnamedArgs(0));

WScript.Echo("Имя компьютера: "+objUnnamedArgs(1));

на экран выведутся следующие строки:

Имя пользователя: Andrey Popov

Имя компьютера: Server1

Примеры, иллюстрирующие использование объекта

WshUnnamed

, приведены также в главе 2 (см. листинги 2.22 и 2.23).

Объект WshEnvironment

Объект

WshEnvironment

позволяет получить доступ к коллекции, содержащей переменные среды заданного типа (переменные среды операционной системы, переменные среды пользователя или переменные среды текущего командного окна). Этот объект можно создать с помощью свойства

Environment

объекта

WshShell

или одноименного его метода:

var WshShell=WScript.Createobject("WScript.Shell"),

 WshSysEnv=WshShell.Environment,

 WshUserEnv=WshShell.Environment("User");

Объект

WshEnvironment

имеет свойство

Length

, в котором хранится число элементов в коллекции (количество переменных среды), и методы

Count

Item

. Для того чтобы получить значение определенной переменной среды, в качестве аргумента метода

Item

указывается имя этой переменной в двойных кавычках. В следующем примере мы выводим на экран значение переменной среды

PATH

var WshShell=WScript.CreateObject("WScript.Shell"), WshSysEnv=WshShell.Environment;

WScript.Echo("Системный путь:", WshSysEnv.Item("PATH"));

Можно также просто указать имя переменной в круглых скобках после имени объекта:

WScript.Echo("Системный путь:",WshSysEnv("PATH");

Кроме этого, у объекта WshEnvironment имеется метод Remove(strName), который удаляет заданную переменную среды. Например, в листинге 1.6 приведен сценарий, который удаляет две переменные (

EXAMPLE_1

EXAMPLE_2

) из окружения среды пользователя.

Замечание

Если в окружении среды пользователя нет переменных с именами

EXAMPLE_1

EXAMPLE_2

, то при вызове метода

Remove

произойдет ошибка.

Листинг 1.6. Удаление переменных среды

/*******************************************************************/

/* Имя: RemEnv.js                          */

/* Язык: JScript                          */

/* Описание: Удаление двух переменных среды             */

/*******************************************************************/

//Создаем объект WshShell

var WshShell = WScript.CreateObject("WScript.Shell");

//Создаем объект WshEnvironment

var WshUsrEnv = WshShell.Environment("User");

//Удаляем переменные среды

WshUsrEnv.Remove("EXAMPLE_1");

WshUsrEnv.Remove("EXAMPLE_2");

/*************  Конец *********************************************/

Объект WshSpecialFolders

Объект

WshSpecialFolders

обеспечивает доступ к коллекции, содержащей пути к специальным папкам Windows (например, к рабочему столу или к меню Пуск (Start)); задание путей к таким папкам может быть необходимо, например, для создания непосредственно из сценария ярлыков на рабочем столе.

В Windows 9х поддерживаются следующие имена специальных папок:

□ Desktop;

□ Favorites;

□ Fonts;

□ MyDocuments;

□ NetHood;

□ PrintHood;

□ Programs;

□ Recent;

□ SendTo;

□ StartMenu;

□ Startup;

□ Templates.

В Windows NT/2000/XP дополнительно можно получить доступ еще к четырем папкам, которые хранят данные для всех пользователей:

□ AllUsersDesktop;

□ AllUsersStartMenu;

□ AllUsersPrograms;

□ AllUsersStartup.

Объект

WshSpecialFolders

создается c помощью свойства

SpecialFolders

объекта

WshShell

var WshShell=WScript.CreateObject("WScript.Shell"),

 WshSpecFold=WshShell.SpecialFolders;

Как и почти все коллекции WSH, объект

WshSpecialFolders

имеет свойство

Length

и методы

Count

Item

. Доступ к отдельному элементу производится либо через имя соответствующей папки, либо через числовой индекс (Листинг 1.7).

Листинг 1.7. Обработка коллекции

WshSpecialFolders

/*******************************************************************/

/* Имя: ShowSpecFold.js                       */

/* Язык: JScript                          */

/* Описание: Вывод на экран названий специальных папок Windows   */

/*      (коллекция WshSpecialFolders)             */

/*******************************************************************/

var WshShell, WshFldrs, i;

//Создаем объект WshShell

WshShell = WScript.CreateObject("Wscript.Shell");

//Создаем объект WshSpecialFolders

WshFldrs = WshShell.SpecialFolders;

WScript.Echo("Некоторые специальные папки...");

//Выводим путь к папке Desktop

WScript.Echo("Desktop="+ WshFldrs.item("Desktop"));

//Выводим путь к папке Favorities

WScript.Echo("Favorites="+ WshFldrs("Favorites"));

//Выводим путь к папке Programs

WScript.Echo("Programs="+ WshFldrs("Programs"));

WScript.Echo("");

WScript.Echo("Список всех специальных папок...");

for (i=0;i<= WshFldrs.Count()-1;i++){

 //Выводим на экран i-й элемент коллекции WshFldrs

 WScript.Echo(WshFldrs(i));

/*************  Конец *********************************************/

Другие примеры работы со специальными папками Windows приведены в главе 2 (см. листинги 2.39–2.42).

Работа с сетью и оболочкой Windows

Для работы с локальной сетью и оболочкой Windows (специальные папки, переменные среды, системный реестр) предназначены соответственно объекты

WshNetwork

WshShell

Объект WshNetwork

Объект

WshNetwork

предназначен для работы с ресурсами локальной сети; с помощью методов этого объекта можно подключать и отключать сетевые диски и принтеры.

Объект

WshNetwork

создается следующим образом:

var objNet=WScript.CreateObject("WScript.Network");

Свойства данного объекта приведены в табл. 1.5.

Таблица 1.5. Свойства объекта

WshNetwork

Свойство	Описание
`ComputerName`	Содержит имя компьютера, на котором запущен сценарий
`UserDomain`	Содержит имя домена, в котором зарегистрировался пользователь
`UserName`	Содержит имя пользователя

Листинг 1.8. Пример использования объекта

WshNetwork

/*******************************************************************/

/* Имя: ShowNetwork.js                       */

/* Язык: JScript                          */

/* Описание: Вывод на экран сетевого имени компьютера и имени    */

/*      пользователя                      */

/*******************************************************************/

var objNet;

//Создаем объект WshNetwork

objNet = WScript.CreateObject("WScript.Network");

//Выводим на экран свойства ComputerName и UserName

WScript.Echo("Имя машины:",objNet.ComputerName);

WScript.Echo("Имя пользователя:",objNet.UserName);

/*************  Конец *********************************************/

Методы объекта

WshNetwork

описаны в табл. 1.6.

Таблица 1.6. Методы объекта

WshNetwork

Метод	Описание
`AddPrinterConnection(strLocalName, strRemoteName [ ,bUpdateProfile] [,strUser] [,strPassword])`	Подключает локальный порт компьютера к сетевому принтеру
Для Windows NT/2000/XP: `AddWindowsPrinterConnection(strPrnPath)` Для Windows 9x: `AddWindowsPrinterConnection(strPrnPath, strDriverName[, strPort])`	Регистрирует принтер в Windows и подключает его к сетевому ресурсу. В отличие от `AddPrinterConnection` , этот метод позволяет создать связь с сетевым принтером без явного перенаправления вывода в локальный порт
`EnumNetworkDrives()`	Возвращает коллекцию, в которой хранятся буквы и сетевые пути ко всем подключенным сетевым дискам
`EnumPrinterConnections()`	Возвращает коллекцию, в которой хранятся данные обо всех подключенных сетевых принтерах
`MapNetworkDrive(strLocalName, strRemoteName, [bUpdateProfile], [strUser], [strPassword])`	Подключает сетевой ресурс `strRemoteName` под локальным именем диска `strLocalName`
`RemoveNetworkDrive(strName, [bForce], [bUpdateProfile])`	Отключает подключенный сетевой диск
`RemovePrinterConnection(strName, [bForce], [bUpdateProfile])`	Отключает подключенный сетевой принтер
`SetDefaultPrinter(strPrinterName)`	Делает заданный сетевой принтер принтером по умолчанию

Опишем методы из табл. 1.6 более подробно.

Метод AddPrinterConnection

Если необязательный параметр

bUpdateProfile

равен

True

, то создаваемое сетевое подключение будет сохранено в профиле пользователя.

Параметры

strUser

(имя пользователя) и strPassword
(пароль) нужны в том случае, когда вы подключаете сетевой принтер от имени пользователя, которое отличается от имени текущего пользователя, зарегистрированного в системе.

В следующем примере метод

AddPrinterConnection

применяется для подключения принтера с сетевым именем

\\Server1\Epson

к локальному порту

LPT1

var WshNetwork = CreateObject("WScript.Network");

WshNetwork.AddPrinterConnection("LPT1", "\\Server1\Epson");

Метод AddWindowsPrinterConnection

Параметр

strDriverName

указывает имя драйвера, необходимого для подключаемого принтера. Если принтер подключается в операционной системе Windows 9х, то нужный драйвер уже должен быть установлен на этой машине, иначе возникнет ошибка подключения. В Windows NT/2000/XP параметр strDriverName
игнорируется.

Параметр

strPort

задает в явном виде порт, вывод в который будет перенаправлен на сетевой ресурс (по умолчанию это порт

LPT1

). В Windows NT/2000/XP параметр strPort
игнорируется.

В следующем примере метод

AddWindowsPrinterConnection

применяется для подключения сетевого принтера к локальному порту

LPT1

(по умолчанию):

var WshNetwork=CreateObject("WScript.Network");

PrinterPath="\\printserv\DefaultPrinter";

PrinterDriver="Lexmark Optra S 1650";

WshNetwork.AddwindowsPrinterConnection(PrinterPath, PrinterDriver);

Метод EnumNetworkDrives

Элементами возвращаемой коллекции являются буквы, обозначающие имеющиеся сетевые диски и сетевые имена ресурсов, к которым эти диски подключены. Первым элементом коллекции является буква, вторым — сетевое имя; эта последовательность сохраняется для всех сетевых дисков в коллекции.

В следующем примере на экран выводятся буквы, обозначающие все сетевые диски и имена ресурсов, к которым они подключены (листинг 1.9).

Листинг 1.9. Пример использования метода

EnumNetworkDrives

/*******************************************************************/

/* Имя: ShowNetDrives.js                      */

/* Язык: JScript                          */

/* Описание: Вывод на экран букв сетевых дисков и имен       */

/*      соответствующих ресурсов                */

/*******************************************************************/

var WshNetwork,oDrives,i;

//Создаем объект WshNetwork

WshNetwork = WScript.CreateObject("WScript.Network");

//Создаем коллекцию с информацией о сетевых дисках

oDrives = WshNetwork.EnumNetworkDrives();

for (i=0; i<=oDrives.Count()-1; i++)

 WScript.Echo(oDrives.Item(i)); //Вывод i-го элемента коллекции

/*************  Конец *********************************************/

Метод EnumPrinterConnections

Элементами возвращаемой коллекции являются названия локальных портов и сетевые имена принтеров, связанных с этими портами. Сама коллекция организована так же, как и коллекция, возвращаемая методом

EnumNetworkDrives

В следующем примере на экран выводятся названия всех переназначенных портов и имена сетевых ресурсов, с которыми они связаны (листинг 1.10).

Листинг 1.10. Пример использования метода

EnumPrinterConnections

/*******************************************************************/

/* Имя: ShowNetPrn.js                        */

/* Язык: JScript                          */

/* Описание: Вывод на экран переназначенных портов и имен      */

/*      соответствующих ресурсов                */

/*******************************************************************/

//Создаем объект WshNetwork

var WshNetwork = WScript.CreateObject("WScript.Network");

//Создаем коллекцию с информацией о подключенных принтерах

var oPrinters = WshNetwork.EnumPrinterConnections();

for (i=0; i<=oPrinters.Count()-1; i++)

 WScript.Echo(oPrinters.Item(i)); //Вывод i-го элемента коллекции

/*************  Конец *********************************************/

Метод MapNetworkDrive

Если необязательный параметр

bUpdateProfile

равен

True

, то создаваемое сетевое подключение будет сохранено в профиле пользователя.

Параметры

strUser

(имя пользователя) и strPassword
(пароль) нужны в том случае, когда вы подключаете сетевой диск от имени пользователя, которое отличается от имени текущего пользователя, зарегистрированного в системе.

В следующем примере диск "

" подключается к сетевому ресурсу \\Server1\Programs:

var WshNetwork = WScript.CreateObject("WScript.Network");

WshNetwork.MapNetworkDrive("Z:","\\Server1\Programs");

Метод RemoveNetworkDrive

В качестве параметра

strName

может быть указано либо локальное имя (буква сетевого диска), либо сетевое имя (имя подключенного сетевого ресурса); это зависит от того, каким образом осуществлялось подключение. Если сетевому ресурсу сопоставлена буква локального диска, то параметр strName
должен быть локальным именем. Если сетевому ресурсу не сопоставлена никакая буква, то параметр strName
должен быть сетевым именем.

Если необязательный параметр

bForce

равен

True

, то отключение сетевого ресурса будет произведено вне зависимости от того, используется этот ресурс в настоящее время или нет.

Если необязательный параметр

bUpdateProfile

равен

True

, то отключаемое сетевое подключение будет удалено из профиля пользователя.

В следующем примере производится подключение диска "z" к сетевому ресурсу, а затем отключение этого ресурса (листинг 1.11).

Листинг 1.11. Пример подключения и отключения сетевого диска

/*******************************************************************/

/* Имя: MapDrive.js                         */

/* Язык: JScript                          */

/* Описание: Подключение/отключение сетевого ресурса        */

/*******************************************************************/

//Создаем объект WshNetwork

var WshNetwork = WScript.CreateObject("WScript.Network");

//Подключаем сетевой диск Z:\ к \\Server1\Programs

WshNetwork.MapNetworkDrive("Z:","\\Server1\Programs");

//Отключаем сетевой диск Z:\

WshNetwork.RemoveNetworkDrive("Z:");

/*************  Конец *********************************************/

Метод RemovePrinterConnection

В качестве параметра

strName

может быть указано либо локальное имя (название порта), либо сетевое имя (имя подключенного сетевого принтера); это зависит от того, каким образом осуществлялось подключение. Если сетевому ресурсу явным образом сопоставлен локальный порт (например, LPT1), то параметр strName
должен быть локальным именем. Если сетевому принтеру не сопоставлен локальный порт, то параметр strName
должен быть сетевым именем.

Параметры

bForce

и bUpdateProfile
в этом методе имеют то же значение, что и одноимённые параметры в методе

RemoveNetworkDrive

В следующем примере отключается сетевой принтер, который был назначен на порт

LPT1

var WshNetwork = WScript.CreateObject("WScript.Network");

WshNetwork.RemovePrinterConnection("LPT1:");

Метод SetDefaultPrinter

Параметр

strName

задает сетевое имя принтера, который должен будет использоваться в системе по умолчанию.

В следующем примере с помощью метода

AddPrinterConnection

к порту LPT1: подключается сетевой принтер \\Server1\Epson, который затем устанавливается принтером по умолчанию (листинг 1.12).

Листинг 1.12. Пример использования метода

SetDefaultPrinter

/*******************************************************************/

/* Имя: DefPrn.js                          */

/* Язык: JScript                          */

/* Описание: Установка принтера по умолчанию            */

/*******************************************************************/

//Создаем объект WshNetwork

var WshNetwork = WScript.CreateObject("WScript.Network");

//Подключаем к LPT1 сетевой принтер \\Server1\Epson

WshNetwork.AddPrinterConnection("LPT1:","\\Server1\Epson");

//Устанавливаем принтер по умолчанию

WshNetwork.SetDefaultPrinter("\\Server1\Epson");

/*************  Конец *********************************************/

Другие примеры, иллюстрирующие использование объекта

WshNetwork

, приведены в главе 2 (см. листинги 2.47–2.52).

Объект WshShell

С помощью объекта

WshShell

можно запускать новый процесс, создавать ярлыки, работать с системным реестром, получать доступ к переменным среды и специальным папкам Windows. Создается этот объект следующим образом:

var WshShell=WScript.CreateObject("WScript.Shell");

Объект

WshShell

имеет три свойства, которые приведены в табл. 1.7.

Таблица 1.7. Свойства объекта

WshShell

Свойство	Описание
`CurrentDirectory`	Здесь хранится полный путь к текущему каталогу (к каталогу, из которого был запущен сценарий)
`Environment`	Содержит объект `WshEnvironment` , который обеспечивает доступ к переменным среды операционной системы для Windows NT/2000/XP или к переменным среды текущего командного окна для Windows 9х
`SpecialFolders`	Содержит объект `WshSpecialFolders` для доступа к специальным папкам Windows (рабочий стол, меню Пуск (Start) и т.д.)

Опишем теперь методы, имеющиеся у объекта

WshShell

(табл. 1.8).

Таблица 1.8. Методы объекта

WshShell

Метод	Описание
`AppActivate(title)`	Активизирует заданное параметром `title` окно приложения. Строка `title` задает название окна (например, "calc" или "notepad") или идентификатор процесса (ProcessID, PID)
`CreateShortcut(strPathname)`	Создает объект `WshShortcut` для связи с ярлыком Windows (расширение lnk) или объект `WshUrlShortcut` для связи с сетевым ярлыком (расширение url). Параметр `strPathname` задает полный путь к создаваемому или изменяемому ярлыку
`Environment(strType)`	Возвращает объект `WshEnvironment` , содержащий переменные среды заданного вида
`Exec(strCommand)`	Создает новый дочерний процесс, который запускает консольное приложение, заданное параметром `strCommand` . В результате возвращается объект `WshScriptExec` , позволяющий контролировать ход выполнения запущенного приложения и обеспечивающий доступ к потокам `StdIn` , `StdOut` и `StdErr` этого приложения
`ExpandEnvironmentStrings(strString)`	Возвращает значение переменной среды текущего командного окна, заданной строкой `strString` (имя переменной должно быть окружено знаками "%")
`LogEvent(intType, strMessage [ ,strTarget])`	Протоколирует события в журнале Windows NT/2000/XP или в файле WSH.log. Целочисленный параметр `intТуре` определяет тип сообщения, строка `strMessage` — текст сообщения. Параметр `strTarget` может задаваться только в Windows NT/2000/XP, он определяет название системы, в которой протоколируются события (по умолчанию это локальная система). Метод `LogEvent` возвращает `true` , если событие записано успешно и `false` в противном случае
`Popup(strТехt, [nSecToWait] , [strTitle], [nType])`	Выводит на экран информационное окно с сообщением, заданным параметром `strText` . Параметр `nSecToWait` задает количество секунд, по истечении которых окно будет автоматически закрыто, параметр `strTitle` определяет заголовок окна, параметр `nType` указывает тип кнопок и значка для окна
`RegDelete(strName)`	Удаляет из системного реестра заданный параметр или раздел целиком
`RegRead(strName)`	Возвращает значение параметра реестра или значение по умолчанию для раздела реестра
`RegWrite(strName, anyValue [,strType])`	Записывает в реестр значение заданного параметра или значение по умолчанию для раздела
`Run(strCommand, [intWindowStyle], [bWaitOnReturn])`	Создает новый независимый процесс, который запускает приложение, заданное параметром `strCommand`
`SendKeys(string)`	Посылает одно или несколько нажатий клавиш в активное окно (эффект тот же, как если бы вы нажимали эти клавиши на клавиатуре)
`SpecialFolders(strSpecFolder)`	Возвращает строку, содержащую путь к специальной папке Windows, заданной параметром `strSpecFolder`

Рассмотрим методы, приведенные в табл. 1.8, более подробно.

Метод АррActivate

Метод

AppActivate

активизирует уже запущенное указанное приложение (устанавливает на него фокус), но не производит никаких действий по изменению размеров его окна. Для того чтобы первоначально запустить нужное приложение и определить вид его окна, следует использовать метод

Run

объекта

WshShell

. Для того чтобы определить, какое именно приложение необходимо активизировать, строка title
сравнивается по очереди с названиями окон всех запущенных приложений. Если не найдено ни одного точного совпадения, будет производиться поиск того приложения, название окна которого начинается со строки title
. Если и в этом случае не будет найдено ни одного подходящего приложения, то будет вестись поиск приложения, заголовок которого заканчивается на эту строку. Если будет найдено несколько подходящих окон, то произойдет активизация одного из них (окно выбирается произвольно).

В качестве примера использования метода

AppActivate

в листинге 1.13 приведен сценарий RunCalc.js, который запускает стандартный калькулятор Windows и выполняет в нем несколько простых арифметических действий (для этого используется метод

SendKeys

Листинг 1.13. Сценарий RunCalc.js

/*****************************************************************/

/* Имя: RunCalc.js                        */

/* Язык: JScript                         */

/* Описание: Активизация приложения с помощью имени окна     */

/*****************************************************************/

//Создаем объект WshShell

var WshShell = WScript.CreateObject("WScript.Shell");

//Запускаем Калькулятор

WshShell.Run("calc");

//Приостанавливаем сценарий на 0,1 секунды

WScript.Sleep(100);

//Активизируем Калькулятор

WshShell.AppActivate("Calculator");

//Приостановка сценария на 0,1 секунды

WScript.Sleep(100);

//Посылаем нажатия клавиш в Калькулятор

WshShell.SendKeys("1{+}");

WScript.Sleep(500);

WshShell.SendKeys("2");

WScript.Sleep(500);

WshShell.SendKeys("~");

WScript.Sleep(2500);

/*************  Конец *********************************************/

В главе 2 приведены другие примеры использования метода

AppActivate

(см. листинги 2.31 и 2.32).

Метод CreateShortcut

Этот метод позволяет создать новый или открыть уже существующий ярлык для изменения его свойств.

В листинге 1.14 приведен пример сценария, в котором создаются два ярлыка — на сам выполняемый сценарий (объект

oShellLink

и на сетевой ресурс (

oUrlLink

Листинг 1.14. Пример использования метода

CreateShortcut

/*****************************************************************/

/* Имя: MakeShortcuts.js                     */

/* Язык: JScript                         */

/* Описание: Создание ярлыков из сценария             */

/*****************************************************************/

var WshShell,oShellLink,oUrlLink;

//Создаем объект WshShell

WshShell=WScript.CreateObject("WScript.Shell");

//Создаем ярлык на файл

oShellLink=WshShell.CreateShortcut("Current Script.lnk");

//Устанавливаем путь к файлу

oShellLink.TargetPath=WScript.ScriptFullName;

//Сохраняем ярлык

oShellLink.Save();

//Создаем ярлык на сетевой ресурс

oUrlLink = WshShell.CreateShortcut("Microsoft Web Site.URL");

//Устанавливаем URL

oUrlLink.TargetPath = "http://www.microsoft.com";

//Сохраняем ярлык

oUrlLink.Save();

/*************  Конец *********************************************/

Примеры работы с ярлыками приведены в листингах 1.19–1.24, 2.43 и 2.44.

Метод Environment

Параметр

strType

задает вид переменных среды, которые будут записаны в коллекции

WshEnvironment

; возможными значениями этого параметра являются "System" (переменные среды операционной системы), "User" (переменные среды пользователя), "Volatile" (временные переменные) или "Process" (переменные среды текущего командного окна).

Замечание

Для Windows 9х единственным допустимым значением параметра

strType

является "Process".

В следующем примере мы распечатываем число процессоров, имеющихся в компьютере с операционной системой Windows NT/2000/XP (переменная

NUMBER_OF_PROCESSORS

), и путь к каталогу Windows (листинг 1.15).

Листинг 1.15. Печать значений переменных среды (объект

WshShell.Environment

)

/*****************************************************************/

/* Имя: ShowEnvir.js                       */

/* Язык: JScript                         */

/* Описание: Получение значений некоторых переменных среды    */

/*****************************************************************/

var WshShell,WshSysEnv;

//Создаем объект WshShell

WshShell = WScript.CreateObject("WScript.Shell");

//Создание коллекции WshEnvironment

WshSysEnv = WshShell.Environment("SYSTEM");

WScript.Echo(WshSysEnv("NUMBER_OF_PROCESSORS"));

WScript.Echo(WshShell.Environment.Item("WINDIR"));

/*************  Конец *********************************************/

Метод ExpandEnvironmentString

В следующем примере на экран выводится путь к каталогу Windows (листинг 1.16).

Листинг 1.16. Печать значений переменных среды (

ExpandEnvironmertStrings

)

/*****************************************************************/

/* Имя: ExpEnvStr.js                       */

/* Язык: JScript                         */

/* Кодировка: Windows                       */

/* Описание: Получение значений переменный среды  с помощью    */

/*      метода ExpandEnvironmentString            */

/*****************************************************************/

var WS = WScript.CreateObject("WScript.Shell");

WScript.Echo("Каталог Windows:"+WS.ExpandEnvironmentStrings("%WinDir%"));

/*************  Конец *********************************************/

Метод LogEvent

В Windows NT/2000/XP события записываются в системном журнале, а в Windows 9х — в файле WSH.log, расположенном в каталоге пользователей Windows. Запись в WSH.log будет содержать время события, его тип и текст. Типы сообщений описаны в табл. 1.9.

Таблица 1.9. Типы сообщений (параметр

intType

)

Код	Значение	Код	Значение
0	`SUCCESS`	4	`INFORMATION`
1	`ERROR`	8	`AUDIT_SUCCESS`
2	`WARNING`	16	`AUDIT_FAILURE`

В следующем примере производится протоколирование работы сценария регистрации (здесь предполагается, что если этот сценарий отработал успешно, то функция

RunLoginScript

возвращает true, в противном случае —

false

var WshShell = WScript.CreateObject("WScript.Shell");

rc = RunLoginScript();

if (rc) WshShell.LogEvent(0,"Logon Script Completed Successfully");

else WshShell.LogEvent(1,"Logon Script failed");

Метод Popup

Если в методе не задан параметр

strTitle

, то по умолчанию заголовком окна будет "Windows Script Host."

Параметр

nType

может принимать те же значения, что и в функции

MessageBox

из Microsoft Win32 API. В табл. 1.10 описаны некоторые возможные значения параметра nType и их смысл (полный список значений этого параметра можно посмотреть в описании функции MessageBox в документации по функциям Windows API).

Таблица 1.10. Типы кнопок и иконок для метода

Popup

Значение `nType`	Константа Visual Basic	Описание
0	`vbOkOnly`	Выводится кнопка `OK`
1	`vbOkCancel`	Выводятся кнопки `OK` и `Отмена` (Cancel)
2	`vbAbortRetryIgnore`	Выводятся кнопки Стоп (Abort), Повтор (Retry) и Пропустить (Ignore)
3	`vbYesNoCancel`	Выводятся кнопки Да (Yes), Нет (No) и Отмена (Cancel)
4	`vbYesNo`	Выводятся кнопки Да (Yes) и Нет (No)
5	`vbRetryCancel`	Выводятся кнопки Повтор (Retry) и Отмена (Cancel)
16	`vbCritical`	Выводится значок Stop Mark
32	`vbQuestion`	Выводится значок Question Mark
48	`vbExclamation`	Выводится значок Exclamation Mark
64	`vbInformation`	Выводится значок Information Mark

Замечание

В сценариях, написанных на языке VBScript, можно непосредственно использовать именованные константы типа

vbOkCancel

без предварительного их объявления. Для того чтобы использовать такие константы в JScript-сценариях, их нужно предварительно объявить как переменные и присвоить нужные значения (например,

var vbOkCancel=1;

). Естественно, в любых сценариях вместо имен констант можно использовать их числовые значения.

В методе

Popup

можно комбинировать значения параметра, приведенные в табл. 1.10. Например, в результате выполнения следующего сценария:

var WshShell = WScript.CreateObject("WScript.Shell");

WshShell.Popup("Копирование завершено успешно", 5, "Ура",65);

на экран будет выведено информационное окно, показанное на рис. 1.11, которое автоматически закроется через 5 секунд.

Рис. 1.11. Информационное окно, созданное методом

Popup

Метод Popup возвращает целое значение, с помощью которого можно узнать, какая именно кнопка была нажата для выхода (табл. 1.11).

Таблица 1.11. Возвращаемые методом

Popup

значения


nSecToWait
vbOk
vbCancel
vbAbort
vbRetry
vbIgnore
vbYes
vbNo

Значение	Константа Visual Basic	Описание
-1		Пользователь не нажал ни на одну из кнопок в течение времени, заданного параметром `nSecToWait`
1	`vbOk`	Нажата кнопка OK
2	`vbCancel`	Нажата кнопка Отмена (Cancel)
3	`vbAbort`	Нажата кнопка Стоп (Abort)
4	`vbRetry`	Нажата кнопка Повтор (Retry)
5	`vbIgnore`	Нажата кнопка Пропустить (Ignore)
6	`vbYes`	Нажата кнопка Да (Yes)
7	`vbNo`	Нажата кнопка Нет (No)

Примеры вывода информации с помощью метода

Popup

представлены в главе 2 (см. листинги 2.13 и 2.14).

Метод RegDelete

Если параметр

strName

оканчивается символами

\\

, то этот метод удаляет ключ целиком (вместе со всеми параметрами внутри его), в противном случае удаляется только один заданный параметр. Параметр strName
должен начинаться с одного из следующих корневых ключей (табл. 1.12).

Таблица 1.12. Названия ключей

Краткое название	Длинное название
`HCKU`	`HKEY_CURRENT_USER`
`HKLM`	`HKEY_LOCAL_MACHINE`
`HKCR`	`HKEY_CLASSES_ROOT`
	`HKEY_USERS`
	`HKEY_CURRENT_CONFIG`

Пример, иллюстрирующий применение метода

RegDelete

, приведен в главе 2 (см. листинги 2.45 и 2.46).

Метод RegRead

С помощью этого метода можно прочитать следующие типы данных:

REG_SZ

REG_EXPAND_SZ

REG_DWORD

REG_BINARY

REG_MULTI_SZ

. Если в реестре содержатся данные других типов, то метод

RegRead

вернет значение

DISP_E_TYPEMISMATCH

Если параметр

strName

оканчивается символами

\\

, то этот метод считывает значение по умолчанию для раздела (если оно установлено), в противном случае читается значение параметра.

В следующем примере на экран выводятся считанные из реестра с помощью метода

RegRead

значение параметра и значение по умолчанию для раздела реестра (листинг 1.17).

Листинг 1.17. Чтение значений параметра и раздела системного реестра

/********************************************************************/

/* Имя: RegRead.js                          */

/* Язык: JScript                           */

/* Описание: Чтение значений параметра и раздела системного реестра */

/********************************************************************/

var WS,s;

//Создаем объект WshShell

WS = WScript.CreateObject("WScript.Shell");

s="Значение параметра\n";

s+="HKCU\\Control Panel\\Keyboard\\KeyboardSpeed = ";

//Читаем значение параметра реестра

s+=WS.RegRead("HKCU\\Control Panel\\Keyboard\\KeyboardSpeed")+"\n\n";

s+="Значение по умолчанию для раздела\n";

s+="HKCU\\Control Panel\\Keyboard\\ = ";

//Читаем значение по умолчанию для раздела реестра

s+=WS.RegRead("HKCU\\Control Panel\\Keyboard\\");

//Вывод на экран сформированной строки

WScript.Echo(s);

/*************  Конец ***********************************************/

Метод RegWrite

Если параметр

strName

оканчивается символами

\\

, то этот метод записывает раздел; если такого раздела нет, он будет создан. Если в конце strName
отсутствуют символы

\\

, то производится запись указанного параметра в нужный раздел; если такого параметра нет, он будет создан с указанным именем и значением.

Параметр

anyValue

метода задает значение, которое нужно записать в заданный параметром strName
параметр или раздел реестра. Необязательный параметр strType
определяет тип записываемого значения. В качестве strType
можно указывать "

REG_SZ

", "

REG_EXPAND_SZ

", "

REG_DWORD

" и "

REG_BINARY

". Если в качестве параметра strType
передается другое значение, то метод

RegWrite

вернет значение

E_INVALIDARG

В случае, когда

strType

установлено в "

REG_SZ

" или "

REG_EXPAND_SZ

", метод

RegWrite

автоматически конвертирует параметр anyValue
в строку. Если значение strType
равно "

REG_DWORD

", то anyValue
переводится в целый формат. Если strType равно "

REG_BINARY

", то anyValue
должно быть целым числом.

Пример, иллюстрирующий применение метода RegWrite, приведен в главе 2 (см. листинги 2.45 и 2.46).

Метод Run

Параметр

intWindowStyle

устанавливает вид окна для запускаемого приложения (табл. 1.13).

Таблица 1.13. Типы окна (

intWindowStyle

)

Параметр	Константа Visual Basic	Описание
0	`vbHide`	Прячет текущее окно и активизирует другое окно (показывает его и передает ему фокус)
1	`vbNormalFocus`	Активизирует и отображает окно. Если окно было минимизировано или максимизировано, система восстановит его первоначальное положение и размер. Этот флаг должен указываться сценарием во время первого отображения окна
2	`vbMinimizedFocus`	Активизирует окно и отображает его в минимизированном (свернутом) виде
3	`vbMaximizedFocus`	Активизирует окно и отображает его в максимизированном (развернутом) виде
4	`vbNormalNoFocus`	Отображает окно в том виде, в котором оно находилось последний раз. Активное окно при этом остается активным
5		Активизирует окно и отображает его в текущем состоянии
6	vbMinimizedNoFocus	Минимизирует заданное окно и активизирует следующее (в Z-порядке) окно
7		Отображает окно в свернутом виде. Активное окно при этом остается активным
8		Отображает окно в его текущем состоянии. Активное окно при этом остается активным
9		Активизирует и отображает окно. Если окно было минимизировано или максимизировано, система восстановит его первоначальное положение и размер. Этот флаг должен указываться, если производится восстановление свернутого окна (его нельзя использовать в методе `Run` )
10		Устанавливает режим отображения, опирающийся на режим программы, которая запускает приложение

Замечание

В сценариях, написанных на языке VBScript, можно непосредственно использовать именованные константы типа

vbHide

var vbHide=0;

). Естественно, в любых сценариях вместо имен констант можно использовать их числовые значения.

Необязательный параметр

bWaitOnReturn

является логической переменной, дающей указание ожидать завершения запущенного процесса. Если этот параметр не указан или установлен в

false

, то после запуска из сценария нового процесса управление сразу же возвращается обратно в сценарий (не дожидаясь завершения запущенного процесса). Если же bWaitOnReturn
установлен в

true

, то сценарий возобновит работу только после завершения вызванного процесса.

При этом если параметр

bWaitOnReturn

равен

true

, то метод

Run

возвращает код выхода вызванного приложения. Если же bWaitOnReturn
равен

false

или не задан, то метод

Run

всегда возвращает ноль.

В следующем примере мы запускаем Блокнот (notepad.exe) и открываем в нем файл с выполняемым сценарием:

var WshShell = WScript.CreateObject("WScript.Shell");

WshShell.Run("%windir%\\notepad" + WScript.ScriptFullName);

Следующий сценарий печатает код выхода вызванного приложения (листинг 1.18).

Листинг 1.18. Вывод кода выхода запущенного приложения

/********************************************************************/

/* Имя: RetCode.js                          */

/* Язык: JScript                           */

/* Описание: Вывод кода выхода запущенного приложения        */

/********************************************************************/

//Создаем объект WshShell

var WshShell = WScript.CreateObject("WScript.Shell");

//Запускаем Блокнот и ожидаем завершения его работы

Return = WshShell.Run("notepad " + WScript.ScriptFullName, 1, true);

//Печатаем код возврата

WScript.Echo("Код возврата:", Return);

/*************  Конец ***********************************************/

Другие примеры запуска приложений с помощью метода Run приведены в главе 2 (см. листинги 2.31 и 2.32).

Метод SendKeys

Каждая клавиша задается одним или несколькими символами. Например, для того чтобы задать нажатие друг за другом букв А, Б и В, нужно указать в качестве параметра для

SendKeys

строку "

АБВ

string="AБB"

Несколько символов имеют в методе SendKeys специальное значение:

. Для того чтобы задать один из этих символов, их нужно заключить в фигурные скобки

{}

. Например, для задания знака плюс используется

{+}

. Квадратные скобки

[]

хотя и не имеют в методе SendKeys специального смысла, их также нужно заключать в фигурные скобки. Кроме этого, для задания самих фигурных скобок следует использовать следующие конструкции:

{{}

(левая скобка) и

{}}

(правая скобка).

Для задания неотображаемых символов, таких как или и специальных клавиш, в методе

SendKeys

используются коды, представленные в табл. 1.14.

Таблица 1.14. Коды специальных клавиш для

SendKeys

Названия клавиш	Код	Названия клавиш	Код
	`{BACKSPACE}` , `{BS}` или `{BKSP}`	<→>	`{RIGHT}`
	`{BREAK}`		`{F1}`
	`{CAPSLOCK}`		`{F2}`
~~или~~	`{DELETE}` или `{DEL}`		`{F3}`
	`{END}`		`{F4}`
	`{ENTER}` ИЛИ `~`		`{F5}`
	`{ESC}`		`{F6}`
	`{HELP}`		`{F7}`
или	`{INSERT}` или `{INS}`		`{F8}`
	`{NUMLOCK}`		`{F9}`
	`{PGDN}`		`{F10}`
	`{PGUP}`		`{F11}`
	`{PRTSC}`		`{F12}`
	`{SCROLLLOCK}`		`{F13}`
	`{TAB}`		`{F14}`
<↑>	`{UP}`		`{F15}`
<←>	`{LEFT}`		`{F16}`
<↓>	{DOWN}

Для задания комбинаций клавиш с , или , перед соответствующей клавишей нужно поставить один или несколько кодов из табл. 1.15.

Таблица 1.15. Коды клавиш , и

Клавиша	Код
	`+`
	`^`
	`%`

Для того чтобы задать комбинацию клавиш, которую нужно набирать, удерживая нажатыми клавиши , <Сtrl> или , нужно заключить коды этих клавиш в скобки. Например, если требуется сымитировать нажатие клавиш и ~~при нажатой клавише , следует использовать последовательность "~~

+(GS)

". Для того же, чтобы задать одновременное нажатие клавиш +, а затем (уже без ), используется "
+GS
".

В методе SendKeys можно задать несколько нажатий подряд одной и той же клавиши. Для этого необходимо в фигурных скобках указать код нужной клавиши, а через пробел — число нажатий. Например,
{LEFT 42}
означает нажатие клавиши <←> 42 раза подряд;
{h 10}
означает нажатие клавиши 10 раз подряд.

Замечание

Метод
SendKeys
не может быть использован для посылки нажатий клавиш для приложений, которые не были разработаны специально для запуска в Microsoft Windows (например, для приложений MS-DOS).

Примеры, иллюстрирующие использование
SendKeys
, приведены в листингах 1.13, 2.31, 2.32.

Работа с ярлыками

Свойства и методы для работы с ярлыками Windows предоставляют два объекта WSH:
WshShortcut
и
WshUrlShortcut
.

Объект WshShortcut

С помощью объекта
WshShortcut
можно создать новый ярлык Windows или изменить свойства уже существующего ярлыка. Этот объект можно создать только с помощью метода
CreateShortcut
объекта
WshShell
. В листинге 1.19 представлен пример сценария, в котором создается ярлык на этот самый сценарий (ярлык будет находиться в текущем каталоге).

Листинг 1.19. Создание ярлыка на выполняемый сценарий

/*****************************************************************/

/* Имя: MakeShortcut1.js */

/* Язык: JScript */

/* Описание: Создание ярлыка на выполняемый сценарий */

/*****************************************************************/

var WshShell,oShellLink;

//Создаем объект WshShell

WshShell = WScript.CreateObject("WScript.Shell");

//Создаем ярлык в текущем каталоге

oShellLink = WshShell.CreateShortcut("Current Script.lnk");

//Устанавливаем путь к файлу

oShellLink.TargetPath = WScript.ScriptFullName;

//Сохраняем ярлык

oShellLink.Save();

/************* Конец *********************************************/

Свойства объекта
WshShortcut
описаны в табл. 1.16.

Таблица 1.16. Свойства объекта
WshShortcut

Свойство Описание

Arguments
Содержит строку, задающую параметры командной строки для ярлыка

Description
Содержит описание ярлыка

FullName
Содержит строку с полным путем к ярлыку

HotKey
Задает "горячую" клавишу для ярлыка, т.е. определяет комбинацию клавиш, с помощью которой можно запустить или сделать активной программу, на которую указывает заданный ярлык

IconLocation
Задает путь к значку ярлыка

TargetPath
Устанавливает путь к файлу, на который указывает ярлык

WindowStyle
Определяет вид окна для приложения, на которое указывает ярлык

WorkingDirectory
Задает рабочий каталог для приложения, на которое указывает ярлык

Приведем необходимые пояснения и примеры использования свойств объекта
WshShortcut
.

Свойство Arguments

В листинге 1.20 приведен пример сценария, создающего ярлык на этот самый сценарий с двумя параметрами командной строки.

Листинг 1.20. Создание ярлыка на выполняемый сценарий с аргументами командной строки

/*****************************************************************/

/* Имя: MakeShortcut2.js */

/* Язык: JScript */

/* Описание: Создание ярлыка на выполняемый сценарий с */

/* аргументами командной строки */

/*****************************************************************/

var WshShell,oShellLink;

//Создаем объект WshShell

WshShell = WScript.CreateObject("WScript.Shell");

//Создаем ярлык в текущем каталоге

oShellLink = WshShell.CreateShortcut("Current Script.lnk");

//Устанавливаем путь к файлу

oShellLink.TargetPath = WScript.ScriptFullName;

//Указываем аргументы командной строки

oShellLink.Arguments = "-a abc.txt";

//Сохраняем ярлык

oShellLink.Save();

/************* Конец *********************************************/

Свойство HotKey

Для того чтобы назначить ярлыку "горячую" клавишу, необходимо в свойство
HotKey
записать строку, содержащую названия нужных клавиш, разделенные символом "
+
".

Замечание

"Горячие" клавиши могут быть назначены только ярлыкам, которые расположены на рабочем столе Windows или в меню Пуск (Start). Для того чтобы нажатия "горячих" клавиш срабатывали, необходимо, чтобы языком по умолчанию в операционной системе был назначен английский.

В следующем примере (листинг 1.21) на рабочем столе создается ярлык для Блокнота, которому назначается комбинация "горячих" клавиш + ++.

Листинг 1.21. Создание ярлыка на Блокнот с комбинацией "горячих" клавиш

/*****************************************************************/

/* Имя: MakeShortcut3.js */

/* Язык: JScript */

/* Описание: Создание ярлыка на Блокнот с комбинацией горячих */

/* клавиш */

/*****************************************************************/

var WshShell,strDesktop,oMyShortcut;

//Создаем объект WshShell

WshShell = WScript.CreateObject("WScript.Shell");

//Определяем путь к рабочему столу

strDesktop = WshShell.SpecialFolders("Desktop");

//Создаем ярлык в текущем каталоге

oMyShortcut = WshShell.CreateShortcut(strDesktop+"\\a_key.lnk");

//Устанавливаем путь к файлу

oMyShortcut.TargetPath =

WshShell.ExpandEnvironmentStrings("%windir%\\notepad.exe");

//Назначаем комбинацию горячих клавиш

oMyShortcut.Hotkey = "CTRL+ALT+D";

//Сохраняем ярлык

oMyShortcut.Save();

WScript.Echo("Горячие клавиши для ярлыка: "+oMyShortcut.Hotkey);

/************* Конец *********************************************/

Свойство IconLocation

Для того чтобы задать значок для ярлыка, необходимо в свойство
IconLocation
записать строку следующего формата: "путь, индекс". Здесь параметр путь определяет расположение файла, содержащего нужный значок, а параметр индекс — номер этого значка в файле (номера начинаются с нуля).

В следующем примере (листинг 1.22) создается ярлык на выполняющийся сценарий с первым значком (индекс 0) из файла notepad.exe.

Листинг 1.22. Создание ярлыка на выполняемый сценарий со значком из notepad.exe

/*****************************************************************/

/* Имя: MakeShortcut4.js */

/* Язык: JScript */

/* Описание: Создание ярлыка на выполняемый сценарий с иконкой */

/* из notepad.exe */

/*****************************************************************/

var WshShell,oShellLink;

//Создаем объект WshShell

WshShell = WScript.CreateObject("WScript.Shell");

//Создаем ярлык в текущем каталоге

oShellLink = WshShell.CreateShortcut("Current Script.lnk");

//Устанавливаем путь к файлу

oShellLink.TargetPath = WScript.ScriptFullName;

//Выбираем иконку из файла notepad.exe

oShellLink.IconLocation = "notepad.exe, 0";

//Сохраняем ярлык

oShellLink.Save();

/************* Конец *********************************************/

Свойство WindowStyle

Значением свойства
WindowStyle
является целое число
intWindowStyle
, которое может принимать значения, приведенные в табл. 1.17.

Таблица 1.17. Значения параметра
intWindowStyle

IntWindowStyle
Описание

1 Стандартный размер окна. Если окно было минимизировано или максимизировано, то будут восстановлены его первоначальные размеры и расположение на экране

3 Окно при запуске приложения будет развернуто на весь экран (максимизировано)

7 Окно при запуске приложения будет свернуто в значок (минимизировано)

Свойство WorkingDirectory

В следующем примере (листинг 1.23) создается ярлык для Блокнота, причем в качестве рабочего каталога указан корневой каталог диска С:.

Листинг 1.23. Создание ярлыка на Блокнот с комбинацией горячих клавиш

/*****************************************************************/

/* Имя: MakeShortcut5.js */

/* Язык: JScript */

/* Описание: Создание ярлыка на Блокнот с изменением рабочего */

/* каталога */

/*****************************************************************/

var WshShell,oShellLink;

//Создаем объект WshShell

WshShell = WScript.CreateObject("WScript.Shell");

//Создаем ярлык в текущем каталоге

oShellLink = WshShell.CreateShortcut("Notepad.lnk");

//Устанавливаем путь к файлу

oShellLink.TargetPath = "notepad.exe";

//Назначаем рабочий каталог

oShellLink.WorkingDirectory = "c:\\";

//Сохраняем ярлык

oShellLink.Save();

/************* Конец *********************************************/

Объект
WshShortcut
имеет единственный метод
Save
, который сохраняет заданный ярлык в каталоге, указанном в свойстве
FullName
.

Объект WshUrlShortcut

С помощью объекта
WshUrlShortcut
можно создать новый ярлык для сетевых ресурсов или изменить свойства уже существующего ярлыка. Этот объект, как и
WshShortcut
, можно создать только с помощью метода
CreateShortcut
объекта
WshShell
.

В следующем примере (листинг 1.24) создается сетевой ярлык для сайта www.microsoft.com.

Листинг 1.24. Создание сетевого ярлыка

/*****************************************************************/

/* Имя: MakeShortcut6.js */

/* Язык: JScript */

/* Описание: Создание сетевого ярлыка для www.microsoft.com */

/*****************************************************************/

var WshShell,oUrlLink;

//Создаем объект WshShell

WshShell = WScript.CreateObject("WScript.Shell");

//Создаем ярлык в текущем каталоге

oUrlLink = WshShell.CreateShortcut("Microsoft Web Site.URL");

//Устанавливаем путь к сайту

oUrlLink.TargetPath = "http://www.microsoft.com";

//Сохраняем ярлык

oUrlLink.Save();

/************* Конец *********************************************/

Объект
WshUrlShortcut
имеет два свойства:
FullName
и
TargetPath
, которые полностью аналогичны одноименным свойствам рассмотренного выше объекта
WshShortcut
.

Также у объекта
WshUrlShortcut
имеется метод
Save
, с помощью которого ярлык сохраняется в каталоге, указанном в свойстве
FullName
.

Другие примеры работы с ярлыками с помощью объекта
WshShortcut
приведены в главе 2 (см. листинги 2.43 и 2.44).

Запуск процессов на локальной и удаленной машине

Из сценариев WSH 5.6 можно на локальной машине запускать дочерние процессы, имея при этом доступ к их стандартным входным/выходным потокам и контролируя ход выполнения этих процессов. Для этих целей предназначен объект
WshScriptExec
.

Кроме этого, имеется возможность запустить сценарий, файл с которым находится на локальной машине, на другой удаленной машине. Для выполнения сценариев на удаленных машинах и обработки ошибок, возникающих в таких сценариях, используются объекты
WshController
,
WshRemote
и
WshRemoteError
.

Объект WshScriptExec

В WSH 5.6 появилась возможность при помощи метода
WshShell.Exec
запускать консольное приложение или сценарий как дочерний процесс выполняемого сценария, т.е. с теми же переменными среды, что и у процесса-родителя. Метод
WshShell.Exec
выполняет командную строку, указанную в качестве его параметра, и возвращает объект
WScriptExec
, свойства и методы которого предоставляют информацию о запущенной задаче и обеспечивают доступ к ее стандартным потокам ввода/вывода и ошибок (обработка этих потоков необходима в силу того, что непосредственно на экране строки, выводимые дочерним приложением, не появляются).

Отметим также, что с помощью метода
WshShell.Exec
можно запускать и графические оконные Windows-приложения. В этом случае создаваемый объект
WshScriptExec
полезен тем, что он позволяет получить идентификатор запущенного процесса (Process ID, PID), который затем можно использовать для активизации задачи при помощи метода
WshShell.AppActivate
.

Объект
WScriptExec
имеет единственный метод
Terminate
, с помощью которого можно прервать выполнение дочернего процесса.

Например:

var WshShell=WScript.CreateObject("WScript.Shell");

var ChildJob = WshShell.Exec("cscript ChildScript.js");

ChildJob.Terminate();

Метод
Terminate
пытается закрыть приложение, посылая ему сообщение
WM_CLOSE
. Если это не срабатывает, задача завершается принудительно. Методом
Terminate
нужно пользоваться только в крайнем случае, т.к. некоторые приложения, завершенные таким способом, не полностью освобождают ресурсы. Поэтому, как правило, лучше дождаться, когда запущенная задача сама закончит свою работу.

Свойства объекта
WshScriptExec
описаны в табл. 1.18.

Таблица 1.18. Свойства объекта
WshScriptExec

Свойство Описание

ExitCode
Содержит код выхода, устанавливаемый дочерней задачей при завершении выполнения

ProcessID
Содержит идентификатор процесса (ProcessID, PID), которому соответствует объект
WshScriptExec

Status
Содержит информацию о ходе выполнения дочерней задачи

StdOut
Позволяет сценарию-родителю считывать информацию из стандартного выходного потока запущенной дочерней задачи

StdIn
Позволяет сценарию-родителю записывать информацию в стандартный входной поток запущенной дочерней задачи

StdErr
Позволяет сценарию-родителю считывать информацию из стандартного потока ошибок запущенной дочерней задачи

Свойство ProcessID

В следующем примере (сценарий MakeCalc.js) свойство
ProcessID
используется для активизации стандартного калькулятора Windows. Напомним, что для этой цели также можно при вызове метода
WshShell.AppActivate
использовать название окна "Calculator".

Листинг 1.25. Активизация приложений с помощью PID

/*****************************************************************/

/* Имя: MakeCalc.js */

/* Язык: JScript */

/* Описание: Активизация приложений с помощью PID */

/*****************************************************************/

var WshShell, theCalculator;

//Создаем объект WshShell

WshShell = WScript.CreateObject("WScript.Shell");

//Запускаем калькулятор

theCalculator = WshShell.Exec("calc");

//Приостанавливаем выполнение сценария для того, чтобы окно

//калькулятора появилось на экране

WScript.Sleep(500);

//Активизируем окно калькулятора

WshShell.AppActivate(theCalculator.ProcessID);

//Посылаем нажатия клавиш в окно калькулятора

WshShell.SendKeys("1{+}");

WScript.Sleep(500);

WshShell.SendKeys("2");

WScript.Sleep(500);

WshShell.SendKeys("~");

/************* Конец *********************************************/

Свойство Status

После запуска дочернего процесса сценарий-родитель продолжает выполняться асинхронно, поэтому необходимо уметь определять, выполняется ли еще запущенная задача, или она уже завершена. Для этой цели используется свойство
Status
: если значение
Status
равно 0, то это означает, что дочерний процесс находится в стадии выполнения, если
Status
равно 1, то запущенная задача уже завершена. Например, в результате выполнения приведенного в листинге 1.26 сценария ChildStatus.js на экран выведется несколько строк "Команда еще выполняется" (рис. 1.12).

Листинг 1.26. Контроль состояния дочернего процесса

/*****************************************************************/

/* Имя: ChildStatus.js */

/* Язык: JScript */

/* Описание: Контроль состояния дочернего процесса */

/*****************************************************************/

var WshShell,theJob;

//Создаем объект WshShell

WshShell=WScript.CreateObject("WScript.Shell");

//Запускаем дочернее приложение

theJob = WshShell.Exec("xcopy /?");

for (;;) {

if (theJob.status==1) //Проверяем завершение дочернего процесса

break; //Выходим из цикла

else WScript.Echo("Команда еще выполняется");

}

WScript.Echo("Выполнение завершено");

/************* Конец *********************************************/

Рис. 1.12. Результат выполнения сценария ChildStatus.js

Свойства StdOut, StdIn и StdErr

Работать c потоками
StdOut
,
StdIn
и
StdErr
объекта
WshScriptExec
можно с помощью тех же методов, которые применяются в объекте
WScript
для доступа к соответствующим стандартным потокам (см. табл. 1.3). Например, запустив приведенный в листинге 1.27 сценарий ConToWin.js с помощью wscript.exe, мы выведем в графическое окно информацию о ключах программы cscript.exe (рис. 1.13).

Рис. 1.13. Результат выполнения сценария ConToWin.js

Отметим, что запускаемое консольное приложение cscript.exe выводит символы кириллицы в DOS-кодировке, поэтому для вывода таких символов в графическое окно их нужно преобразовать в Windows-кодировку. В рассматриваемом сценарии это делается с помощью функции DosToWin, которая преобразует переданную в качестве параметра строку следующим образом: все символы кириллицы в этой строке переводятся в Windows-кодировку, остальные символы остаются без изменений:

function DosToWin(s) {

var i,ss; //Объявляем переменные

//Проверяем, создан ли объект RusDict

if (typeof(RusDict)=="undefined")

//Если объект RusDict не создан, создаем его

MakeRusDict();

ss="";

for (i=0;i
if (RusDict.Exists(s.charAt(i))) //Проверяем наличие символа в словаре //Преобразуем i-й символ в Windows-кодировку ss+=RusDict.Item(s.charAt(i)); else ss+=s.charAt(i); } return ss; } Основным в функции DosToWin является использование объекта Dictionary с именем RusDict . Этот объект формируется в функции MakeRusDict и содержит пары "ключ"–"знaчeниe" для всех букв русского алфавита, причем в качестве ключа указывается буква в DOS-кодировке, а в качестве значения — символ с кодом, который соответствует этой букве в Windows-кодировке. //Функция для создания объекта Dictionary с парами "ключ-значение", где //"ключ"-буква в DOS-кодировке, "значение"- символ, соответствующий этой //букве в Windows-кодировке function MakeRusDict() { //Создаем объект Dictionary RusDict = WScript.CreateObject("Scripting.Dictionary"); //Заполняем пары "ключ" (символ в DOS-кодировке)- "значение" (символ в //Window-кодировке) для всех букв русского алфавита RusDict.add("Ђ", "А"); RusDict.add("Ѓ", "Б"); RusDict.add("‚", "В"); RusDict.add("ѓ", "Г"); RusDict.add("„", "Д"); RusDict.add("…", "Е"); RusDict.add("р", "Ё"); RusDict.add("†", "Ж"); RusDict.add("‡", "З"); RusDict.add("€", "И"); RusDict.add("‰", "Й"); RusDict.add("Љ", "К"); RusDict.add("‹", "Л"); RusDict.add("Њ", "М"); RusDict.add("Ќ", "Н"); RusDict.add("Ћ", "О"); RusDict.add("Џ", "П"); RusDict.add("ђ", "Р"); RusDict.add("‘", "С"); RusDict.add("’", "Т"); RusDict.add("“", "У"); RusDict.add("”", "Ф"); RusDict.add("•", "Х"); RusDict.add("–", "Ц"); RusDict.add("—", "Ч"); RusDict.add("", "Ш"); RusDict.add("™", "Щ"); RusDict.add("љ", "Ъ"); RusDict.add("›", "Ы"); RusDict.add("њ", "Ь"); RusDict.add("ќ", "Э"); RusDict.add("ћ", "Ю"); RusDict.add("џ", "Я"); RusDict.add(" ", "а"); RusDict.add("Ў", "б"); RusDict.add("ў", "в"); RusDict.add("Ј", "г"); RusDict.add("¤", "д"); RusDict.add("Ґ", "е"); RusDict.add("с", "ё"); RusDict.add("¦", "ж"); RusDict.add("§", "з"); RusDict.add("Ё", "и"); RusDict.add("©", "й"); RusDict.add("Є", "к"); RusDict.add("«", "л"); RusDict.add("¬", "м"); RusDict.add("", "н"); RusDict.add("®", "о"); RusDict.add("Ї", "п"); RusDict.add("а", "р"); RusDict.add("б", "с"); RusDict.add("в", "т"); RusDict.add("г", "у"); RusDict.add("д", "ф"); RusDict.add("е", "х"); RusDict.add("ж", "ц"); RusDict.add("з", "ч"); RusDict.add("и", "ш"); RusDict.add("й", "щ"); RusDict.add("к", "ъ"); RusDict.add("л", "ы"); RusDict.add("м", "ь"); RusDict.add("н", "э"); RusDict.add("о", "ю"); RusDict.add("п", "я"); } Листинг 1.27. Доступ к потоку StdOut дочернего процесса /*****************************************************************/ /* Имя: ConToWin.js */ /* Язык: JScript */ /* Кодировка: DOS */ /* Описание: Доступ к потоку StdOut дочернего процесса */ /*****************************************************************/ var WshShell,theJob,s,IsBreak,RusDict; //Объявляем переменные //Функция для создания объекта Dictionary с парами "ключ-значение", где //"ключ"-буква в DOS-кодировке, "значение"- символ, соответствующий этой //букве в Windows-кодировке function MakeRusDict() { //Создаем объект Dictionary RusDict = WScript.CreateObject("Scripting.Dictionary"); //Заполняем пары "ключ" (символ в DOS-кодировке)- "значение" (символ в //Window-кодировке) для всех букв русского алфавита RusDict.add("Ђ", "А"); RusDict.add("Ѓ", "Б"); RusDict.add("‚", "В"); RusDict.add("ѓ", "Г"); RusDict.add("„", "Д"); RusDict.add("…", "Е"); RusDict.add("р", "Ё"); RusDict.add("†", "Ж"); RusDict.add("‡", "З"); RusDict.add("€", "И"); RusDict.add("‰", "Й"); RusDict.add("Љ", "К"); RusDict.add("‹", "Л"); RusDict.add("Њ", "М"); RusDict.add("Ќ", "Н"); RusDict.add("Ћ", "О"); RusDict.add("Џ", "П"); RusDict.add("ђ", "Р"); RusDict.add("‘", "С"); RusDict.add("’", "Т"); RusDict.add("“", "У"); RusDict.add("”", "Ф"); RusDict.add("•", "Х"); RusDict.add("–", "Ц"); RusDict.add("—", "Ч"); RusDict.add("", "Ш"); RusDict.add("™", "Щ"); RusDict.add("љ", "Ъ"); RusDict.add("›", "Ы"); RusDict.add("њ", "Ь"); RusDict.add("ќ", "Э"); RusDict.add("ћ", "Ю"); RusDict.add("џ", "Я"); RusDict.add(" ", "а"); RusDict.add("Ў", "б"); RusDict.add("ў", "в"); RusDict.add("Ј", "г"); RusDict.add("¤", "д"); RusDict.add("Ґ", "е"); RusDict.add("с", "ё"); RusDict.add("¦", "ж"); RusDict.add("§", "з"); RusDict.add("Ё", "и"); RusDict.add("©", "й"); RusDict.add("Є", "к"); RusDict.add("«", "л"); RusDict.add("¬", "м"); RusDict.add("", "н"); RusDict.add("®", "о"); RusDict.add("Ї", "п"); RusDict.add("а", "р"); RusDict.add("б", "с"); RusDict.add("в", "т"); RusDict.add("г", "у"); RusDict.add("д", "ф"); RusDict.add("е", "х"); RusDict.add("ж", "ц"); RusDict.add("з", "ч"); RusDict.add("и", "ш"); RusDict.add("й", "щ"); RusDict.add("к", "ъ"); RusDict.add("л", "ы"); RusDict.add("м", "ь"); RusDict.add("н", "э"); RusDict.add("о", "ю"); RusDict.add("п", "я"); } //Функция для перевода строки из DOS- в Windows-кодировку function DosToWin(s) { var i,ss; //Объявляем переменные //Проверяем, создан ли объект RusDict if (typeof(RusDict)=="undefined") //Если объект RusDict не создан, создаем его MakeRusDict(); ss=""; for (i=0;i if (RusDict.Exists(s.charAt(i))) //Проверяем наличие символа в словаре //Преобразуем i-й символ в Windows-кодировку ss+=RusDict.Item(s.charAt(i)); else ss+=s.charAt(i); } return ss; } /************* Начало *********************************************/ //Создаем объект WshShell WshShell=WScript.CreateObject("WScript.Shell"); //Запускаем дочернее приложение theJob = WshShell.Exec("cscript"); IsBreak=false; for (;;) { if (!theJob.StdOut.AtEndOfStream) //Считываем всю информацию, находящуюся в потоке StdOut //дочернего процесса s+=theJob.StdOut.ReadAll(); if (IsBreak) break; if (theJob.status==1) //Проверяем, не завершилась ли запущенная задача IsBreak=true; else WScript.Sleep(100); } //Преобразуем сформированные строки в Windows-кодировку //и выводим их на экран WScript.Echo(DosToWin(s)); /************* Конец *********************************************/ Таким образом, можно с помощью метода Exec запустить утилиту командной строки, передавать ей нужную входную информацию с помощью свойства StdIn и с помощью свойства StdOut получать и анализировать выдаваемые этой утилитой строки (соответствующие примеры приведены также в листингах 2.37 и 2.38).
Объект WshController Объект WshController имеет единственный метод CreateScript и предназначен для создания объекта-сценария на удаленной машине. Замечание В силу соображений безопасности удаленные сценарии можно запускать только с машин, на которых установлена операционная система Windows NT/2000/XP; то же самое требование предъявляется к машинам, на которых должны выполняться такие сценарии. Кроме этого, после начальной установки WSH по умолчанию выполнение удаленных сценариев запрещено; действия, которые необходимо произвести для разрешения выполнения таких сценариев, описаны в главе 2. Создается объект WshController следующим образом: var WshController=WScript.CreateObject("WshController"); Замечание Обратите внимание, что для объекта WshController программным идентификатором (ProgID) является именно строка "WshController ", а не строка "WScript.WshController ", как указано в бета-версии документации на WSH 5.6. Метод CreateScript возвращает указатель на объект WshRemote , с помощью которого можно контролировать состояние удаленного сценария и управлять его выполнением. При выполнении этого метода WSH последовательно производит следующие действия: □ подготавливает файл со сценарием для пересылки на удаленную станцию; □ с помощью протокола DCOM создает экземпляр объекта WshRemote на удаленной машине; □ пересылает сценарий на удаленную станцию для последующего выполнения с помощью метода Execute объекта WshRemote . Синтаксис метода CreateScript : CreateScript(CommandLine, [MachineName]) Параметр CommandLine содержит командную строку для запуска сценария, который должен быть выполнен на удаленной станции. Путь к сценарию должен быть указан относительно локальной машины, а не относительно той станции, на которой должен выполняться сценарий. Чаще всего этот путь указывает на файл, находящийся непосредственно на локальном компьютере, хотя можно указать путь к сценарию, записанному на каком-либо общем сетевом ресурсе (это делает возможным, работая на одном компьютере, загружать сценарий с другого и выполнять этот сценарий на третьем компьютере в сети). Второй необязательный параметр MachineName задает имя компьютера, на котором должен быть запущен сценарий. Если этот параметр не указан, то сценарий будет выполняться на локальной машине. Объект WshRemote Объект WshRemote необходим для контроля состояния сценариев, которые запущены на удаленной машине. В результате запуска такого сценария на удаленной машине создается процесс, поэтому можно сказать, что экземпляром объекта WshRemote , соответствующего выполняющемуся сценарию, является процесс. Создается WshRemote с помощью метода CreateScript объекта WshController : var Controller,RemoteScript; Controller=WScript.CreateObject("WshController"); RemoteScript=Controller.CreateScript("d: WscriptsWMyScript.js", "Server1"); Объект WshRemote имеет два свойства: Error и Status . В свойстве Error хранится ссылка на объект WshRemoteError , который содержит информацию об ошибке, приведшей к аварийному завершению работы удаленного сценария. Числовое свойство Status позволяет определить состояние сценария, работающего асинхронно на удаленной машине. Возможные значения свойства Status приведены в табл. 1.19. Таблица 1.19. Значения параметра Status Значение Числовое значение Описание NoTask 0 Объект WshRemote , соответствующий удаленному сценарию, создан, однако сценарий еще не запущен Running 1 Выполнение удаленного сценария продолжается Finished 2 Удаленный сценарий завершен Два имеющихся у объекта WshRemote метода позволяют соответственно запустить удаленный сценарий (метод Execute ) или принудительно завершить его выполнение (метод Terminate ); оба эти метода не имеют параметров. Метод Terminate , подобно одноименному методу объекта WshScriptExec , пытается закрыть приложение, посылая ему сообщение WM_CLOSE (если это не срабатывает, процесс завершается принудительно). Кроме свойств и методов, объект WshRemote может генерировать три события, которые описаны в табл. 1.20. Таблица 1.20. События объекта WshRemote Событие Описание Start Возникает при вызове метода Execute и сигнализирует серверу сценариев о начале выполнения сценария на удаленной машине Error Возникает в том случае, когда выполнение сценария на удаленной машине завершается аварийно End Возникает при завершении (нормальном или аварийном) работы сценария на удаленной машине Для обработки в сценариях событий, приведенных в табл. 1.20, необходимо подключиться к объекту WshRemote с помощью метода ConnectObject объекта WScript (листинг 1.28). Листинг 1.28. Обработка событий объекта WshRemote (JScript) /**********************************************************************/ /* Имя: RemoteEvents.js */ /* Язык: JScript */ /* Описание: Обработка событий, возникающих при выполнении удаленного */ /* сценария */ /**********************************************************************/ Var Controller,RemScript,IsQuit; //Объявляем переменные //Создаем объект WshController Controller = WScript.CreateObject("WshController"); //Создаем сценарий на удаленной машине (объект WshRemote) RemScript = Controller.CreateScript("D:\RemoteScript.js ", "stand"); //Устанавливаем соединение с объектом WshRemote WScript.ConnectObject(RemScript, "RemoteScript_"); RemScript.Execute(); //Запускаем удаленный сценарий IsQuit = False; while (!IsQuit) WScript.Sleep(100); //Приостанавливаем сценарий на 0,1 сек WScript.Quit(); //Выходим из сценария /*************** Функции-обработчики событий ***********************/ function RemoteScript_End { //Событие End WScript.Echo("Выполнение удаленного сценария завершено"); IsQuit = True; } function RemoteScript_Error { //Событие Error //Выводим на экран описание возникшей ошибки WScript.Echo("Ошибка при выполнении удаленного сценария: " + RemScript.Error.Description); IsQuit = True; } function RemoteScript_Start { //Событие Start WScript.Echo("Удаленный сценарий запущен"); } /************* Конец *********************************************/ Объект WshRemoteError Объект WshRemoteError создается автоматически при возникновении ошибки во время выполнения сценария на удаленной машине и содержит информацию об этой ошибке. Ссылка на объект WshRemoteError хранится в свойстве Error соответствующего объекта WshRemote . Свойства объекта WshRemoteError описаны в табл. 1.21 (методов у этого объекта нет). Таблица 1.21. Свойства объекта WshRemoteError Свойство Описание Description Содержит краткое описание ошибки, которая привела к аварийному завершению работы сценария. Если для какой-либо ошибки описание не предусмотрено, Description содержит пустую строку Line Определяет номер строки в файле сценария, в которой произошла ошибка. Если для ошибки нельзя определить номер строки, в которой она произошла, в свойство Line записывается 0 Character Определяет номер символа в строке, в котором произошла ошибка. Если для ошибки нельзя определить точную позицию, в которой она возникла, в свойство Character записывается 0 Number Содержит числовой код ошибки SourceText Содержит в текстовом виде строку сценария, в которой возникла ошибка. Так как не всегда возможно точно определить строку, в которой произошла ошибка, то иногда значением свойства SourceText может быть пустая строка Source Содержит в символьном виде название СОМ-объекта, обращение к которому послужило источником ошибок Для получения информации о возникшей при выполнении удаленного сценария ошибке можно использовать обработчик события Error объекта WshRemote ; соответствующие примеры приведены в листингах 1.28, 2.56 и 2.57.

Свойство	Описание
`Arguments`	Содержит строку, задающую параметры командной строки для ярлыка
`Description`	Содержит описание ярлыка
`FullName`	Содержит строку с полным путем к ярлыку
`HotKey`	Задает "горячую" клавишу для ярлыка, т.е. определяет комбинацию клавиш, с помощью которой можно запустить или сделать активной программу, на которую указывает заданный ярлык
`IconLocation`	Задает путь к значку ярлыка
`TargetPath`	Устанавливает путь к файлу, на который указывает ярлык
`WindowStyle`	Определяет вид окна для приложения, на которое указывает ярлык
`WorkingDirectory`	Задает рабочий каталог для приложения, на которое указывает ярлык

`IntWindowStyle`	Описание
1	Стандартный размер окна. Если окно было минимизировано или максимизировано, то будут восстановлены его первоначальные размеры и расположение на экране
3	Окно при запуске приложения будет развернуто на весь экран (максимизировано)
7	Окно при запуске приложения будет свернуто в значок (минимизировано)

Свойство	Описание
`ExitCode`	Содержит код выхода, устанавливаемый дочерней задачей при завершении выполнения
`ProcessID`	Содержит идентификатор процесса (ProcessID, PID), которому соответствует объект `WshScriptExec`
`Status`	Содержит информацию о ходе выполнения дочерней задачи
`StdOut`	Позволяет сценарию-родителю считывать информацию из стандартного выходного потока запущенной дочерней задачи
`StdIn`	Позволяет сценарию-родителю записывать информацию в стандартный входной поток запущенной дочерней задачи
`StdErr`	Позволяет сценарию-родителю считывать информацию из стандартного потока ошибок запущенной дочерней задачи

Значение	Числовое значение	Описание
`NoTask`	0	Объект `WshRemote` , соответствующий удаленному сценарию, создан, однако сценарий еще не запущен
`Running`	1	Выполнение удаленного сценария продолжается
`Finished`	2	Удаленный сценарий завершен

Событие	Описание
`Start`	Возникает при вызове метода `Execute` и сигнализирует серверу сценариев о начале выполнения сценария на удаленной машине
`Error`	Возникает в том случае, когда выполнение сценария на удаленной машине завершается аварийно
`End`	Возникает при завершении (нормальном или аварийном) работы сценария на удаленной машине

Свойство	Описание
`Description`	Содержит краткое описание ошибки, которая привела к аварийному завершению работы сценария. Если для какой-либо ошибки описание не предусмотрено, `Description` содержит пустую строку
`Line`	Определяет номер строки в файле сценария, в которой произошла ошибка. Если для ошибки нельзя определить номер строки, в которой она произошла, в свойство `Line` записывается 0
`Character`	Определяет номер символа в строке, в котором произошла ошибка. Если для ошибки нельзя определить точную позицию, в которой она возникла, в свойство `Character` записывается 0
`Number`	Содержит числовой код ошибки
`SourceText`	Содержит в текстовом виде строку сценария, в которой возникла ошибка. Так как не всегда возможно точно определить строку, в которой произошла ошибка, то иногда значением свойства `SourceText` может быть пустая строка
`Source`	Содержит в символьном виде название СОМ-объекта, обращение к которому послужило источником ошибок

~~< Назад Далее >~~

ТЕЛЕГРАМ Канал с обзорами, анонсами новинок и книжными подборками Книжный Вестник Бот для удобного поиска книг (если не нашлось на сайте) Поиск книг Свежие любовные романы в удобных форматах Любовные романы О психологии, саморазвитии и личностном росте Саморазвитие Детективы и триллеры, все новинки Детективы Фантастика и фэнтези, все новинки Фантастика Отборные классические книги Классика ВКОНТАКТЕ Цитаты, афоризмы, стихи, книжные подборки, обсуждения и многое другое Книжный Вестник БИБЛИОТЕКИ Библиотека с любовными романами, которая наверняка придётся по вкусу женской части аудитории Любовные романы Библиотека с фантастикой и фэнтези, а также смежных жанров Фантастика Самые популярные книги в формате фб2 Топ фб2 книги

Оглавление ПожаловатьсяК описанию Введение Для кого предназначена эта книга Структура книги Принятые в книге соглашения Благодарности Глава 1 Первое знакомство с Windows Script Host Возможности технологии ActiveX Нумерация версий WSH Назначение и основные свойства WSH Создание и запуск простейших сценариев JScript и VBScript Запуск сценария из командной строки в консольном режиме Запуск сценария из командной строки в графическом режиме Запуск сценария с помощью меню Пуск Запуск сценария с помощью Проводника Windows (Windows Explorer) Установка и изменение свойств сценариев Свойства и параметры сценариев, выполняемых с помощью cscript.exe Свойства и параметры сценариев, выполняемых с помощью wscript.exe Стандартные объекты WSH5.6 Объект WScript Свойство Arguments Свойства StdErr, StdIn, StdOut Метод CreateObject Метод ConnectObject Метод DisconnectObject Метод Echo Метод Sleep Объекты-коллекции Объект WshArguments Объект WshNamed Объект WshUnnamed Объект WshEnvironment Объект WshSpecialFolders Работа с сетью и оболочкой Windows Объект WshNetwork Метод AddPrinterConnection Метод AddWindowsPrinterConnection Метод EnumNetworkDrives Метод EnumPrinterConnections Метод MapNetworkDrive Метод RemoveNetworkDrive Метод RemovePrinterConnection Метод SetDefaultPrinter Объект WshShell Метод АррActivate Метод CreateShortcut Метод Environment Метод ExpandEnvironmentString Метод LogEvent Метод Popup Метод RegDelete Метод RegRead Метод RegWrite Метод Run Метод SendKeys Работа с ярлыками Объект WshShortcut Свойство Arguments Свойство HotKey Свойство IconLocation Свойство WindowStyle Свойство WorkingDirectory Объект WshUrlShortcut Запуск процессов на локальной и удаленной машине Объект WshScriptExec Свойство ProcessID Свойство Status Свойства StdOut, StdIn и StdErr Объект WshController Объект WshRemote Объект WshRemoteError Глава 2 Примеры использования стандартных объектов WSH (JScript и VBScript) Вывод на экран текстовых строк Метод Echo объекта WScript Методы Write и WriteLine объекта WScript.StdOut Функция MsgBox языка VBScript Метод Popup объекта WshShell Ввод строк текста Ввод строк в консольном режиме Ввод строк в графическом режиме Получение свойств WSH и запущенного сценария Работа с параметрами командной строки сценария Выход из сценария с определенным кодом завершения Использование внешних объектов автоматизации (на Microsoft Word) Запуск из сценариев внешних программ Запуск приложений Windows Переключение между приложениями, имитация нажатий клавиш Запуск независимых консольных приложений и команд DOS Запуск дочерних консольных приложений и команд DOS, использование их входных и выходных потоков Доступ к специальным папкам Windows ХР Создание ярлыков в специальных папках Работа с системным реестром Windows Работа с ресурсами локальной сети Определение имен рабочей станции, пользователя и домена Получение списка подключенных сетевых дисков и принтеров Подключение и отключение сетевых дисков и принтеров Запуск сценариев на удаленных машинах. Контроль за ходом выполнения таких сценариев Глава 3 Сценарии WSH как приложения XML Основные принципы XML Схема WS XML Элементы WS-файла Элементы < ?xml? > и < ![CDATA[]] > Элемент < ?job? > Элемент < package > Элемент < job > Элемент < runtime > Элемент < named > Элемент < unnamed > Элемент < description > Элемент < example > Элемент < resource > Элемент < object > Элемент < reference > Элемент < script > Примеры сценариев с разметкой XML Строгий режим обработки WS-файла Несколько заданий в одном файле Использование констант внешних объектов Подключение внешних файлов Два языка внутри одного задания (использование функции InputBox языка VBScript в сценариях JScript) Глава 4 Безопасность при работе со сценариями WSH Шифрование сценариев Цифровая подпись для сценариев WSH Использование цифровых сертификатов в Windows Способы получения цифрового сертификата Создание собственного сертификата Управление сертификатами с помощью ММС Добавление к сценарию цифровой подписи Проверка цифровой подписи сценария Политики безопасности для сценариев WSH Параметры реестра, влияющие на политику безопасности для WSH Блокировка локальных и удаленных сценариев WSH. Пример административного шаблона Три режима выполнения сценариев WSH Протоколирование действий сценариев в журналах событий Применение к сценариям WSH политики ограниченного использования программ Блокировка сценария с заданным именем Блокировка сценариев с заданной подписью Глава 5 Доступ из сценариев к файловой системе Выполнение основных операций с файловой системой Объект FileSystemObject Методы CopyFile и CopyFolder Метод CreateTextFile Методы DeleteFile и DeleteFolder Метод DriveExists Метод GetAbsolutePathName Метод GetBaseName Метод GetDrive Метод GetParentFolderName Метод GetSpecialFolder Метод GetTempName Методы MoveFile и MoveFolder Метод OpenTextFile Объект Drive Коллекция Drives Объект Folder Метод Copy Метод Delete Метод Move Коллекция Folders Объект File Метод Copy Метод Delete Метод Move Метод OpenAsTextStream Коллекция Files Объект TextStream Примеры сценариев Отчет об использовании дискового пространства Удаление ненужных временных файлов с жесткого диска Поиск файлов с использованием регyлярных выражений Перемещение файлов с ведением журнала действий Разработка записной книжки в формате текстового файла Глава 6 Практическая работа с данными в XML-файлах Записная книжка в формате XML Просмотр XML-файла с помощью объектной модели Internet Explorer 4.0 Описание объектной модели Пример сценария Использование XML DOM для просмотра и изменения ХМL-файла Описание модели XML DOM Просмотр содержимого записной книжки Добавление информации в записную книжку Поиск и удаление записи из книжки Глава 7 Способы организации диалогового режима работы сценариев Многозадачный сценарий для работы с записной книжкой Обработка параметров командной строки Организация диалога с помощью кнопочного меню Однозадачный сценарий для работы с записной книжкой Использование Internet Explorer для создания диалоговых окон Разработка HTML-формы для диалогового окна Создание объекта для обмена данными между XML-файлом и формой Вывод формы из сценария WSH Обработка событий, генерируемых элементами управления формы Окончательная доработка сценария IEPhoneBook.js Глава 8 Взаимодействие сценариев с Microsoft Office Объектные модели Microsoft Word и Excel Вывод данных из записной книжки в документ Microsoft Word Вывод записей в виде обычного текста Вывод записей в таблицу Вывод данных из записной книжки в таблицу Microsoft Excel Глава 9 Использование в сценариях баз данных Создание таблицы Phone.dbf в Microsoft Access Настройка источника данных ODBC Примеры сценариев Копирование данных из XML-файла в таблицу БД Просмотр записей в таблице Получение информации о полях и записях таблицы Сортировка записей в таблице Фильтрация записей в таблице Перемещение в наборе записей Доступ к БД без создания DSN Глава 10 Разработка СОМ-объектов с помощью языков сценариев Технология Windows Script Components Схема WSC XML Элементы WSC-файла Элементы < ?xml? > и < ![CDATA[]] > Элемент < package > Элемент < component > Элемент < registration > Элемент < public > Элемент < property > Элемент < method > Элемент < event > Элементы < resource > , < object > и < reference > Элемент < script > Пример: СОМ-объект для архивирования файлов Создание макета файла DateArc.wsc с помощью Windows Script Component Wizard (JScript) Доработка объекта-сценария DateArc.wsc (JScript) Регистрация файла DateArc.wsc в качестве СОМ-объекта Реализация объекта DateArc.wsc на VBScript Глава 11 Применение сценариев WSH для администрирования Windows ХР Использование службы каталогов Active Directory Service Interface (ADSI) Связывание с нужным объектом каталога Список всех доступных доменов в локальной сети Создание пользователя и группы на рабочей станции Вывод информации о пользователе и смена его пароля Удаление пользователя и группы на рабочей станции Список всех групп на рабочей станции Список всех пользователей в группе Список всех групп, в которые входит пользователь Создание сценариев включения/выключения и входа/выхода Сценарии, выполняемые при загрузке операционной системы Сценарии, выполняемые при завершении работы операционной системы Сценарии входа для всех локальных пользователей Сценарий выхода для всех локальных пользователей Сценарий входа для одного пользователя Примеры сценариев входа/выхода Подключение сетевых дисков и синхронизация времени при регистрации пользователей Интерактивный выбор программ автозагрузки Резервное копирование документов пользователя при окончании сеанса работы Вызов системных функций и стандартных диалоговых окон оболочки Windows Вызов модулей панели управления Запуск с помощью оболочки Windows Запуск с помощью системных функций Windows Открытие папки в Проводнике Windows Вызов окна форматирования диска Вызов окна запуска программ Блокировка рабочей станции Вызов окна выключения компьютера Использование технологии Windows Management Instrumentation (WMI) Доступ к свойствам файла Список всех запущенных процессов Закрытие всех экземпляров запущенного приложения Заключение Приложение 1 Справочник по языку JScript Строки кода и комментарии Переменные Типы данных Числа Текстовые строки Объекты Логические данные Null ( пустой тип) и undefined (неопределенный тип) Преобразование типов данных Операторы Унарные операторы Бинарные операторы Операторы побитовых логических операций и сдвига Операторы присваивания Операторы отношения Условные операторы Операторы циклов Цикл for Цикл for …in Цикл while Цикл do …while Оператор break Оператор continue Прочие операторы Обработка исключительных ситуаций Порядок выполнения операторов Функции Встроенные функции Функции пользователя Встроенные объекты (классы) Объект Array Объект Date Объект Enumerator Объект Math Объект String Приложение 2 Справочник по языку VBScript Строки кода и комментарии Переменные Подтипы данных Константы Массивы Операторы Арифметические операторы Операторы отношения и логические операторы Условные операторы Операторы циклов Цикл For …Next Цикл For Each …Next Цикл While …Wend Цикл Do …Loop Прочие операторы Обработка исключительных ситуаций Процедуры и функции Математические функции Символьные функции Функции для работы с массивами Функции для работы с подтипами данных Прочие функции Функции и процедуры пользователя Приложение 3 Средства разработки и отладки сценариев Создание и редактирование сценариев Редактор Primalscript Создание нового одиночного сценария Открытие существующего одиночного сценария Создание нового WS-файла Открытие существующего WS-файла Редактирование WS-файла на панели Workspace Nexus Запуск одиночного сценария Запуск задания из WS-файла Подписывание сценариев Возможности пользовательского интерфейса Другие редакторы Отладка сценариев в Microsoft Script Debugger Активизация отладчика Команды отладчика Установка и удаление точек прерывания Выполнение сценария Просмотр стека вызовов Просмотр и изменение значений переменных Приложение 4 Ошибки выполнения сценариев в WSH Приложение 5 Описание прилагаемой дискеты Источники информации Список литературы Ссылки на ресурсы Internet Журналы и статьи Сайты компании Microsoft Зарубежные сайты Российские сайты Загрузка...