Utilisation des gestionnaires de clés PSReadLine
Le module PSReadLine fournit des gestionnaires de touches qui mappent les fonctions PSReadLine aux touches du clavier. Les combinaisons clavier correspondent à une séquence d’une ou de plusieurs touches sur lesquels l’utilisateur appuie simultanément.
Par exemple, la combinaison Ctrl+Espace consiste à appuyer simultanément sur les touches Ctrl et Espace. Une fonction PSReadLine est une action prédéfinie qui peut être effectuée sur une ligne de commande. La fonction MenuComplete permet par exemple de choisir l’une des options dans une liste d’un menu pour effectuer l’entrée sur la ligne de commande.
PSReadLine comprend plusieurs gestionnaires de touches prédéfinis qui sont liés par défaut. Vous pouvez également définir vos propres gestionnaires de touches. Exécutez la commande suivante pour répertorier les gestionnaires de touches définis actuellement.
Get-PSReadLineKeyHandler
Vous pouvez également obtenir la liste de l’ensemble des fonctions PSReadLine indépendantes qui sont disponibles et peuvent être liées à une combinaison de touches.
Get-PSReadLineKeyHandler -Unbound
Vous pouvez utiliser la cmdlet Set-PSReadLineKeyHandler pour lier une fonction à un gestionnaire de touches. La commande suivante lie la fonction MenuComplete à la combinaison Ctrl+Espace.
Set-PSReadLineKeyHandler -Chord 'Ctrl+Spacebar' -Function MenuComplete
Recherche des noms et des combinaisons de touches
Les noms des touches de la combinaison sont définis par l’énumération [System.ConsoleKey]. Pour plus d’informations, consultez la documentation System.ConsoleKey. Par exemple, le nom de la touche 2 dans [System.ConsoleKey] est D2, tandis que le nom de la touche 2 sur le pavé numérique est NumPad2. Vous pouvez utiliser la méthode [System.Console]::ReadKey() pour rechercher le nom de la touche sur laquelle vous avez appuyé.
[System.Console]::ReadKey()
La sortie suivante montre les informations retournées par la méthode ReadKey() pour la combinaison de touches Ctrl+2.
KeyChar Key Modifiers
------- --- ---------
D2 Control
Pour les cmdlets de gestionnaire de touches PSReadLine, cette combinaison est représentée par Ctrl+D2. L’exemple suivant lie cette combinaison à une fonction.
Set-PSReadLineKeyHandler -Chord 'Ctrl+D2' -Function MenuComplete
Vous pouvez lier plusieurs combinaisons à une fonction unique. Par défaut, la fonction BackwardDeleteChar est liée à deux combinaisons.
Get-PSReadLineKeyHandler -Chord Backspace, Ctrl+h
Key Function Description
--- -------- -----------
Backspace BackwardDeleteChar Delete the character before the cursor
Ctrl+h BackwardDeleteChar Delete the character before the cursor
Notes
Le paramètre Combinaisonrespecte la casse. Cela signifie que vous pouvez créer différentes liaisons pour Ctrl+X et Ctrl+x.
Sur Windows, vous pouvez également utiliser la combinaison de touches Alt+? pour afficher la fonction liée à la combinaison de touches suivante que vous entrez. Quand vous tapez Alt+?, l’invite suivante s’affiche :
what-is-key:
Quand vous appuyez sur la touche Retour arrière, vous obtenez la réponse suivante :
Backspace: BackwardDeleteChar - Delete the character before the cursor
Gestionnaires de touches sur des ordinateurs non Windows
Les codes de touche générés par votre clavier peuvent varier selon le système d’exploitation et l’application de terminal utilisés.
macOS
Le clavier Macintosh n’a pas de touche Alt comme les systèmes Windows et Linux. Il comporte la touche ⌥ Option à la place. macOS utilise cette touche différemment de la touche Alt sur d’autres systèmes. Toutefois, il est possible de configurer le terminal et les applications iTerm2 sur macOS afin de les traiter comme une touche Alt.
Configuration de l’application de terminal
Ouvrez la fenêtre Paramètres dans la barre de l’application dans Terminal.app. Sélectionnez Profils et choisissez le profil que vous souhaitez configurer. Sélectionnez l’onglet Clavier dans les options de configuration. Sous la liste des touches, sélectionnez le paramètre Utiliser l’option en tant que touche Méta. Ce paramètre permet d’utiliser la touche Option ⌥ en tant que touche Alt dans l’application de terminal.
Configuration de l’application iTerm2
Ouvrez la fenêtre Paramètres dans la barre de l’application dans iTerm.app. Sélectionnez Profils et choisissez le profil que vous souhaitez configurer. Sélectionnez l’onglet Touches dans les options de configuration. Sélectionnez l’option Échap+ pour les paramètres Touche Option gauche et Touche Option droite. Ce paramètre permet d’utiliser la touche Option ⌥ en tant que touche Alt dans l’application iTerm.
Notes
Les étapes exactes peuvent varier en fonction des versions de macOS et des applications de terminal. Ces exemples ont été capturés sur macOS Ventura 13.2.1 et iTerm2 v3.4.16.
Linux
Sur les plateformes Linux, le code de touche généré peut être différent des autres systèmes. Par exemple :
Ctrl+[ correspond à Échap
Ctrl+Espace génère les codes de touche pour Ctrl+D2. Si vous souhaitez mapper une fonction Ctrl+Espace, vous devez utiliser la combinaison
Ctrl+D2.Set-PSReadLineKeyHandler -Chord 'Ctrl+D2' -Function MenuComplete
Utilisez la méthode ReadKey() pour vérifier les codes de touche générés par votre clavier.
Gestionnaires de touches courants
Voici quelques gestionnaires de touches couramment utilisés qui sont liés par défaut sur Windows. Notez que la combinaison de touches peut varier sur les plateformes non Windows.
MenuComplete
Terminez l’entrée en sélectionnant des valeurs de saisie possibles dans un menu.
Combinaison par défaut : Ctrl+Spacebar
L’exemple suivant montre le menu des saisies possibles pour les commandes commençant par select.
PS C:\> select<Ctrl+Spacebar>
select Select-Object Select-PSFPropertyValue Select-Xml
Select-AzContext Select-PSFConfig Select-PSMDBuildProject
Select-AzSubscription Select-PSFObject Select-String
Select-Object
Utilisez les touches de direction pour sélectionner la saisie souhaitée. Appuyez sur la touche Entrée pour terminer l’entrée. Quand vous parcourez les sélections, l’aide s’affiche sous le menu pour la commande sélectionnée.
ClearScreen
Cette fonction efface l’écran de la même façon que les commandes cls ou clear.
Combinaison par défaut : Ctrl+l
SelectCommandArgument
Sélectionne l’argument suivant sur la ligne de commande.
Combinaison par défaut : Alt+a
Vous pouvez souhaiter réexécuter une commande de votre historique en utilisant des valeurs de paramètres différentes. Vous pouvez utiliser la combinaison pour parcourir chaque paramètre et modifier la valeur selon les besoins.
New-AzVM -ResourceGroupName myRGName -Location eastus -Name myVM
Appuyez sur Alt+a pour sélectionner l’argument de paramètre suivant à son tour : myRGName, eastus, myVM.
GotoBrace
Déplace le curseur jusqu’à l’accolade correspondante.
Combinaison par défaut : Ctrl+]
Cette fonction déplace votre curseur jusqu’à l’accolade fermante qui correspond à l’accolade à la position actuelle du curseur sur la ligne de commande. La fonction fonctionne pour les crochets ([]), les accolades ({}) et les parenthèses (()).
DigitArgument
Démarrer ou accumuler un argument numérique permet de répéter une touche un nombre de fois spécifié.
Combinaison par défaut : Alt+0 à Alt+9
Par exemple, si vous tapez Alt+4+#, l’entrée #### est saisie dans la ligne de commande.
