Udostępnij za pośrednictwem

Korzystanie z pomocy dynamicznej

  • Artykuł

Dynamiczna pomoc zapewnia pomoc just in time, która umożliwia skoncentrowanie się na pracy bez utraty miejsca pisania w wierszu polecenia.

Uzyskiwanie pomocy dotyczącej poleceń cmdlet

Pomoc dynamiczna udostępnia widok pełnej pomocy polecenia cmdlet wyświetlanej w alternatywnym buforze ekranu. Funkcja PSReadLine mapuje funkcję ShowCommandHelp na klawisz F1.

  • Gdy kursor znajduje się na końcu w pełni rozwiniętej nazwy polecenia cmdlet, naciśnięcie klawisza F1wyświetla pomoc dla tego polecenia cmdlet.
  • Gdy kursor znajduje się na końcu w pełni rozwiniętej nazwy parametru, naciśnięcie klawisza F1wyświetla pomoc dla polecenia cmdlet rozpoczynającego się od parametru .

Pomoc dynamiczna z pełnym ekranem

Pager w programie PSReadLine umożliwia przewijanie wyświetlanej pomocy przy użyciu klawiszy strzałek w górę i w dół. Naciśnięcie klawisza Q powoduje zamknięcie alternatywnego buforu ekranu i powrót do bieżącego położenia kursora w wierszu polecenia na ekranie podstawowym.

Uzyskiwanie pomocy dotyczącej parametrów ukierunkowanych

Naciśnięcie klawisza Alt+h zapewnia dynamiczną pomoc dla parametrów. Pomoc jest wyświetlana poniżej bieżącego wiersza polecenia podobnego do MenuUzupełnianie. Kursor musi znajdować się na końcu w pełni rozwiniętej nazwy parametru po naciśnięciu klawisza Alt+h.

Skoncentrowana pomoc dla parametru przy użyciu klawisza Alt-h

Wybieranie argumentów w wierszu polecenia

Aby szybko wybrać i edytować argumenty polecenia cmdlet bez zakłócania składni przy użyciu alt +a. Na podstawie położenia kursora wyszukuje on bieżące położenie kursora i zatrzymuje się po znalezieniu argumentów w wierszu polecenia.

Wybór argumentu przy użyciu alt-A

Wybieranie powiązania kluczy

Nie wszystkie powiązania kluczy działają dla wszystkich systemów operacyjnych i aplikacji terminalowych. Na przykład powiązania klawiszy alt nie działają domyślnie w systemie macOS. W systemie Linux ctrl+[ jest taki sam jak Escape. Klawisz Ctrl+Spacja generuje sekwencję klawiszy Control+2 zamiast oczekiwanej sekwencji spacji kontrolki.+

Aby obejść te dziwactwa, zamapuj funkcję PSReadLine na dostępną kombinację klawiszy. Na przykład:

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

Aby uzyskać więcej informacji na temat powiązania kluczy i obejść, zobacz Using PSReadLine key handlers (Używanie procedur obsługi kluczy PSReadLine).