A Visual Studio Code használata a PowerShell-fejlesztéshez

Visual Studio Code (VS Code) a Microsoft platformfüggetlen szkriptszerkesztője. A PowerShell-bővítménymellett gazdag és interaktív szkriptszerkesztési élményt nyújt, így könnyebben írhat megbízható PowerShell-szkripteket. PowerShell-szkriptek írásához a PowerShell-bővítményt tartalmazó Visual Studio Code az ajánlott szerkesztő.

A következő PowerShell-verziókat támogatja:

• PowerShell 7.2 és újabb (Windows, macOS és Linux)
• Windows PowerShell 5.1 (csak Windows rendszeren) .NET-keretrendszer 4.8-as verzióval

Jegyzet

A Visual Studio Code nem ugyanaz, mint Visual Studio.

Első lépések

Mielőtt hozzákezdene, győződjön meg arról, hogy a PowerShell létezik a rendszeren. A Windows, macOS és Linux rendszeren futó modern számítási feladatokért tekintse meg az alábbi hivatkozásokat:

• hu-HU: PowerShell telepítése Linuxra
• A PowerShell telepítése macOS-
• A PowerShell telepítése a Windows rendszerre

A hagyományos Windows PowerShell-számítási feladatokról lásd: Windows PowerShelltelepítése.

Fontos

A Windows PowerShell ISE továbbra is elérhető a Windowshoz. Ez azonban már nem aktív funkciófejlesztésben van. Az ISE csak a PowerShell 5.1-et és régebbi verzióit használja. A Windows összetevőjeként továbbra is hivatalosan támogatott a biztonság és a magas prioritású karbantartási javítások esetében. Nem tervezzük eltávolítani az ISE-t a Windowsból.

A VS Code és a PowerShell-bővítmény telepítése

1. Telepítse a Visual Studio Code-ot. További információért lásd a áttekintést a Visual Studio Codebeállításáról.

   Az egyes platformokhoz telepítési utasítások tartoznak:

   • Visual Studio Code futtatása Windows rendszeren
   • macOS-on a Visual Studio Code futtatása
   • A Visual Studio Code futtatása Linuxon

2. Telepítse a PowerShell-bővítményt.

   1. Indítsa el a VS Code alkalmazást úgy, hogy beírja a code kódot egy konzolba, vagy a code-insiders kódot, ha telepítette a Visual Studio Code Insiders verziót.
   2. Indítsa el a Gyors megnyitás funkciót Windows vagy Linux rendszeren a Ctrl+Pkombinációval. MacOS rendszeren nyomja le Cmd+P.
   3. A Gyors megnyitás mezőbe írja be a ext install powershell, és nyomja le Enterbillentyűt.
   4. Az oldalsávon megnyílik a Bővítmények nézet. Válassza ki a Microsoft PowerShell-bővítményét.
   5. Kattintson a Microsoft PowerShell-bővítményének Telepítés gombjára.
   6. Ha a telepítés után a Telepítés gomb Újratöltésgombbá változik, kattintson a Újratöltésgombra.
   7. A VS Code újratöltése után készen áll a szerkesztésre.

Új fájl létrehozásához például kattintson Fájl > Újgombra. A mentéshez kattintson Fájl > Mentés elemre, majd adjon meg egy fájlnevet, például HelloWorld.ps1. A fájl bezárásához kattintson a fájlnév melletti X. A VS Code-ból való kilépéshez Fájl > Kilépés.

A PowerShell-bővítmény telepítése korlátozott rendszerekre

Egyes rendszerek úgy vannak beállítva, hogy megkövetelik az összes kód aláírás hitelesítését. A következő hibaüzenet jelenhet meg:

Language server startup failed.

Ez a probléma akkor fordulhat elő, ha a PowerShell végrehajtási szabályzatát a Windows csoportházirend állítja be. A PowerShell-szerkesztőszolgáltatások és a VS Code PowerShell-bővítményének manuális jóváhagyásához nyisson meg egy PowerShell-parancssort, és futtassa a következő parancsot:

Import-Module $HOME\.vscode\extensions\ms-vscode.powershell*\modules\PowerShellEditorServices\PowerShellEditorServices.psd1

A rendszer megkérdezi: Szeretné futtatni a szoftvert ettől a nem megbízható közzétevőtől? A fájl futtatásához írja be a(z) A. Ezután nyissa meg a VS Code-ot, és ellenőrizze, hogy a PowerShell-bővítmény megfelelően működik-e. Ha továbbra is nehézségekbe ütközik az elindulásnál, írjon nekünk GitHub-on egy problémát.

A PowerShell bővítményhez használandó verziójának kiválasztása

Ha a PowerShell egymás mellett telepíti a Windows PowerShellt, mostantól a PowerShell egy adott verzióját is használhatja a PowerShell-bővítménysel. Ez a funkció áttekint néhány jól ismert elérési utat a különböző operációs rendszereken a PowerShell telepítéseinek felderítéséhez.

A verzió kiválasztásához kövesse az alábbi lépéseket:

1. Nyissa meg a Parancs palettát Windows vagy Linux rendszeren a Ctrl+Shift+Pbillentyűkombinációval. MacOS rendszeren használja Cmd+Shift+P.
2. Keresd meg a munkamenet-et.
3. Kattintson a PowerShell: Munkamenet menü megjelenítése.
4. Válassza ki a listában a használni kívánt PowerShell-verziót.

Ha nem tipikus helyre telepítette a PowerShellt, előfordulhat, hogy az kezdetben nem jelenik meg a Munkamenet menüben. A munkamenet menüt úgy bővítheti, hogy hozzáadja saját egyéni elérési útjait az alábbiak szerint.

A PowerShell-munkamenet menü az állapotsor jobb alsó sarkában található {} ikonból is elérhető. Az ikonra rámutatva vagy kiválasztva megjelenik egy gyorselérés a munkamenet menüjéhez és egy kis kitűző ikon. Ha a kitűzés ikont választja, a verziószám hozzáadásra kerül az állapotsorhoz. A verziószám a munkamenet menüjének parancsikonja, amely kevesebb kattintást igényel.

Jegyzet

A verziószám rögzítése replikálja a bővítmény viselkedését a VS Code 1.65 előtti verzióiban. A VS Code 1.65-ös kiadása módosította a PowerShell-bővítmény által használt API-kat, és szabványosította a nyelvi bővítmények állapotsorát.

A Visual Studio Code konfigurációs beállításai

Először is, ha nem ismeri a VS Code beállításainak módosítását, javasoljuk, hogy olvassa el Visual Studio Code beállításait dokumentációt.

A dokumentáció elolvasása után hozzáadhat konfigurációs beállításokat a settings.jsonszakaszhoz.

{
    "editor.renderWhitespace": "all",
    "editor.renderControlCharacters": true,
    "files.trimTrailingWhitespace": true,
    "files.encoding": "utf8bom",
    "files.autoGuessEncoding": true
}

Ha nem szeretné, hogy ezek a beállítások az összes fájltípust befolyásolják, a VS Code nyelvenkénti konfigurációkat is lehetővé tesz. Hozzon létre egy nyelvspecifikus beállítást úgy, hogy a beállításokat egy [<language-name>] mezőbe helyezi. Például:

{
    "[powershell]": {
        "files.encoding": "utf8bom",
        "files.autoGuessEncoding": true
    }
}

Borravaló

A VS Code fájlkódolásáról további információt a A fájlkódolásismertetése című témakörben talál. Emellett tekintse meg Az ISE-élmény replikálása a VS Code-ban további tippeket a VS Code PowerShell-szerkesztéshez való konfigurálásához.

Saját PowerShell-elérési utak hozzáadása a munkamenet menüjéhez

A Visual Studio Code: powershell.powerShellAdditionalExePathsbeállításával más PowerShell-végrehajtható elérési utakat is hozzáadhat a munkamenet menüjéhez.

Ezt a grafikus felhasználói felület használatával teheti meg:

1. A parancskatalógusban keressen rá, és válassza a Felhasználói beállítások megnyitásalehetőséget. Vagy használja a billentyűparancsot Windows vagy Linux Ctrl+,. MacOS rendszeren használja Cmd+,.
2. A Beállítások szerkesztőben keresse meg PowerShell további exe elérési útjait.
3. Kattintson Elem hozzáadásagombra.
4. Adjon meg egy Ön által választott nevet a Kulcs (Elemalatt) ezen új PowerShell-telepítéséhez.
5. A Érték (Értékalatt) esetében határozza meg a végrehajtható fájl abszolút elérési útját.

Tetszőleges számú további elérési utat adhat hozzá. A hozzáadott elemek megjelennek a munkamenet menüben, a megadott kulccsal, mint névvel.

Másik lehetőségként kulcs-érték párokat is hozzáadhat a powershell.powerShellAdditionalExePathssettings.json objektumhoz:

{
    "powershell.powerShellAdditionalExePaths": {
        "Downloaded PowerShell": "C:/Users/username/Downloads/PowerShell/pwsh.exe",
        "Built PowerShell": "C:/Users/username/src/PowerShell/src/powershell-win-core/bin/Debug/net6.0/win7-x64/publish/pwsh.exe"
    },
}

Jegyzet

A bővítmény 2022.5.0-s verziója előtt ez a beállítás a exePath és versionNamekulcsokkal rendelkező objektumok listája volt. A grafikus felhasználói felületen keresztüli konfiguráció támogatásához kompatibilitástörő változást vezettek be. Ha korábban konfigurálta ezt a beállítást, konvertálja az új formátumba. A versionName megadott érték most a Kulcs, a exePath érték pedig a Érték. Ezt egyszerűbben teheti meg az érték alaphelyzetbe állításával és a Beállítások felület használatával.

Az alapértelmezett PowerShell-verzió beállításához állítsa a powershell.powerShellDefaultVersion értéket a munkamenet menüjében megjelenő szövegre (a kulcshoz használt szövegre):

{
    "powershell.powerShellAdditionalExePaths": {
        "Downloaded PowerShell": "C:/Users/username/Downloads/PowerShell/pwsh.exe",
    },
    "powershell.powerShellDefaultVersion": "Downloaded PowerShell",
}

Miután konfigurálta ezt a beállítást, indítsa újra a VS Code-ot, vagy töltsön be újra az aktuális VS Code ablakot a Parancspalettasegítségével, írja be a Developer: Reload Window.

Ha megnyitja a munkamenet menüt, megjelenik a további PowerShell-telepítések.

Borravaló

Ha a PowerShellt forrásból hozza létre, ez nagyszerű módszer a PowerShell helyi buildjének tesztelésére.

Hibakeresés a Visual Studio Code-tal

Munkaterület nélküli hibakeresés

A VS Code 1.9-es (vagy újabb) verziójában a PowerShell-szkriptek hibakeresése a PowerShell-szkriptet tartalmazó mappa megnyitása nélkül is lehetővé teszi.

1. Nyissa meg a PowerShell szkriptfájlt a fájl > Fájl Megnyitása... opcióval.
2. Töréspont beállítása – jelöljön ki egy vonalat, majd nyomja le F9
3. A hibakeresés megkezdéséhez nyomja le F5

Ekkor megjelenik a Hibakeresési műveletek panel, amely lehetővé teszi, hogy betörjön a hibakeresőbe, lépjen tovább, folytassa és állítsa le a hibakeresést.

Munkaterület hibakeresése

A munkaterület hibakeresése a Fájl menüből megnyitott mappa környezetében végzett hibakeresést jelenti Mappa megnyitása...használatával. A megnyitott mappa általában a PowerShell-projektmappája vagy a Git-adattár gyökere. A munkaterület hibakeresése lehetővé teszi, hogy az aktuálisan megnyitott fájl hibakeresésén kívül több hibakeresési konfigurációt is definiáljon.

Hibakeresési konfigurációs fájl létrehozásához kövesse az alábbi lépéseket:

1. Nyissa meg a Hibakeresési nézetet Windows vagy Linux rendszeren a Ctrl+Shift+Dbillentyűkombináció lenyomásával. MacOS rendszeren nyomja le Cmd+Shift+D.

2. Kattintson a hivatkozásra a launch.json fájl létrehozásához.

3. A Környezet kiválasztása parancssorban válassza PowerShell-lehetőséget.

4. Válassza ki a használni kívánt hibakeresés típusát:

   • Aktuális fájl indítása – A fájl indítása és hibakeresése az aktuálisan aktív szerkesztőablakban
   • Szkript indítása – A megadott fájl vagy parancs elindítása és hibakeresése
   • Interaktív munkamenet – Az integrált konzolról végrehajtott hibakeresési parancsok
   • Csatolás – A hibakereső csatolása egy futó PowerShell-gazdafolyamathoz

A VS Code létrehoz egy könyvtárat és egy fájl .vscode\launch.json a munkaterületi mappa gyökerében a hibakeresési konfiguráció tárolásához. Ha a fájlok Egy Git-adattárban találhatók, általában a launch.json fájlt szeretné véglegesíteni. A launch.json fájl tartalma a következő:

{
  "version": "0.2.0",
  "configurations": [
      {
          "type": "PowerShell",
          "request": "launch",
          "name": "PowerShell Launch (current file)",
          "script": "${file}",
          "args": [],
          "cwd": "${file}"
      },
      {
          "type": "PowerShell",
          "request": "attach",
          "name": "PowerShell Attach to Host Process",
          "processId": "${command.PickPSHostProcess}",
          "runspaceId": 1
      },
      {
          "type": "PowerShell",
          "request": "launch",
          "name": "PowerShell Interactive Session",
          "cwd": "${workspaceRoot}"
      }
  ]
}

Ez a fájl a gyakori hibakeresési forgatókönyveket jelöli. Amikor megnyitja a fájlt a szerkesztőben, megjelenik egy Konfiguráció hozzáadása... gomb. Erre a gombra kattintva további PowerShell-hibakeresési konfigurációkat vehet fel. Az egyik hasznos konfiguráció, amelyet hozzá kell adni, PowerShell: Launch Script. Ezzel a konfigurációval megadhat egy olyan fájlt, amely opcionális argumentumokat tartalmaz, amelyeket az F5 lenyomásakor használ, függetlenül attól, hogy melyik fájl aktív a szerkesztőben.

A hibakeresési konfiguráció létrehozása után kiválaszthatja a hibakeresési munkamenet során használni kívánt konfigurációt. Válasszon ki egy konfigurációt a hibakeresési konfiguráció legördülő menüből a Hibakeresés nézet eszköztárán.

A PowerShell-bővítmény hibaelhárítása

Ha problémákat tapasztal a VS Code for PowerShell-szkriptek fejlesztésével kapcsolatban, tekintse meg a GitHubon hibaelhárítási útmutatóját.

Hasznos erőforrások

Néhány videó és blogbejegyzés hasznos lehet a VS Code-hoz készült PowerShell-bővítmény használatának megkezdéséhez:

Videók

• A Visual Studio Code használata alapértelmezett PowerShell-szerkesztőként
• Visual Studio Code: a PowerShell-szkriptek hibakeresésének részletes bemutatása

Blogbejegyzések

• PowerShell-bővítmény
• PowerShell-szkriptek írása és hibakeresése a Visual Studio Code
• Visual Studio Code-útmutató hibakeresése
• PowerShell hibakeresése a Visual Studio Code-ban
• A PowerShell-fejlesztés első lépései a Visual Studio Code-ban
• Visual Studio Code szerkesztési funkciói a PowerShell-fejlesztéshez – 1. rész
• Visual Studio Code szerkesztési funkciói a PowerShell-fejlesztéshez – 2. rész
• PowerShell-szkript hibakeresése a Visual Studio Code-ban – 1. rész
• PowerShell-szkript hibakeresése a Visual Studio Code-ban – 2. rész

PowerShell-bővítmény projekt forráskódja

A PowerShell-bővítmény forráskódja megtalálható GitHub.

Ha szeretne hozzájárulni, a Pull Request-eket nagyra értékeljük. Az első lépésekhez kövesse a GitHubon fejlesztői dokumentációját.