Андрей Попов - Windows Script Host для Windows 2000/XP

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

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

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

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

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

В принципе, работать с элементами коллекции WshArgumentsможно стандартным для JScript образом — создать объект Enumeratorи использовать его методы moveNext, itemи atEnd. Например, вывести на экран все параметры командной строки, с которыми запущен сценарий, можно следующим образом (листинг 1.4).

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

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

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

/* Имя: 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содержит коллекцию параметров командной строки запущенного сценария, у которых имеется уникальное имя (именные параметры). В 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).