Utilisation de Visual Studio Code pour la modification et le débogage à distance
Pour ceux d’entre vous qui connaissent l’ISE, vous pouvez vous rappeler que vous pouvez exécuter psedit file.ps1
à partir de la console intégrée pour ouvrir des fichiers ( local ou distant) directement dans l’ISE.
Cette fonctionnalité est également disponible dans l’extension PowerShell pour VSCode. Ce guide vous montre comment le faire.
Conditions préalables
Ce guide part du principe que vous disposez des points suivants :
- Ressource distante (par exemple, une machine virtuelle, un conteneur) auquel vous avez accès
- PowerShell s’exécutant sur celui-ci et l’ordinateur hôte
- VSCode et l’extension PowerShell pour VSCode
Cette fonctionnalité fonctionne sur PowerShell et Windows PowerShell.
Cette fonctionnalité fonctionne également lors de la connexion à une machine distante via WinRM, PowerShell Direct ou SSH. Si vous souhaitez utiliser SSH, mais utilisez Windows, consultez la version Win32 de SSH!
Important
Les commandes Open-EditorFile
et psedit
fonctionnent uniquement dans la console intégrée PowerShell créée par l’extension PowerShell pour VSCode.
Exemples d’utilisation
Ces exemples montrent la modification et le débogage à distance d’un MacBook Pro vers une machine virtuelle Ubuntu s’exécutant dans Azure. Le processus est identique sur Windows.
Modification de fichier local avec Open-EditorFile
Avec l’extension PowerShell pour VSCode démarrée et la console intégrée PowerShell ouverte, nous pouvons taper Open-EditorFile foo.ps1
ou psedit foo.ps1
pour ouvrir le fichier foo.ps1 local directement dans l’éditeur.
Remarque
Le fichier foo.ps1
doit déjà exister.
À partir de là, nous pouvons :
ajouter des points d’arrêt à la marge
Appuyez sur F5 pour déboguer le script PowerShell.
Lors du débogage, vous pouvez interagir avec la console de débogage, consulter les variables de la portée à gauche et utiliser tous les autres outils de débogage standard.
Modification de fichiers à distance avec Open-EditorFile
Nous allons maintenant entrer dans la modification et le débogage à distance des fichiers. Les étapes sont presque identiques, il n’y a qu’une seule chose que nous devons faire en premier : entrez notre session PowerShell sur le serveur distant.
Il existe une applet de commande pour ce faire. C’est appelé Enter-PSSession
.
Bref:
Enter-PSSession -ComputerName foo
démarre une session via WinRMEnter-PSSession -ContainerId foo
etEnter-PSSession -VmId foo
démarrer une session via PowerShell DirectEnter-PSSession -HostName foo
démarre une session via SSH
Pour plus d’informations, consultez la documentation Enter-PSSession.
Étant donné que nous nous connectons à distance à une machine virtuelle Ubuntu dans Azure, nous utilisons SSH.
Tout d’abord, dans la console intégrée, exécutez Enter-PSSession
. Vous êtes connecté à la session à distance lorsque [<hostname>]
s’affiche à gauche de votre invite.
À présent, nous pouvons effectuer les mêmes étapes que si nous avons modifié un script local.
Exécutez
Open-EditorFile test.ps1
oupsedit test.ps1
pour ouvrir le fichier detest.ps1
distantModifier le fichier / définir les points d'arrêt
Démarrer le débogage (F5) du fichier distant
Si vous rencontrez des problèmes, vous pouvez ouvrir des problèmes dans le dépôt GitHub .