Создание PowerShell-скриптов в Windows 10 и Windows 11

В этой статье

• Как создать PowerShell-скрипты в Windows 10 и Windows 11 — Установка VS Code
• Установка расширения PowerShell в VS Code
• Создание PowerShell-скриптов в VS Code
• Изменение политики выполнения (Execution Policy) в PowerShell
• Дополнительные ресурсы для Windows 10 и Windows 11

Зная, как писать и запускать PowerShell-скрипты на Windows 10 и Windows 11, вы сможете автоматизировать повседневные задачи, ускорить отладку и упростить развёртывание. Ниже — полное руководство с практическими примерами и советами по безопасности.

Подготовка: зачем использовать VS Code с расширением PowerShell

Visual Studio Code (VS Code) — лёгкий, но мощный редактор кода, доступный на Windows, macOS и Linux. Microsoft рекомендует использовать VS Code с официальным расширением PowerShell для удобной разработки скриптов: подсветка синтаксиса, автодополнение, отладчик и интегрированный терминал.

Коротко: VS Code даёт рабочее пространство, где писать, тестировать и отлаживать .ps1-файлы быстрее чем в простом текстовом редакторе.

Установка VS Code

1. Скачайте установщик VS Code для Windows.
2. Запустите загрузочный файл (VSCodeUserSetup-{version}.exe) и следуйте мастеру установки.

Альтернатива: можно скачать ZIP-архив, распаковать и запустить инсталлятор оттуда.

После установки нужно добавить расширение PowerShell.

Установка расширения PowerShell в VS Code

1. Откройте VS Code
2. Нажмите на панель Extensions слева (значок квадратов)
3. Найдите расширение «PowerShell»
4. Нажмите кнопку Install для расширения PowerShell или PowerShell Preview

Подсказка: быстро открыть панель расширений — Ctrl + Shift + X. Список всех команд — Ctrl + Shift + P.

Создание PowerShell-скрипта в VS Code

1. Откройте VS Code
2. Меню File → New File или Ctrl + N

3. Меню File → Save As или Ctrl + Shift + S
4. Задайте имя и расположение, в поле “Save as type” выберите PowerShell и сохраните как .ps1

Файл появится с расширением .ps1. Пример простого скрипта:

Write-Host "Hello world! I created a PowerShell script!"

1. Откройте созданный файл в VS Code.
2. Вставьте или напишите код (пример выше).
3. Можно запускать скрипт через кнопку Run в правом верхнем углу или нажать F5 — откроется интегрированный терминал PowerShell и покажет вывод.

Сохраните файл через File → Save.

Изменение политики выполнения в PowerShell

По умолчанию Windows блокирует запуск неподписанных скриптов. Чтобы разрешить исполнение локальных скриптов, поменяйте политику выполнения.

1. Откройте PowerShell с правами администратора (Run as Administrator).
2. Выполните:

Set-ExecutionPolicy RemoteSigned

3. Нажмите Enter.
4. Введите A (Yes to All) и нажмите Enter.

Важно: режим RemoteSigned позволяет запускать локальные скрипты без подписи, но требует подписи для удалённых (скачанных) скриптов. Это безопаснее, чем обход (Bypass).

Быстро запустить один скрипт без смены политики

Если нужно однократно запустить скрипт без изменения системной политики, используйте параметр -ExecutionPolicy при запуске PowerShell:

powershell -ExecutionPolicy Bypass -File "C:\путь\к\скрипту\TestScript.ps1"

Это временно применит Bypass только к этой сессии.

Запуск скрипта из PowerShell

1. Откройте PowerShell как администратор (если скрипт требует прав).
2. Введите полный путь к скрипту, например:

C:\Users\DAVE\Downloads\TestScript.ps1

3. Нажмите Enter — скрипт выполнится и вы увидите вывод.

Частые ошибки и как их исправить

• “Scripts are disabled on this system”: выполнить Set-ExecutionPolicy или запустить с -ExecutionPolicy Bypass.
• “PermissionDenied”: убедитесь, что вы запускаете PowerShell с правами администратора или измените права на файл.
• Код не выполняется из VS Code: проверьте, что интегрированный терминал использует PowerShell, а не CMD или другой шелл (сменить через значок терминала).

Когда этот подход не подходит (контрпримеры)

• У вас строгая политика безопасности (GPO) в корпоративной среде — смена ExecutionPolicy может блокироваться.
• Нужно выполнять сценарии на удалённых хостах без PowerShell Remoting — используйте SSH или другие средства передач.
• Требуется полный аудит и подпись — в этом случае используйте подпись кода и централизованную выдачу сертификатов.

Альтернативные способы создания и запуска скриптов

• Windows PowerShell ISE — классический GUI-редактор, устаревающий, но всё ещё доступен в некоторых системах.
• Блокнот/Notepad++ или любой редактор текста — для простых скриптов достаточно .ps1-файла.
• Планировщик задач (Task Scheduler) — для автоматического запуска скриптов по расписанию.
• Запуск через Task Sequence/Configuration Management (SCCM, Intune) в корпоративной сети.

Мини-методология разработки PowerShell-скрипта

1. План: опишите цель скрипта и ожидаемое поведение.
2. Среда: создайте тестовую машину или контейнер, чтобы не менять продакшен.
3. Код: пишите компактно, документируйте функции и параметры.
4. Тестирование: проверяйте разные сценарии, ошибки и входные данные.
5. Подпись/Ревью: в корпоративной среде подпишите и проведите код-ревью.
6. Деплой: разместите скрипт по назначению и настройте расписание/права.

Чеклист ролей

• Для разработчика:

  • Код форматирован и документирован.
  • Имеются примеры входных данных.
  • Добавлены обработчики ошибок.

• Для системного администратора:

  • Политики ExecutionPolicy и GPO проверены.
  • Скрипт подписан при необходимости.
  • Настроена ротация логов и мониторинг.

• Для начинающего пользователя:

  • Сохраните резервную копию важных данных перед выполнением скрипта.
  • Выполняйте скрипты сначала в тестовой среде.

Критерии приёмки

• Скрипт запускается без ошибок на целевой машине.
• Вывод соответствует описанному ожидаемому результату.
• Логи содержат важные события и ошибки.
• Параметры скрипта документированы и легко настраиваются.

Безопасность и рекомендации по защите

• Предпочтительнее использовать RemoteSigned вместо Unrestricted или Bypass.
• Подписывайте корпоративные скрипты с помощью сертификатов кода.
• Не запускать скачанные скрипты без проверки содержимого.
• Используйте принцип наименьших привилегий — если администраторские права не требуются, не используйте их.

Пример более сложного скрипта с параметрами и обработкой ошибок

param(
    [Parameter(Mandatory=$true)]
    [string]$TargetPath
)

try {
    if (-not (Test-Path $TargetPath)) {
        throw "Путь не найден: $TargetPath"
    }
    $files = Get-ChildItem -Path $TargetPath -File
    foreach ($f in $files) {
        Write-Host "Файл: $($f.Name)" -ForegroundColor Cyan
    }
} catch {
    Write-Error "Ошибка при выполнении: $_"
    exit 1
}

Совместимость и миграция между Windows 10 и Windows 11

PowerShell скрипты, как правило, совместимы между Windows 10 и Windows 11. Важные моменты:

• Убедитесь в версии PowerShell (Windows PowerShell 5.1 vs PowerShell 7+). Некоторые модули и команды могут отличаться.
• Для скриптов, использующих специфичный модуль, тестируйте на целевой версии PowerShell.

Быстрый план действий (SOP) для создания и запуска скрипта

1. Установить VS Code и расширение PowerShell.
2. Создать новый файл .ps1 и написать скрипт.
3. Тестировать локально в интегрированном терминале VS Code.
4. При необходимости изменить ExecutionPolicy или запускать с -ExecutionPolicy Bypass временно.
5. Подписать и разместить в целевой среде.

Короткий глоссарий

• Execution Policy — политика выполнения PowerShell, ограничивающая запуск скриптов.
• .ps1 — расширение файла PowerShell-скрипта.
• RemoteSigned — политика, требующая подпись для удалённых скриптов.

Совет по отладке и тестам (acceptance)

• Запустите скрипт с тестовыми данными.
• Проверьте, что возвращаемый код выхода (exit code) равен 0 при успехе.
• Смоделируйте ошибочную ситуацию и убедитесь, что обработчик ошибок работает.

Дополнительные ресурсы

• Windows 10 на OnMSFT — всё, что нужно знать
• Windows 11 на OnMSFT — всё, что нужно знать
• OnPodcast: подкаст OnMSFT на YouTube

Если у вас есть идеи или советы по Windows 10 и Windows 11 — оставьте комментарий.

Итог

Создание PowerShell-скриптов в Windows 10 и Windows 11 — это простой процесс: установите VS Code, добавьте расширение PowerShell, создайте .ps1-файл и поменяйте политику выполнения при необходимости. Следуйте лучшим практикам безопасности: тестируйте, документируйте и подписывайте важные скрипты.

Важно: в корпоративных средах согласуйте изменения Execution Policy с администраторами безопасности.

Ключевые шаги: установка → создание → тест → запуск → защита.