• Главная
• Контакты
• Нашёл ошибку
• Прислать материал
• Добавить в избранное

В ранних версиях 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.

Напомним, что в 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, входившая в качестве стандартного компонента в 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 предъявляет минимальные требования к объему оперативной памяти и является очень удобным инструментом для автоматизации повседневных задач пользователей и администраторов операционной системы Windows. Используя сценарии WSH, можно непосредственно работать с файловой системой компьютера, а также управлять работой других приложений (серверов автоматизации). При этом возможности сценариев ограничены только средствами, которые предоставляют доступные серверы автоматизации.

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

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

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

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

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

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

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

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

Простейший 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 или на рабочем столе — достаточно просто выполнить двойной щелчок мышью на имени файла со сценарием или на его значке (рис. 1.6).

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

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

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

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

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

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

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

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

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

WshArguments

WshNamed

WshUnnamed

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

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

/а

/b

//B

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

При использовании для запуска модуля 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 несколько файлов и перетащить их на ярлык сценария, то этот сценарий запустится, а имена выделенных файлов передадутся ему в качестве параметров.

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

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

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

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

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

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

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

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

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

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

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

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

? 

WScript

?

WshArguments

?

WshNamed

?

WshUnnamed

? 

WshShell

?

WshSpecialFolders

?

WshShortcut

?

WshUrlShortcut

?

WshEnvironment

?

WshNetwork

?

WshScriptExec

?

WshController

?

WshRemote

?

WshRemoteError

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

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

Замечание

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

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

WScript

WScript

WScript

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

WScript

CreateObject

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

WScript

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

WScript

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

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

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

/* Имя: 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.

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

StdIn

StdOut

StdErr

Invalid Handle

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

StdIn

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

StdOut

StdErr

Write

WriteLine

WriteBlankLines

StdIn

Read

ReadLine

ReadAll

Skip

SkipLine

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

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

FIND

SORT

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

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

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

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

/* Имя: Interact.js                                                */

/* Язык: JScript                                                   */

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

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

var s;

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

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

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

s = WScript.StdIn.ReadLine();

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

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

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

Объект

WScript

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

WScript

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

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

strProgID

CreateObject

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

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

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

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);

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

obj

DisconnectObject(obj)

DisconnectObject

Параметры

Arg1

Echo

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

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

/* Имя: EchoExample.js                                             */

/* Язык: JScript                                                   */

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

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

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

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

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

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

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

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

Echo

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

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

WScript.Sleep(5000);

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

Метод

Sleep

WshShell.SendKeys

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

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

WshArguments

WshNamed

WshUnnamed

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

WshEnvironment

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

WshSpecialFolders

Объект

WshArguments

Arguments

WScript

WshShortcut

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

WshArguments

Enumerator

moveNext

item

atEnd

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

/* Имя: 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

Count

Item(n)

WshArguments

Замечание

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

Length

объекта

WshArguments

.

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

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

/* Имя: 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

ShowUsage

<runtime>

<description>

<example>

<named>

<unnamed>

Объект

WshNamed

/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

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

Объект

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

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

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

/* Имя: 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

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

? Desktop;

? Favorites;

? Fonts;

? MyDocuments;

? NetHood;

? PrintHood;

? Programs;

? Recent; 

? SendTo;

? StartMenu;

? Startup;

? Templates.

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

? AllUsersDesktop;

? AllUsersStartMenu;

? AllUsersPrograms;

? AllUsersStartup.

Объект

WshSpecialFolders

SpecialFolders

WshShell

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

 WshSpecFold=WshShell.SpecialFolders;

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

WshSpecialFolders

Length

Count

Item

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

/* Имя: 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 (специальные папки, переменные среды, системный реестр) предназначены соответственно объекты

WshNetwork

WshShell

Объект

WshNetwork

Объект

WshNetwork

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

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

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

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. Методы объекта

WshNetwork

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

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

bUpdateProfile

True

Параметры

strUser

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

AddPrinterConnection

\\Server1\Epson

LPT1

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

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

Параметр

strDriverName

Параметр

strPort

LPT1

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

AddWindowsPrinterConnection

LPT1

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

PrinterPath="\\printserv\DefaultPrinter";

PrinterDriver="Lexmark Optra S 1650";

WshNetwork.AddwindowsPrinterConnection(PrinterPath, PrinterDriver);

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

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

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

/* Имя: 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-го элемента коллекции

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

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

EnumNetworkDrives

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

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

/* Имя: 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-го элемента коллекции

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

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

bUpdateProfile

True

Параметры

strUser

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

z

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

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

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

strName

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

bForce

True

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

bUpdateProfile

True

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

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

/* Имя: MapDrive.js                                                */

/* Язык: JScript                                                   */

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

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

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

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

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

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

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

WshNetwork.RemoveNetworkDrive("Z:");

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

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

strName

Параметры

bForce

RemoveNetworkDrive

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

LPT1

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

WshNetwork.RemovePrinterConnection("LPT1:");

Параметр

strName

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

AddPrinterConnection

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

/* Имя: DefPrn.js                                                  */

/* Язык: JScript                                                   */

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

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

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

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

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

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

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

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

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

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

WshNetwork

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

WshShell

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

Объект

WshShell

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

WshShell

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

WshShell

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

WshShell

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

Метод

AppActivate

Run

WshShell

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

AppActivate

SendKeys

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

/* Имя: 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

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

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

oShellLink

oUrlLink

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

/* Имя: 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.

Параметр

strType

WshEnvironment

Замечание 

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

strType

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

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

NUMBER_OF_PROCESSORS

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

/* Имя: 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"));

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

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

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

/* Имя: ExpEnvStr.js                                             */

/* Язык: JScript                                                 */

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

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

/*           метода ExpandEnvironmentString                      */

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

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

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

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

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

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

intType

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

RunLoginScript

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");

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

strTitle

Параметр

nType

MessageBox

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

Popup

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

vbOkCancel

var vbOkCancel=1;

В методе

Popup

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

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

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

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

Popup

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

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

Popup

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

Popup

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

strName

\\

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

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

RegDelete

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

REG_SZ

REG_EXPAND_SZ

REG_DWORD

REG_BINARY

REG_MULTI_SZ

RegRead

DISP_E_TYPEMISMATCH

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

strName

\\

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

RegRead

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

/* Имя: 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);

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

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

strName

\\

\\

Параметр

anyValue

REG_SZ

REG_EXPAND_SZ

REG_DWORD

REG_BINARY

RegWrite

E_INVALIDARG

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

strType

REG_SZ

REG_EXPAND_SZ

RegWrite

REG_DWORD

REG_BINARY

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

Параметр

intWindowStyle

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

intWindowStyle

Замечание

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

vbHide

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

var vbHide=0;

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

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

bWaitOnReturn

false

true

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

bWaitOnReturn

true

Run

false

Run

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

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

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

Следующий сценарий печатает код выхода вызванного приложения (листинг 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

АБВ

string="AБB"

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

+

^

%

~

(

)

{}

{+}

[]

{{}

{}}

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

SendKeys

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

SendKeys

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

Таблица 1.15. Коды клавиш <Shift>, <Ctrl> и <Alt>

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

+(GS)

+GS

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

{LEFT 42}

{h 10}

Замечание

Метод

SendKeys

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

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

SendKeys

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

WshShortcut

WshUrlShortcut

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

WshShortcut

CreateShortcut

WshShell

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

/* Имя: 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. Свойства объекта

WshShortcut

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

WshShortcut

В листинге 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

+

Замечание

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

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

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

/* Имя: 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

В следующем примере (листинг 1.22) создается ярлык на выполняющийся сценарий с первым значком (индекс 0) из файла 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

intWindowStyle

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

intWindowStyle

В следующем примере (листинг 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

WshShortcut

CreateShortcut

WshShell

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

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

/* Имя: 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

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

WshScriptExec

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

WshController

WshRemote

WshRemoteError

В WSH 5.6 появилась возможность при помощи метода

WshShell.Exec

WshShell.Exec

WScriptExec

Отметим также, что с помощью метода

WshShell.Exec

WshScriptExec

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. Свойства объекта

WshScriptExec

В следующем примере (сценарий MakeCalc.js) свойство

ProcessID

WshShell.AppActivate

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

/* Имя: 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

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

/* Имя: 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 

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

StdOut

StdIn

StdErr

WshScriptExec

WScript

Рис. 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<s.length;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

//Функция для создания объекта 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("п", "я");

}

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

/* Имя: 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<s.length;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

CreateScript

Замечание

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

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

var WshController=WScript.CreateObject("WshController");

Замечание

Обратите внимание, что для объекта

WshController

программным идентификатором (ProgID) является именно строка "

WshController

", а не строка "

WScript.WshController

", как указано в бета-версии документации на WSH 5.6.

Метод

CreateScript

WshRemote

? подготавливает файл со сценарием для пересылки на удаленную станцию;

? с помощью протокола DCOM создает экземпляр объекта

WshRemote

? пересылает сценарий на удаленную станцию для последующего выполнения с помощью метода

Execute

WshRemote

Синтаксис метода

CreateScript

CreateScript(CommandLine, [MachineName])

Параметр

CommandLine

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

MachineName

Объект

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. Значения параметра

Status

Два имеющихся у объекта

WshRemote

Execute

Terminate

Terminate

WshScriptExec

WM_CLOSE

Кроме свойств и методов, объект WshRemote может генерировать три события, которые описаны в табл. 1.20.

Таблица 1.20. События объекта

WshRemote

Для обработки в сценариях событий, приведенных в табл. 1.20, необходимо подключиться к объекту WshRemote с помощью метода ConnectObject объекта WScript (листинг 1.28).

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

/* Имя: 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

Error

WshRemote

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

WshRemoteError

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

WshRemoteError

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

Error

WshRemote