Uso de la ayuda dinámica

La ayuda dinámica proporciona ayuda Just-In-Time que le permite centrarse en el trabajo sin perder la posición mientras escribe en la línea de comandos.

Obtención de ayuda de cmdlets

La ayuda dinámica proporciona una vista de la ayuda completa del cmdlet que se muestra en un búfer de pantalla alternativo. PSReadLine asigna la función ShowCommandHelp a la tecla F1.

  • Cuando el cursor se encuentra al final de un nombre de cmdlet totalmente expandido, al presionar F1se muestra la ayuda de ese cmdlet.
  • Cuando el cursor se encuentra al final de un nombre de parámetro totalmente expandido, al presionar F1se muestra la ayuda del cmdlet comenzando en el parámetro.

Pantalla completa de Ayuda dinámica

El control de paginación de PSReadLine permite desplazar la ayuda mostrada mediante las teclas de dirección Flecha arriba y Flecha abajo. Al presionar Q se cierra el búfer de pantalla alternativo y se vuelve a la posición actual del cursor en la línea de comandos de la pantalla principal.

Obtención de ayuda de parámetros prioritaria

Al presionar Alt+h se proporciona ayuda dinámica para los parámetros. La ayuda se muestra debajo de la línea de comandos actual, de forma similar a MenuComplete. El cursor debe estar al final del nombre del parámetro totalmente expandido al presionar Alt+h.

Ayuda prioritaria para un parámetro mediante Alt-H

Selección de argumentos en la línea de comandos

Permite seleccionar y editar rápidamente los argumentos de un cmdlet sin alterar la sintaxis mediante Alt+a. En función de la posición del cursor, busca desde la posición actual y se detiene cuando encuentra cualquier argumento en la línea de comandos.

Selección de argumentos mediante Alt-A

Elección de enlaces de teclado

No todos los enlaces de teclado funcionan para todos los sistemas operativos y las aplicaciones de terminal. Por ejemplo, los enlaces de teclado para la tecla Alt no funcionan en macOS de forma predeterminada. En Linux, Ctrl+[ tiene la misma función que Escape. Y Ctrl+Barra espaciadora genera una secuencia de teclas Control+2 en lugar de la secuencia Control+Barra espaciadora esperada.

Para solucionar estas peculiaridades, asigne la función PSReadLine a una combinación de teclas disponible. Por ejemplo:

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

Para obtener más información sobre los enlaces de teclado y las soluciones alternativas, consulte Uso de los controladores de claves de PSReadLine.