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

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

  • Статья

Динамическая справка предоставляет JIT-справку, которая позволяет сконцентрироваться на выполнении рабочих задач без потери места ввода в командной строке.

Получение справки по командлетам

Динамическая справка предоставляет полную справку по командлетам, отображаемую в альтернативном буфере экрана. В 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 вместо ожидаемой последовательности пробела элемента управления.+

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

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

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