Utilisation de l’aide dynamique

L’aide dynamique fournit une aide juste-à-temps qui vous permet de rester concentré sur votre travail sans quitter l’endroit où vous êtes en tapant sur la ligne de commande.

Obtention de l’aide sur les cmdlets

L’aide dynamique fournit une vue de l’aide complète de la cmdlet montrée dans une mémoire tampon d’écran alternative. PSReadLine mappe la fonction ShowCommandHelp à la touche F1.

• Quand le curseur se trouve à la fin d’un nom de cmdlet entièrement développé, le fait d’appuyer sur F1 affiche l’aide de cette cmdlet.
• Quand le curseur se trouve à la fin d’un nom de paramètre entièrement développé, le fait d’appuyer sur F1 affiche l’aide de la cmdlet en commençant par le paramètre.

Le gestionnaire de page dans PSReadLine vous permet de faire défiler l’aide affichée en utilisant les touches de direction haut et bas. Le fait d’appuyer sur Q quitte la mémoire tampon écran alternative et retourne à la position actuelle du curseur sur la ligne de commande dans l’écran principal.

Obtention d’une aide centrée sur les paramètres

Le fait d’appuyer sur Alt+H fournit une aide dynamique pour les paramètres. L’aide s’affiche sous la ligne de commande actuelle de façon similaire à MenuComplete. Le curseur doit se trouver à la fin du nom du paramètre entièrement développé quand vous appuyez sur la touche Alt+H.

Sélection d’arguments sur la ligne de commande

Pour sélectionner et modifier rapidement les arguments d’une cmdlet sans perturber votre syntaxe en utilisant Alt+A. En fonction de la position du curseur, il effectue une recherche à partir de la position actuelle du curseur et s’arrête quand il trouve des arguments sur la ligne de commande.

Choix des combinaisons de touches

Certaines combinaisons de touches ne fonctionnent pas sur tous les systèmes d’exploitation et toutes les applications de terminal. Par exemple, les combinaisons de touches impliquant la touche Alt ne fonctionnent pas sur macOS par défaut. Sur Linux, Ctrl+[ correspond à Échap. En outre, Ctrl+Espace génère une séquence de touches Contrôle+2 à la place de la séquence attendue Contrôle+Espace.

Pour contourner ces particularités, mappez la fonction PSReadLine à une combinaison de touches disponible. Par exemple :

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

Pour plus d’informations sur les combinaisons de touches et les solutions de contournement, consultez Utilisation des gestionnaires de touches PSReadLine.