Using COM Objects in Windows Script Host
Microsoft Windows Script Host is a scripting utility you can use to run scripts within the base operating system. You can use Windows Script Host to automate common tasks and to create powerful macros and logon scripts. Windows Script Host comes with VBScript and JScript ActiveX scripting engines. Other software companies provide ActiveX scripting engines for languages such as PerlScript, PScript, Python, and others.
To use a COM object in a script run by Windows Script Host, you must first create an instance of the object. After a COM object has been created, you can then use it in scripts.
Windows Script Host consists of two applications. One runs scripts from the Windows desktop ( WScript.exe ); the other runs scripts from the command prompt ( CScript.exe ).
To run a script from the desktop, simply double-click a script file. Script files are text files. By convention, VBScript files have the extension .vbs and JScript files .js .
To run a script from the command prompt, run the Cscript.exe application with a command line such as the following:
where c:\\sample scripts\\chart.vbs is the path to the file containing the script.
You can print out a list of the parameters supported by Cscript.exe by entering the following command line:
To use a COM object in a script run by Windows Script Host, you must first create an instance of the object. In VBScript you can do this by calling the CreateObject() method. In JScript one can use either the ActiveXObject object or the WScript.CreateObject() method. The following example illustrates calling CreateObject() using VBScript:
The following example illustrates creating an ActiveXObject object using JScript:
Alternatively using WScript.CreateObject() method inside JScript:
After you have created an instance of the COM object, you can write script that uses the object, for example:
In addition to the CreateObject method and ActiveXObject object, both VBScript and JScript provide the method GetObject, which returns an object instance.
Автоматизация работы с использованием Windows Scripting Host
Помните ВАТ-файлы DOS? Это было прекрасное средство автоматизации повторяющихся задач. Windows, увы, не предложила эквивалентной замены, а средства сторонних разработчиков не прижились по различным причинам. Но положение, похоже, может исправиться. Windows Scripting Host (WSH) — новый, независимый от языка скрипт-хост для Win9x и NT, позволяет строить аналоги ВАТ-файлов на Visual Basic Scripting Edition, JScript и других скриптовых языках, например, Active Perl или Python.
Здесь мы обсудим некоторые преимущества Windows Scripting Host.
Преимущества Windows Scripting Host
Раньше единственным поддерживаемым Windows скриптовым языком был командный язык DOS. Но его возможности довольно бедны по сравнению с VBScript и JScript. Хотя командный язык DOS по прежнему поддерживается, современные ActiveX-скрипты позволяют решать более сложные задачи.
Cкрипт может принимать решения на основе использования полноценных операторов If/Else. Сценарий может выполнять один набор команд, если данное условие истинно, или другой набор, если условие ложно. Кроме того, JScript и VBScript хороши при выполнении математических операций, включая общие тригонометрические функции.
Другое свойство Windows Scripting Host заключается в том, что скрипты могут исполняться вне браузера. Достаточно кликнуть по файлу с текстом скрипта или ввести его название в командной строке,чтобы запустить его на исполнение. Windows Scripting Host не требователен к памяти и прекрасно годится для автоматизации Windows.
Хост и скриптовые машины
Как ни хороши скриптовые языки, многого с ними не сотворишь. Они неспособны повлиять на что-либо за пределами родного скрипта. Эти языки не имеют прямых инструкций, позволяющих читать или записывать файлы на диске, выводить информацию в командную строку, изменять записи в Реестре Windows и так далее.
Чтобы справиться с такими задачами, можно воспользоваться дополнительными COM-объектами. Ряд таких объектов входит в поставку WSH, а один из них, WScript, даже уже имеет созданный экземпляр, и им можно пользоваться непосредственно, без предварительного создания. Остальные создаются с помощью синтаксиса, соответствующего конкретному языку или функции WScript.CreateObject.
Объекты WSH
В поставку Windows Scripting Host входят 4 объекта: Wscript, WshShell, WshNetwork, и FileSystemObject.
Каждый объект, естественно, имеет набор собственных методов и свойств.
Объект Wscript позволяет скриптам «познать самих себя». Вдобавок этот объект позволяет скриптам запускать приложения и управлять ими. Основные свойства и методы этого объекта перечислены в таблице 1.
| Свойство | Описание |
|---|---|
| Arguments | Возвращает указатель на список аргументов командной строки |
| FullName | Возвращает имя исполняемого файла хоста и полный путь к нему (например, C:\Windows\wscript.exe) |
| Name | Выводит замечательную надпись Windows Scripting Host |
| Path | Определяет каталог и путь, содержащие wscript.exe или cscript.exe |
| ScriptFullName | Возвращает полный путь и имя исполняемого в данный момент скрипта |
| ScriptName | То же, что и ScriptFullName, но без пути |
| Version | Возвращает версию установленного Windows Scripting Host |
| Метод | Описание |
| CreateObject | Создает объект по его ProgID |
| ConnectObject | Позволяет подключиться к событиям объекта. В качестве параметра принимает объект, к которому надо подключиться и префикс соответствующих событиям процедур, реализованных в скрипте |
| DisconnectObject | Отключает от объекта, подключенного предыдущим методом |
| Echo | Выводит текстовую строку (в cscript — в StdOut, в Wscript — в виде диалогового окна. |
| GetObject | Позволяет получить указатель на объект из файла или объекта, указанного в параметре strProgID. |
| Quit | Завершает скрипт |
| Sleep | Переводит скрипт в неактивное состояние на время, указанное в миллисекундах |
Таблица 1. Методы и свойства объекта WScript
Объект WshShell позволяет скриптам устанавливать и конфигурировать другие приложения. Он также дает возможность общаться с пользователем, изменять Реестр и находить папки. Некоторые его свойства и методы перечислены в таблице 2.
| Свойство | Описание |
|---|---|
| Environment | |
| Метод | Описание |
| Run | Запускает приложение. strCommand — исполняемая команда, параметр intWindowStyle позволяет управлять положением и поведением окон, а bWaitOnReturn позволяет указать объекту WshShell, надо ли ожидать окончания выполнения запущенного приложения. |
| Popup | Ещё один способ вывести текст в окне |
| CreateShortcut | Создает ярлыки файлов или URL |
| RegRead | Возвращает значение ключа или записи реестра по его имени |
| RegWrite | Создает новые ключ или запись Реестра или записывает новое значение существующих. |
| RegDelete | Удаляет ключ или запись реестра |
| LogEvent | Позволяет записать сообщение в event log Windows NT или W2K или файл WSH.log в случае Windows 9х |
| ExpandEnvironmentStrings | Позволяет раскрыть строку, содержащую переменные среды |
| SendKeys | Позволяет эмулировать клавиатурный ввод |
Таблица 2. Свойства и методы объекта WshShell
Объект WshNetwork используется при создании скриптов, модифицирующих конфигурацию сети. Это включает задачи типа подключения к сети, инсталляцию принтеров, назначение буквенных обозначений сетевым дискам и так далее. Основные свойства и методы WshNetwork перечислены в таблице 3.
| Свойства | Описание |
|---|---|
| ComputerName | Возвращает имя компьютера |
| UserDomain | Возвращает имя домена, в котором зарегистрирован пользователь |
| UserName | Возвращает догадаетесь что! |
| Метод | Описание |
| MapNetworkDrive | Присваивает назначенную пользователем букву сетевому диску |
| EnumNetworkDrives | Возвращает список подключенных сетевых дисков |
| RemoveNetworkDrive | Отключает сетевой диск |
| AddWindowsPrinterConnection | Позволяет установить новый принтер в Windows, то есть указать путь к принтеру и инициировать установку драйверов. |
| AddPrinterConnection | Подключает сетевой принтер |
| RemovePrinterConnection | Отключает сетевой принтер |
| SetDefaultPrinter | Задает принтер по умолчанию |
| EnumPrinterConnections | Возвращает список подключенных принтеров |
Таблица 3. Свойства и методы объекта WshNetwork
Последний объект, FileSystemObject, нужен для дисковых операций. Это включает чтение, запись, удаление файлов и создание каталогов.
FileSystemObject имеет методы BuildPath, CopyFile, CopyFolder, CreateFolder, CreateTextFile, DeleteFile, DeleteFolder, DriveExists, FileExists, FolderExists, GetAbsolutePathName, GetBaseName, GetDrive, GetDriveName, GetExtensionName, GetFile, GetFileName, GetFolder, GetParentFolderName, GetSpecialFolder, GetTempName, MoveFile, MoveFolder, OpenTextFile. Их названия в отдельном объяснении не нуждаются. Его единственное свойство Drives возвращает список дисков, доступных на данной машине, включая сетевые.
Что вам нужно для начала
Первое, что надо сделать — убедиться, что Windows Scripting Host у вас есть. В состав W2K он входит изначально. Если вы используете Windows 98 или Internet Information Server 4.0, или если вы устанавливали Option Pack для Windows NT 4 и для Windows 95, он у вас точно есть. В случае Windows 95 все усложняется, и Windows Scripting Host придется скачивать с сайта Microsoft (msdn.microsoft. com/ scripting). Напишите в командной строке wscript. Если появилось диалоговое окно с надписью, отличной от «File not found», все в порядке.
Microsoft не поставляет визуального редактора скриптов WSH. Но Notepad вполне годится.
Создание и запуск скриптов
По сравнению с различными программистскими изысками писать скрипты для Windows Scripting Host относительно просто. В Notepad вы пишете свой скрипт с использованием упомянутых объектов. Потом сохраняете файл с расширением .vbs для VBScript или .js для JScript.
Запуск скриптов — тоже несложная задача. Есть несколько способов. Самый простой — командная строка DOS и аналогичная версия Windows Scripting Host, CSCRIPT.ЕXE. Эта версия позволяет контролировать исполнение скрипта с помощью параметров командной строки.
Параметры хоста включают или отключают различные опции Windows Scripting Host и всегда предваряются двумя слэшами (//). Имя скрипта — это всегда имя файла, а параметры скрипта — параметры, передаваемые скрипту. Эти параметры всегда предваряются одним слэшем (/). Таблица 4 содержит некоторые параметры CSCRIPT.EXE.
| Параметр | Описание |
|---|---|
| //B | Включает пакетный режим |
| //T | Задает таймаут в секундах |
| //I | Выключает пакетный режим (используется по умолчанию) |
| //logo | |
| //nologo | Выключает эту гордую надпись. |
| //H:Cscript or Wscript | Делает CSCRIPT.EXE или WSCRIPT.EXE хостом по умолчанию, т.е. ассоциирует их с расширениями скриптов. |
| //S | Сохраняет установки командной строки для текущего пользователя |
Таблица 4. Параметры командной строки CSCRIPT.EXE
Если вы не желаете видеть окошек с кнопкой ОК, используйте cscript.exe, а для вывода сообщений пользуйтесь методом WScript.Echo.
Для запуска скриптов с помощью wscript.exe имеются три пути.
Один из них — просто дважды щелкнуть по файлу или иконке. Другой — выбрать Выполнить. из меню Пуск и написать полное имя файла в текстовом поле Открыть. Наконец, можно запустить сам WSCRIPT.EXE из того же Выполнить. добавив к нему имя скрипта и любой из возможных параметров.
Пример скрипта
Попробуем написать какой-нибудь скрипт на VBScript. Конкретный пример, приведенный в Листинге 1, предоставлен Microsoft и может быть получен (как и несколько других) с их WWW-сайта: msdn.microsoft.com/scripting/windowshost/download/default.htm.
Листинг 1
Этот скрипт создает на рабочем столе ярлык для Notepad. Замечу, что сейчас в наши задачи не входит обучение пользователя программированию на VB или Java. Тем не менее, этот пример даст вам представление о том, что Windows Scripting Host может делать при наличии некоторых базовых навыков программирования.
Теперь пора перейти к более существенным применениям WSH. Наверное, больше всего WSH пригодится администраторам, осатаневшим от регулярного повторения одних и тех же действий. Администраторы Windows NT не располагали возможностями UNIX-администраторов, использовавших скрипты испокон веков. С появлением WSH ситуация изменилась, тем более, что WSH позволяет воспользоваться внешними по отношению к скриптовым языкам технологиям, таким, как Windows Management Instrumentation (WMI) и Active Directory Services Interface (ADSI).
WMI и ADSI мы будем использовать, я предполагаю, что у вас есть по крайней мере общее понимание этих технологий. Больше информации о них вы можете получить по адресам http://msdn.microsoft.com/developer/sdk/wmisdk/default.asp и http://www.microsoft.com//adsi/
В этих примерах предполагается, что вы используете W2K, для других платформ, вам, вероятно, придется установить WMI и ADSI.
Использование WSH и WMI для создания Logon-скриптов
Как вы знаете, такие скрипты подразумевают запуск в момент старта. В Листинге 2 приведен загрузочный скрипт, который определяет тип входящего в систему пользователя и выполняет задачи, основываясь на этой информации.
Листинг 2
Первое, скрипт создает некоторые общие объекты которые вам придется использовать, например, объекты WScript.Network и WScript.Shell. Дальше он использует эти объекты для определения имени пользователя и доменной информации. Наконец, используя ADSI скрипт возвращает информацию содержащую группу пользователя. Эта информация используется для определения подходящей подпрограммы, вызываемой для каждой из пользовательских групп. Это выполняет оператор Select Case.
Загрузочный скрипт для пользователей создаваемой нами группы Windows NT (под именем YourNewGroup) использует сетевые возможности WSH. Он проверяет, используется ли буква Z. Если она свободна, диском Z назначается \\yourserver\NETLOGON используя формат \\server\share.
Чтобы объяснить, как работает загрузочный скрипт, некоторые подпрограммы и функции вынесены в текст статьи. Можете просто вернуть их на место в блок
