Поделиться через

Использование динамической справки

Динамическая справка предоставляет оперативную помощь, которая позволяет сосредоточиться на работе, не теряя место в командной строке.

Получение помощи по командлету

Динамическая справка позволяет просматривать полную справку командлетов, отображаемую в альтернативном буфере экрана. PSReadLine сопоставляет функцию ShowCommandHelp с ключом F1.

  • Когда курсор стоит прямо в конце полностью раскрытого имени командлета, нажатие клавиши F1 отображает руководство для этого командлета.
  • Если курсор находится в конце полностью развернутого имени параметра, нажатие клавиши F1 отображает справку для командлета, связанного с параметром.

Полноэкранная динамическая справка

Пейджер в PSReadLine позволяет прокручивать отображаемую справку с помощью клавиш со стрелками вверх и вниз. Нажатие Q завершает альтернативный буфер экрана и возвращает текущую позицию курсора в командной строке на основном экране.

Справка по параметрам с фокусировкой

Нажатие Alt+h обеспечивает динамическую справку по параметрам. Справка показана ниже текущей командной строки, аналогичной MenuComplete. Курсор должен быть в конце полностью развернутого имени параметра при нажатии клавиши ALT+H .

Контекстная помощь для параметра нажатием Alt-H

Выбор аргументов в командной строке

Чтобы быстро выбрать и изменить аргументы командлета без нарушения синтаксиса с помощью Alt+a. На основе позиции курсора он выполняет поиск из текущей позиции курсора и останавливается при поиске любых аргументов в командной строке.

Выбор аргументов с помощью ALT-A

Выбор привязки ключей

Не все привязки ключей работают для всех операционных систем и приложений терминала. Например, привязки ключей для клавиши ALT не работают в macOS по умолчанию. В Linux ctrl+[ совпадает с Escape. И Ctrl+Spacebar создает последовательность нажатий клавиш Control+2 вместо ожидаемой последовательности Control+Spacebar.

Чтобы обойти эти причуды, сопоставьте функцию PSReadLine с доступным сочетанием ключей. Рассмотрим пример.

Set-PSReadLineKeyHandler -Chord 'Ctrl+l' -Function ShowParameterHelp
Set-PSReadLineKeyHandler -Chord 'Ctrl+k' -Function SelectCommandArgument

Дополнительные сведения о привязках ключей и обходных решениях см. в разделе "Использование обработчиков ключей PSReadLine".