$ sudo teach IT
Модуль 3 · Первый скрипт · Урок 3.4

Параметры скрипта

Вы научитесь передавать скрипту папку при запуске и соберёте итоговый report.ps1.

Теория + практика~5 минутНовичок

Наш скрипт уже умеет считать файлы, решать через if и перечислять их в цикле foreach. Но папка вписана в него намертво — осталось сделать так, чтобы её можно было указать при запуске.

Параметр — настройка при запуске

Представьте кофемашину с кнопкой «размер чашки». Без кнопки она всегда наливает одно и то же, с кнопкой вы выбираете сами, а если ничего не нажали — нальёт обычную чашку. Параметр скрипта (parameter) — такая же кнопка: значение, которое вы передаёте при запуске. Объявляют параметры в блоке param, он первая команда скрипта (выше только комментарии).

PowerShell · фрагмент
param(
  $Path = "$HOME/demo"
)

Разбор по строкам

  • param( ... ) — список параметров скрипта.
  • $Path — переменная, в которую попадёт переданное значение.
  • = "$HOME/demo" — значение по умолчанию: оно сработает, если при запуске ничего не указать.

Передают параметр так же, как у командлетов: через дефис и имя. Скрипт при этом лежит в домашней папке, поэтому запускаем его с ./.

PowerShell
PS> ./report.ps1 -Path ~/demo

Итоговый report.ps1

Строка $Path = "$HOME/demo" теперь живёт в блоке param, остальное прежнее. Весь скрипт — 19 строк.

PowerShell · report.ps1
# report.ps1 — отчёт о папке
param(
  $Path = "$HOME/demo"
)

$files = Get-ChildItem -Path $Path -File | Sort-Object Name
$count = $files.Count
Write-Output "Папка: $Path"
Write-Output "Файлов: $count"

if ($count -gt 3) {
  Write-Output "Пора навести порядок!"
} else {
  Write-Output "Всё аккуратно."
}

foreach ($file in $files) {
  Write-Output $file.Name
}

Разбор по строкам

  • param( $Path = ... ) — единственная новая часть: папка стала параметром.
  • Get-ChildItem -Path $Path -File | Sort-Object Name — берём только файлы указанной папки и ставим по имени.
  • if и foreach — как в прошлых уроках.

Без параметра скрипт возьмёт папку по умолчанию:

PowerShell
PS> ./report.ps1
Вывод
Папка: /home/anya/demo
Файлов: 4
Пора навести порядок!
cat.jpg
notes.txt
song.mp3
todo.txt

А если передать папку, подставится она:

PowerShell
PS> ./report.ps1 -Path ~/demo
Вывод
Папка: ~/demo
Файлов: 4
Пора навести порядок!
cat.jpg
notes.txt
song.mp3
todo.txt

В строке «Папка» — то, что вы передали.

Попробуйте

  • ./report.ps1 -Path $HOME — отчёт о вашей домашней папке (вывод у каждого свой).
  • Передайте папку без имени параметра: ./report.ps1 ~/demo — первое значение после имени скрипта попадёт в $Path, вывод тот же, что с -Path.

Что запомнить

  • Блок param(...) — первая команда скрипта.
  • После = задают значение по умолчанию.
  • Параметр передают при запуске через дефис: ./report.ps1 -Path ~/demo.

Что вы уже умеете

  • Запускать командлеты и ходить по папкам.
  • Хранить данные в переменных и подставлять их в строки.
  • Работать с объектами и их свойствами: .Name, .Count.
  • Собирать конвейер: Sort-Object, Where-Object, Select-Object.
  • Писать скрипт с if, foreach и параметром.

Куда дальше

PowerShell отлично управляет Windows, а серверы и облака почти всегда работают на Linux. Поэтому самый полезный следующий шаг — курс «Linux и Bash для разработчика». В нём 11 модулей и 46 уроков для начинающих: терминал Ubuntu, права, процессы, переменные окружения, Bash-скрипты с функциями, расписание и SSH. Всё это собрано в проекте «Смотритель» — наборе утилит, который следит за сайтом, делает резервные копии и выкладывает его на сервер. Конвейер и маленькие команды там те же, что вы видели здесь, так что привыкать почти не придётся.

Следом — «Docker для разработчика»: 10 модулей и 43 урока, где вы упакуете приложение в контейнеры и поднимете сервис из API, базы, очереди и nginx одной командой.

Поздравляем: первый скрипт на PowerShell у вас написан и работает!