Написание и запуск сценариев в интегрированной среде сценариев Windows PowerShell 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

В области скриптов можно открывать и редактировать файлы Windows PowerShell. You can open and edit Windows PowerShell files in the Script Pane. Сейчас нас интересуют следующие типы файлов Windows PowerShell: файлы скриптов ( .ps1 ), файлы данных скриптов ( .psd1 ) и файлы модулей скриптов ( .psm1 ). 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. Другие стандартные файлы, которые можно открыть в области сценариев, — это файлы конфигурации ( .ps1xml ), XML-файлы и текстовые файлы. Other common file types you may open in the Script Pane are configuration files ( .ps1xml ), XML files, and text files.

Политика выполнения Windows PowerShell определяет, можно ли выполнять сценарии, загружать профили Windows PowerShell и файлы конфигурации. The Windows PowerShell execution policy determines whether you can run scripts and load Windows PowerShell profiles and configuration files. Политика выполнения по умолчанию, Restricted, запрещает выполнение сценариев и блокирует загрузку профилей. The default execution policy, Restricted, prevents all scripts from running, and prevents loading profiles. Чтобы изменить эту политику выполнения и разрешить загрузку и использование профилей, см. описание Set-ExecutionPolicy и about_Signing. 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 . Созданный файл появится в новой вкладке, расположенной под текущей вкладкой PowerShell. Помните, что вкладки PowerShell отображаются, только если их несколько. 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. По умолчанию создается файл сценария ( .ps1 ), но его можно сохранить с новым именем и расширением. By default a file of type script ( .ps1 ) is created, but it can be saved with a new name and extension. На одной вкладке PowerShell может быть создано несколько файлов сценариев. 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

На вкладке файла, которую нужно закрыть, щелкните значок закрытия ( X ) или откройте меню File (Файл) и выберите Close (Закрыть). 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
• Нажмите CTRL + BREAK . Press CTRL + BREAK
• В меню Файл выберите Остановить операцию . Select the File menu and click Stop Operation .

Нажатие клавиш CTRL + C также сработает, если нет выделенного текста. В противном случае нажатие клавиш CTRL + C приведет к копированию выделенного текста. 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. Для этого используются те же клавиши, как и во всех других приложениях Windows. 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. Цветовая подсветка синтаксиса и заполнение нажатием клавиши TAB обеспечивают более широкие возможности для редактирования в интегрированной среде скриптов Windows PowerShell. Syntax coloring and tab completion provide a richer editing experience in Windows PowerShell ISE.
3. Подробную информацию о заполнении нажатием клавиши TAB, помогающем при вводе кода, см. в статье How to Use Tab Completion in the Script Pane and Console Pane (Использование заполнения нажатием клавиши TAB в областях сценариев и консоли). 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. Чтобы найти текст в любой части скрипта, нажмите клавиши CTRL + F или выберите Find in Script (Найти в сценарии) в меню Edit (Правка). To find text anywhere, press CTRL + F or, on the Edit menu, click Find in Script .
2. Чтобы найти текст после курсора, нажмите клавишу F3 или выберите Найти следующее в сценарии в меню Правка . To find text after the cursor, press F3 or, on the Edit menu, click Find Next in Script .
3. Чтобы найти текст до курсора, нажмите клавиши SHIFT + F3 или выберите Find Previous in Script (Найти предыдущее в сценарии) в меню Edit (Правка). 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

Нажмите клавиши CRTL + H или в меню Edit (Правка) выберите Replace in Script (Заменить в сценарии). 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

В области сценариев нажмите клавиши CTRL + G или выберите Go to Line (Перейти к строке) в меню Edit (Правка). 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.

Нажмите клавиши CTRL + C , щелкните значок Copy (Копировать) на панели инструментов или выберите Copy (Копировать) в меню Edit (Правка). 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. Нажмите клавиши CTRL + X , щелкните значок Cut (Вырезать) на панели инструментов или выберите Cut (Вырезать) в меню Edit (Правка). 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

Нажмите клавиши CTRL + V , щелкните значок Paste (Вставить) на панели инструментов или выберите Paste (Вставить) в меню Edit (Правка). 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

Нажмите клавиши CTRL + Z , щелкните значок Undo на панели инструментов или выберите Отменить в меню Правка . 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

Нажмите клавиши CTRL + Y , щелкните значок Повторить на панели инструментов или выберите Повторить в меню Правка . 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

Нажмите клавиши CTRL + S , щелкните значок Сохранить на панели инструментов или выберите Сохранить в меню Файл . 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. Например, в поле Тип сохраняемого файла выберите «Скрипты PowerShell ( *.ps1 )». For example, in the Save as type box, select ‘PowerShell Scripts ( *.ps1 )’.
4. Выберите команду Сохранить . Click Save .

Сохранение сценария в кодировке ASCII To save a script in ASCII encoding

По умолчанию интегрированная среда сценариев Windows PowerShell сохраняет новые файлы сценариев ( .ps1 ), файлы данных сценариев ( .psd1 ) и файлы модулей сценариев ( .psm1 ) в кодировке Юникод (BigEndianUnicode). By default, Windows PowerShell ISE saves new script files ( .ps1 ), script data files ( .psd1 ), and script module files ( .psm1 ) as Unicode (BigEndianUnicode) by default. Чтобы сохранить сценарий в другой кодировке, например ASCII (ANSI), используйте методы Save или SaveAs объекта $psISE.CurrentFile. To save a script in another encoding, such as ASCII (ANSI), use the Save or SaveAs methods on the $psISE.CurrentFile object.

Следующая команда сохраняет новый сценарий в кодировке ASCII и с именем MyScript.ps1: The following command saves a new script as MyScript.ps1 with ASCII encoding.

Следующая команда заменяет текущий файл сценария на файл с таким же именем, но в кодировке ASCII: 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 поддерживает следующие параметры кодировки: ASCII, BigEndianUnicode, Unicode, UTF32, UTF7, UTF8 и Default. Windows PowerShell ISE supports the following encoding options: ASCII, BigEndianUnicode, Unicode, UTF32, UTF7, UTF8, and Default. Значение параметра Default зависит от системы. The value of the Default option varies with the system.

Интегрированная среда скриптов Windows PowerShell не изменяет кодировку файлов скриптов при использовании команд «Сохранить» или «Сохранить как». Windows PowerShell ISE doesn’t change the encoding of script files when you use the Save or Save As commands.