Объект WScript.Shell метод Run — запуск внешних программ

Доброго времени суток всем читателям блога scriptcoding.ru. В этой статье мы подробно рассмотрим метод Run Wscript.Shell объекта. Данный метод служит для запуска внешних приложений из тела сценариев Windows Script Host.

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

Run (strCommand, [intWindowStyle], [bWaitOnReturn]) – данный метод служит для запуска другого приложения как в консольном режиме (командная строка), так и в оконном. При открытии исполняемого файла создается новый процесс. Ему передаются следующие параметры:

strCommand – данный параметр является обязательным, поскольку задает путь для файла или команды. Стоит учитывать, что если путь содержит пробелы, то его обязательно стоит заключать в двойные кавычки, иначе, возникнет ошибка » The system cannot find the file specified » – система не может найти указанный файл. Также полезно, использовать переменные окружения в пути к приложению, это экономит время.

intWindowStyle – является необязательным, и задает стиль окна. Параметр может принимать целые значения от 0 до 10. Согласно документации, в языке vbscript можно использовать именованные константы, но, они не всегда дают ожидаемый результат, и так как эти значения между собой повторяются, я упомянул лишь три:

• 0 – скрывает окно, будет виден только процесс в диспетчере задач.
• 1 – нормальный режим
• 2 – свернутый вид
• 3 – развернутый вид

bWaitOnReturn – может принимать true – сценарий будет ожидать завершения работы запущенного приложения, и только потом перейдет к выполнению следующей строчки кода, false – будет продолжатся выполнение сценария независимо от того, завершилась работа запущенного приложения или нет. Также следует учесть, что если установлено true, то метод вернет код выхода вызванного приложения, если установлено false – всегда будет возвращаться ноль.

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

Давайте проанализируем логику работы данного сценария. Переменная path хранит путь к папке System32, так как в ней у нас лежат исполняемые файлы notepad и calc. Переменная окружения » %WINDIR% » позволяет сократить строки кода и не писать » C:\\Windows «. WshShell содержит ссылку на экземпляр объекта Wscript.Shell, видим, чтобы создать саму ссылку, мы перед переменной прописали ключевое слово set, после чего идет вызов метода CreateObject класса WScript, подробней о работе с объектами читайте «Урок 8 по VBScript: Объекты и классы» и «Урок 4 по JScript: Создание собственных объектов». Далее мы запускаем блокнот с помощью метода Run Wscript Shell класса, через переменную WshShell. Для программы notepad мы третий параметр команды Run поставили в true, поэтому, исполняемый файл calc запустится только после закрытия приложения блокнот, плюс, перед этим появится информационное сообщение.

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

В данном примере, мы видим, что для команды Run мы прописали второй параметр (1 – нормальный режим), если этого не сделать, то произойдет ошибка, язык jscript не дает нам возможности пропустить параметр. Также видим, что тут не нужно использовать дополнительное ключевое слово типа set.

WScript Shell Run

Хорошо, теперь давайте посмотрим на еще один пример на языке vbscript.

В этом примере мы также запустили приложение notepad, но, не прописывали путь к нему. Дело в том, что команда Run объекта Wscript.Shell работает как команда » Windows Пуск/Выполнить «, и при запуске приложения, сперва идет его поиск в переменных средах Windows, в которые, и входит папка System32 . Также видим, что мы передали программе содержимое нашего сценария (строка WScript.ScriptFullName), фактически, скопировали в него весть текст скрипта.

Ну и напоследок, аналогичный пример, но уже на языке jscript:

И так, давайте все подытожим… В этой статье мы разобрали метод Run класса Wscript Shell, который позволяет запускать заданное приложение, и передавать ему нужные параметры, так, мы можем открыть текстовый редактор и вставить в него нужный текст. Аналогично, можно использовать и метод Exec, который тоже позволяет запускать исполняемый файл, но в отличии от метода Run, он позволяет контролировать работу исполняемого файла.

Спасибо за внимание. Автор блога Владимир Баталий

Application. Run Метод

Определение

Запускает стандартный цикл обработки сообщений приложения в текущем потоке. Begins running a standard application message loop on the current thread.

Перегрузки

Запускает стандартный цикл обработки сообщений приложения в текущем потоке, без формы. Begins running a standard application message loop on the current thread, without a form.

Запускает стандартный цикл обработки сообщений приложения в текущем потоке с ApplicationContext. Begins running a standard application message loop on the current thread, with an ApplicationContext.

Запускает стандартный цикл обработки сообщений приложения в текущем потоке и делает указанную форму видимой. Begins running a standard application message loop on the current thread, and makes the specified form visible.

Запускает стандартный цикл обработки сообщений приложения в текущем потоке, без формы. Begins running a standard application message loop on the current thread, without a form.

Исключения

Основной цикл обработки сообщений уже запущен в данном потоке. A main message loop is already running on this thread.

Комментарии

В приложении на основе Win32 или Windows Forms цикл обработки сообщений является подпрограммой в коде, который обрабатывает события пользователя, такие как щелчки мыши и клавиатуры. In a Win32-based or Windows Forms application, a message loop is a routine in code that processes user events, such as mouse clicks and keyboard strokes. Для каждого работающего приложения на основе Windows требуется активный цикл обработки сообщений, который называется основным циклом обработки сообщений. Every running Windows-based application requires an active message loop, called the main message loop. Когда главный цикл обработки сообщений закрыт, приложение завершает работу. When the main message loop is closed, the application exits. В Windows Forms этот цикл закрывается при Exit вызове метода или при ExitThread вызове метода в потоке, выполняющем основной цикл обработки сообщений. In Windows Forms, this loop is closed when the Exit method is called, or when the ExitThread method is called on the thread that is running the main message loop.

Большинству Windows Forms разработчикам не потребуется использовать эту версию метода. Most Windows Forms developers will not need to use this version of the method. Используйте Run(Form) перегрузку для запуска приложения с главной формой, чтобы приложение завершается при закрытии главной формы. You should use the Run(Form) overload to start an application with a main form, so that the application terminates when the main form is closed. Во всех остальных ситуациях используйте Run(ApplicationContext) перегрузку, которая поддерживает предоставление ApplicationContext объекта для лучшего контроля за временем существования приложения. For all other situations, use the Run(ApplicationContext) overload, which supports supplying an ApplicationContext object for better control over the lifetime of the application.

См. также раздел

Применяется к

Run(ApplicationContext)

Запускает стандартный цикл обработки сообщений приложения в текущем потоке с ApplicationContext. Begins running a standard application message loop on the current thread, with an ApplicationContext.

Параметры

Объект ApplicationContext, в котором запускается приложение. An ApplicationContext in which the application is run.

Исключения

Основной цикл обработки сообщений уже запущен в данном потоке. A main message loop is already running on this thread.

Примеры

В примере показаны две формы и выход из приложения при закрытии обеих форм. The example displays two forms and exits the application when both forms are closed. Когда приложение запускается и завершает работу, сохраняется расположение каждой формы. When the application starts and exits, the position of each form is remembered. В этом примере показано, как использовать ApplicationContext , вместе с Application.Run(context) методом, чтобы отобразить несколько форм при запуске приложения. This example demonstrates how to use an ApplicationContext, along with the Application.Run(context) method, to display multiple forms when the application starts.

Класс MyApplicationContext наследует от ApplicationContext и отслеживает, когда закрывается каждая форма, и завершает текущий поток, когда они оба. The class MyApplicationContext inherits from ApplicationContext and keeps track when each form is closed, and exits the current thread when they both are. Класс хранит позиции каждой формы для пользователя. The class stores the positions of each form for the user. Данные о положении формы хранятся в файле Appdata.txt , созданном в расположении, определенном параметром UserAppDataPath . The form position data is stored in a file titled Appdata.txt that is created in the location determined by UserAppDataPath. Main Метод вызывает, Application.Run(context) чтобы запустить приложение, используя ApplicationContext . The Main method calls Application.Run(context) to start the application given the ApplicationContext.

Код для AppForm1 AppForm2 форм и не показан в целях краткости. The code for the AppForm1 and AppForm2 forms is not shown for the purpose of brevity. ApplicationContextПолный листинг кода см. в обзоре класса. See the ApplicationContext class overview for the whole code listing.

How to Write and Run Scripts in the Windows PowerShell ISE

This article describes how to create, edit, run, and save scripts in the Script Pane.

How to create and run scripts

You can open and edit Windows PowerShell files in the Script Pane. Specific file types of interest in Windows PowerShell are script files ( .ps1 ), script data files ( .psd1 ), and script module files ( .psm1 ). These file types are syntax colored in the Script Pane editor. Other common file types you may open in the Script Pane are configuration files ( .ps1xml ), XML files, and text files.

The Windows PowerShell execution policy determines whether you can run scripts and load Windows PowerShell profiles and configuration files. The default execution policy, Restricted, prevents all scripts from running, and prevents loading profiles. To change the execution policy to allow profiles to load and be used, see Set-ExecutionPolicy and about_Signing.

To create a new script file

On the toolbar, click New, or on the File menu, click New. The created file appears in a new file tab under the current PowerShell tab. Remember that the PowerShell tabs are only visible when there are more than one. By default a file of type script ( .ps1 ) is created, but it can be saved with a new name and extension. Multiple script files can be created in the same PowerShell tab.

To open an existing script

On the toolbar, click Open, or on the File menu, click Open. In the Open dialog box, select the file you want to open. The opened file appears in a new tab.

To close a script tab

Click the Close icon (X) of the file tab you want to close or select the File menu and click Close.

If the file has been altered since it was last saved, you’re prompted to save or discard it.

To display the file path

On the file tab, point to the file name. The fully qualified path to the script file appears in a tooltip.

To run a script

On the toolbar, click Run Script, or on the File menu, click Run.

To run a portion of a script

1. In the Script Pane, select a portion of a script.
2. On the File menu, click Run Selection, or on the toolbar, click Run Selection.

To stop a running script

There are several ways to stop a running script.

• Click Stop Operation on the toolbar
• Press CTRL + BREAK
• Select the File menu and click Stop Operation.

Pressing CTRL + C also works unless some text is currently selected, in which case CTRL + C maps to the copy function for the selected text.

How to write and edit text in the Script Pane

You can copy, cut, paste, find, and replace text in the Script Pane. You can also undo and redo the last action you just performed. The keyboard shortcuts for these actions are the same shortcuts used for all Windows applications.

To enter text in the Script Pane

1. Move the cursor to the Script Pane by clicking anywhere in the Script Pane, or by clicking Go to Script Pane in the View menu.
2. Create a script. Syntax coloring and tab completion provide a richer editing experience in Windows PowerShell ISE.
3. See How to Use Tab Completion in the Script Pane and Console Pane for details about using the tab completion feature to help in typing.

To find text in the Script Pane

1. To find text anywhere, press CTRL + F or, on the Edit menu, click Find in Script.
2. To find text after the cursor, press F3 or, on the Edit menu, click Find Next in Script.
3. To find text before the cursor, press SHIFT + F3 or, on the Edit menu, click Find Previous in Script.

To find and replace text in the Script Pane

Press CTRL + H or, on the Edit menu, click Replace in Script. Enter the text you want to find and the replacement text, then press ENTER .

To go to a particular line of text in the Script Pane

In the Script Pane, press CTRL + G or, on the Edit menu, click Go to Line.

Enter a line number.

To copy text in the Script Pane

In the Script Pane, select the text that you want to copy.

Press CTRL + C or, on the toolbar, click the Copy icon, or on the Edit menu, click Copy.

To cut text in the Script Pane

1. In the Script Pane, select the text that you want to cut.
2. Press CTRL + X or, on the toolbar, click the Cut icon, or on the Edit menu, click Cut.

To paste text into the Script Pane

Press CTRL + V or, on the toolbar, click the Paste icon, or on the Edit menu, click Paste.

To undo an action in the Script Pane

Press CTRL + Z or, on the toolbar, click the Undo icon, or on the Edit menu, click Undo.

To redo an action in the Script Pane

Press CTRL + Y or, on the toolbar, click the Redo icon, or on the Edit menu, click Redo.

How to save a script

An asterisk appears next to the script name to mark a file that hasn’t been saved since it was changed. The asterisk disappears when the file is saved.

To save a script

Press CTRL + S or, on the toolbar, click the Save icon, or on the File menu, click Save.

To save and name a script

1. On the File menu, click Save As. The Save As dialog box will appear.
2. In the File name box, enter a name for the file.
3. In the Save as type box, select a file type. For example, in the Save as type box, select ‘PowerShell Scripts ( *.ps1 )’.
4. Click Save.

To save a script in ASCII encoding

By default, Windows PowerShell ISE saves new script files ( .ps1 ), script data files ( .psd1 ), and script module files ( .psm1 ) as Unicode (BigEndianUnicode) by default. To save a script in another encoding, such as ASCII (ANSI), use the Save or SaveAs methods on the $psISE.CurrentFile object.

The following command saves a new script as MyScript.ps1 with ASCII encoding.

The following command replaces the current script file with a file with the same name, but with ASCII encoding.

The following command gets the encoding of the current file.

Windows PowerShell ISE supports the following encoding options: ASCII, BigEndianUnicode, Unicode, UTF32, UTF7, UTF8, and Default. The value of the Default option varies with the system.

Windows PowerShell ISE doesn’t change the encoding of script files when you use the Save or Save As commands.