A Visual Studio Code használata távoli szerkesztéshez és hibakereséshezUsing Visual Studio Code for remote editing and debugging

Azok számára, akik már ismerik az ISE-t, előfordulhat, hogy psedit file.ps1 az integrált konzolról futtathatja a fájlok helyi vagy távoli elérését az ISE-ben.For those of you that are familiar with the ISE, you may recall that you could run psedit file.ps1 from the integrated console to open files - local or remote - right in the ISE.

Ez a funkció a VSCode PowerShell-bővítményében is elérhető.This feature is also available in the PowerShell extension for VSCode. Ez az útmutató bemutatja, hogyan teheti meg.This guide shows you how to do it.

ElőfeltételekPrerequisites

Az útmutató feltételezi, hogy rendelkezik a következővel:This guide assumes that you have:

  • Egy távoli erőforrás (pl.: egy virtuális gép, egy tároló), amelyhez hozzáférése vanA remote resource (ex: a VM, a container) that you have access to
  • PowerShell, amelyen fut, és a gazdagépenPowerShell running on it and the host machine
  • VSCode és a VSCode PowerShell-bővítményeVSCode and the PowerShell extension for VSCode

Ez a funkció a Windows PowerShell és a PowerShell Core rendszeren működik.This feature works on Windows PowerShell and PowerShell Core.

Ez a funkció akkor is működik, ha egy távoli géphez a WinRM, a PowerShell Direct vagy az SSH használatával csatlakozik.This feature also works when connecting to a remote machine via WinRM, PowerShell Direct, or SSH. Ha az SSH-t szeretné használni, de Windows rendszert használ, tekintse meg az SSH Win32-verzióját!If you want to use SSH, but are using Windows, check out the Win32 version of SSH!

Fontos

A Open-EditorFile és a psedit parancsok csak a VSCode PowerShell-bővítmény által létrehozott PowerShell integrált konzolon működnek.The Open-EditorFile and psedit commands only work in the PowerShell Integrated Console created by the PowerShell extension for VSCode.

Használati példákUsage examples

Ezek a példák távoli szerkesztést és hibakeresést mutatnak a MacBook Pro-ból egy Azure-ban futó Ubuntu virtuális gépre.These examples show remote editing and debugging from a MacBook Pro to an Ubuntu VM running in Azure. A folyamat azonos a Windows rendszeren.The process is identical on Windows.

Helyi fájlok szerkesztése a nyílt EditorFileLocal file editing with Open-EditorFile

A VSCode-hez készült PowerShell-bővítménnyel és a PowerShell integrált konzoljának megnyitásával megnyithatja Open-EditorFile foo.ps1 vagy psedit foo.ps1 megnyithatja a helyi foo.ps1 fájlt közvetlenül a szerkesztőben.With the PowerShell extension for VSCode started and the PowerShell Integrated Console opened, we can type Open-EditorFile foo.ps1 or psedit foo.ps1 to open the local foo.ps1 file right in the editor.

A nyílt EditorFile foo.ps1 helyileg működik

Megjegyzés

A fájlnak foo.ps1 már léteznie kell.The file foo.ps1 must already exist.

Innen a következőket teheti:From there, we can:

  • Töréspontok hozzáadása a csatornáhozAdd breakpoints to the gutter

    Töréspont hozzáadása a csatornához

  • A PowerShell-szkript hibakereséséhez nyomja meg az F5 billentyűt.Hit F5 to debug the PowerShell script.

    a helyi PowerShell-parancsfájl hibakeresése

A hibakeresés során használhatja a hibakeresési konzolt, megtekintheti a bal oldali hatókör változóit és az összes többi szabványos hibakereső eszközt.While debugging, you can interact with the debug console, check out the variables in the scope on the left, and all the other standard debugging tools.

Távoli fájl szerkesztése a nyílt EditorFileRemote file editing with Open-EditorFile

Most Ismerkedjen meg a távoli fájlok szerkesztésével és hibakeresésével.Now let's get into remote file editing and debugging. A lépések közel azonosak, csak egy dolog szükséges először – adja meg a PowerShell-munkamenetet a távoli kiszolgálón.The steps are nearly the same, there's just one thing we need to do first - enter our PowerShell session to the remote server.

Ehhez parancsmagra van szükség.There's a cmdlet for to do so. Ezt nevezzük Enter-PSSession .It's called Enter-PSSession.

A parancsmagnak a (z):The watered down explanation of the cmdlet is:

  • Enter-PSSession -ComputerName foo munkamenet elindítása a WinRM használatávalEnter-PSSession -ComputerName foo starts a session via WinRM
  • Enter-PSSession -ContainerId foo és Enter-PSSession -VmId foo a munkamenet elindítása a PowerShell Direct használatávalEnter-PSSession -ContainerId foo and Enter-PSSession -VmId foo start a session via PowerShell Direct
  • Enter-PSSession -HostName foo munkamenet elindítása SSH-n keresztülEnter-PSSession -HostName foo starts a session via SSH

További információkért tekintse meg az ENTER-PSSessiondokumentációját.For more information, see the documentation for Enter-PSSession.

Mivel a macOS-ről egy Ubuntu virtuális gépre kerül az Azure-ban, az SSH-t használjuk a táveléréshez.Since we are going from macOS to an Ubuntu VM in Azure, we are using SSH for remoting.

Először az integrált konzolon futtassa a parancsot Enter-PSSession .First, in the Integrated Console, run Enter-PSSession. Csatlakozik a távoli munkamenethez, amikor a [<hostname>] prompttól balra látható.You're connected to the remote session when [<hostname>] shows up to the left of your prompt.

A ENTER-PSSession hívása távoli munkamenethez való kapcsolódáshoz

Most megteheti ugyanezeket a lépéseket, mintha egy helyi szkriptet szerkesztünk.Now, we can do the same steps as if we are editing a local script.

  1. Futtassa Open-EditorFile test.ps1 a vagy a parancsot a psedit test.ps1 Távoli fájl megnyitásához test.ps1Run Open-EditorFile test.ps1 or psedit test.ps1 to open the remote test.ps1 file

A parancsfájl szerkesztése a távoli rendszeren

  1. A fájl szerkesztése/töréspontok beállításaEdit the file/set breakpoints

    Töréspontok szerkesztése és beállítása

  2. Hibakeresés indítása (F5) a távoli fájlStart debugging (F5) the remote file

    A távoli parancsfájl hibakeresése

Ha bármilyen probléma merül fel, a GitHub-tárházban megnyithatja a problémákat.If you have any problems, you can open issues in the GitHub repo.