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

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

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

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

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

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

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

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

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

Чтобы быстро выделить и редактировать аргументы командлета, не нарушая синтаксис, используйте 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".