Запуск скриптов WSH на удалённых компьютерах с помощью объекта WshRemote

С помощью объектов WshController и WshRemote сценарии Windows Script Host можно запускать не только на локальной машине, но и на удалённых компьютерах, имеющихся в сети. При этом исполняемый сценарий не будет явно копироваться на жёсткий диск удалённого компьютера, а работа будет происходить по протоколу DCOM (Distributed COM). Примеры кода WSH в настоящей статье будут приводиться на языке VBScript.

Для успешного запуска должны быть соблюдены следующие требования:

• на локальной и удалённой машинах должны быть установлены операционные системы не ниже Windows NT(SP3)/2000/XP и Windows Script Host версии не ниже 5.6;
• пользователь, который запускает сценарий, должен входить в группу локальных администраторов на той машине, где должен выполняться сценарий;
• на удалённой машине должен существовать параметр реестра HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows Script Host\Settings\Remote, равный 1 (разрешение на запуск удалённых сценариев для компьютера);
• на удалённой машине может существовать параметр реестра HKEY_CURRENT_USER\SOFTWARE\Microsoft\Windows Script Host\Settings\Remote, равный 1 или 0 (разрешение или запрет на запуск удалённых сценариев для пользователя); на удалённой машине также может существовать параметр реестра HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows Script Host\Settings\IgnoreUserSettings, равный 1 или 0 (игнорировать параметры пользователя или нет); в зависимости от последнего параметра принимается во внимание разрешение или запрет на запуск удалённых сценариев для пользователя;
• вероятно, для успешной работы придётся предварительно выполнить на удалённой машине такую команду: эта команда зарегистрирует wscript.exe как «внепроцессный» COM-сервер (out of process COM server), который работает в процессе, отличном от клиентского;
• возможно, для успешной работы придётся предварительно отконфигурировать настройки протокола DCOM на удалённой машине (запустите dcomcnfg и найдите элемент WSHRemote), указав конкретного пользователя/пароль для запуска; для разрешения проблем обращайтесь к сайту Microsoft, в частности, см. описание объекта WshRemote; механизм в целом может работать немного по-разному в зависимости от версии WSH (например, могут потребоваться права на создание файлов во временном каталоге на удалённой машине);
• удалённые сценарии всегда запускаются с помощью сервера сценариев wscript.exe, причём в пакетном режиме, т.е. подавляется отображение ошибок и запросов сценария; это означает, что использование методов WScript.Echo или WshShell.Popup может привести к непредсказуемым результатам.

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

Объект WshController имеет единственный метод CreateScript(CommandLine, [MachineName]), который возвращает указатель на объект WshRemote, с помощью которого можно контролировать состояние удалённого сценария и управлять его выполнением. Первый параметр содержит путь к файлу относительно локальной машины (файл может находиться на каком-либо сетевом ресурсе; это делает возможным, работая на одном компьютере, загружать скрипт с другого и выполнять его на третьем компьютере).

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

Status	Состояние асинхронно работающего сценария. Возможные значения: 0 (NoTask) — сценарий не запущен; 1 (Running) — сценарий выполняется; 2 (Finished) — сценарий завершён.
Error	Ссылка на объект WshRemoteError, содержащий информацию об ошибках.

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

Execute()	Запускает сценарий.
Terminate()	Прерывает исполнение сценария.

События объекта WshRemote:

Start	Начало выполнения сценария.
Error	Аварийное завершение выполнения сценария.
End	Нормальное или аварийное завершение выполнения сценария.

Свойства объекта WshRemoteError (методов у него нет):

Description	Краткое описание ошибки (может быть пустым).
Line	Номер строки сценария (если его нельзя определить, содержит 0).
Character	Номер символа в строке (если его нельзя определить, содержит 0).
Number	Код ошибки (число).
SourceText	Строка сценария (если её нельзя определить, содержит 0).
Source	Название COM-объекта — источника ошибки.

В качестве примера рассмотрим скрипт lnk.vbs, создающий ярлык на Рабочем столе для всех пользователей:

Запустим этот скрипт на удалённой машине \\home:

Людоговский Александр, 07.02.2009г.

Автоматизация работы с использованием 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.

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

Возвращает полный путь к специальным папкам типа меню Пуск.

Вот список доступных папок: AllUsersDesktop, AllUsersStartMenu, AllUsersPrograms, AllUsersStartup, Desktop, Favorites, Fonts, MyDocuments, NetHood, PrintHood, Programs, Recent, SendTo, StartMenu, Startup, Templates.

Свойство	Описание
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.

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