Met behulp van Visual Studio Code voor het ontwikkelen van PowerShellUsing Visual Studio Code for PowerShell Development

Naast de PowerShell ISE, PowerShell wordt ook goed ondersteund in Visual Studio Code.In addition to the PowerShell ISE, PowerShell is also well-supported in Visual Studio Code. Bovendien wordt de ISE niet ondersteund met PowerShell-kern wanneer Visual Studio Code wordt ondersteund voor PowerShell Core op alle platforms (Windows, Mac OS en Linux)Furthermore, the ISE is not supported with PowerShell Core, while Visual Studio Code is supported for PowerShell Core on all platforms (Windows, macOS, and Linux)

U kunt Visual Studio Code in Windows met PowerShell versie 5 met behulp van Windows 10 of door het installeren van Windows Management Framework 5.0 RTM voor eerdere Windows-besturingssystemen (bijvoorbeeld Windows 8.1, enzovoort).You can use Visual Studio Code on Windows with PowerShell version 5 by using Windows 10 or by installing Windows Management Framework 5.0 RTM for down-level Windows OSs (e.g. Windows 8.1, etc.).

Voordat u begint het, Controleer of dat PowerShell bestaat op uw systeem.Before starting it, please make sure PowerShell exists on your system. Zie voor moderne werkbelastingen op Windows-, Mac OS- en Linux:For modern workloads on Windows, macOS, and Linux, see:

Zie voor traditionele Windows PowerShell-werkbelastingen, Windows PowerShell installeren.For traditional Windows PowerShell workloads, see Installing Windows PowerShell.

Bewerken met Visual Studio CodeEditing with Visual Studio Code

1. Visual Studio Code installeren1. Installing Visual Studio Code

Belangrijk

Op Mac OS, moet u OpenSSL voor de PowerShell-uitbreiding correct te laten werken.On macOS, you must install OpenSSL for the PowerShell extension to work correctly. De eenvoudigste manier om dit te bereiken is voor het installeren van Homebrew en voer vervolgens brew install openssl.The easiest way to accomplish this is to install Homebrew and then run brew install openssl. De PowerShell-extensie is nu mogelijk zijn geladen.The PowerShell extension will now be able to load successfully.

2. Installeren van PowerShell-extensie2. Installing PowerShell Extension

  • Start de Visual Studio Code app door:Launch the Visual Studio Code app by:

    • Windows: typen code in uw PowerShell-sessieWindows: typing code in your PowerShell session
    • Linux: typen code in uw terminalLinux: typing code in your terminal
    • Mac OS: typen code in uw terminalmacOS: typing code in your terminal
  • Start snelle Open door te drukken Ctrl + P (Cmd + P op Mac).Launch Quick Open by pressing Ctrl+P (Cmd+P on Mac).

  • Typ in het vak snel openen ext install powershell en treffers Enter.In Quick Open, type ext install powershell and hit Enter.
  • De extensies weergave wilt openen op de zijmarge.The Extensions view will open on the Side Bar. Selecteer de PowerShell-uitbreiding van Microsoft.Select the PowerShell extension from Microsoft. U ziet, zoals hieronder:You will see something like below:

    VSCode

  • Klik op de installeren knop van de PowerShell-extensie van Microsoft.Click the Install button on the PowerShell extension from Microsoft.

  • Na de installatie ziet u de installeren knop verandert in opnieuw laden.After the install, you will see the Install button turns to Reload. Klik op opnieuw laden.Click on Reload.
  • Nadat Visual Studio Code opnieuw laden heeft, bent u klaar om te bewerken.After Visual Studio Code has reload, you are ready for editing.

Bijvoorbeeld voor het maken van een nieuw bestand, klikt u op File -> nieuw.For example, to create a new file, click File->New. Als u wilt opslaan, klikt u op File -> Opslaan en geef vervolgens een bestandsnaam, gaan we spreek HelloWorld.ps1.To save it, click File->Save and then provide a file name, let's say HelloWorld.ps1. U sluit het bestand, klik op 'x' naast de bestandsnaam.To close the file, click on "x" next to the file name. Om af te sluiten van Visual Studio Code File -> afsluiten.To exit Visual Studio Code, File->Exit.

Een specifieke geïnstalleerde versie van PowerShellUsing a specific installed version of PowerShell

Als u een specifieke installatie van PowerShell gebruiken met Visual Studio Code wilt, moet u een nieuwe variabele toevoegen aan het bestand van de gebruiker-instellingen.If you wish to use a specific installation of PowerShell with Visual Studio Code, you will need to add a new variable to your user settings file.

  1. Klik op File-Voorkeuren > Instellingen ->Click File -> Preferences -> Settings
  2. Twee deelvensters van de editor wordt weergegeven.Two editor panes will appear. In het deelvenster van de meest rechtse (settings.json), voeg de onderstaande instelling geschikt is voor uw besturingssysteem ergens tussen de twee accolades ({ en }) en vervang met de geïnstalleerde PowerShell-versie:In the right-most pane (settings.json), insert the setting below appropriate for your OS somewhere between the two curly brackets ({ and }) and replace with the installed PowerShell version:

     // On Windows:
     "powershell.powerShellExePath": "c:/Program Files/PowerShell/<version>/pwsh.exe"
    
     // On Linux:
     "powershell.powerShellExePath": "/opt/microsoft/powershell/<version>/pwsh"
    
     // On macOS:
     "powershell.powerShellExePath": "/usr/local/microsoft/powershell/<version>/pwsh"
    
  3. Vervangt de instelling met het pad naar het gewenste uitvoerbare PowerShellReplace the setting with the path to the desired PowerShell executable
  4. Sla het instellingenbestand en Visual Studio Code opnieuw startenSave the settings file and restart Visual Studio Code

Configuratie-instellingen voor Visual Studio CodeConfiguration settings for Visual Studio Code

U kunt configuratie-instellingen in toevoegen met behulp van de stappen in de vorige alinea settings.json.By using the steps in the previous paragraph you can add configuration settings in settings.json.

U wordt aangeraden de volgende configuratieinstellingen voor Visual Studio Code:We recommend the following configuration settings for Visual Studio Code:

{
    "csharp.suppressDotnetRestoreNotification": true,
    "editor.renderWhitespace": "all",
    "editor.renderControlCharacters": true,
    "omnisharp.projectLoadTimeout": 120,
    "files.trimTrailingWhitespace": true
}

Foutopsporing met Visual Studio CodeDebugging with Visual Studio Code

Er is geen werkruimte foutopsporingNo-workspace debugging

Vanaf versie van Visual Studio Code 1,9 kunt u PowerShell-scripts zonder te openen van de map met het PowerShell-script voor foutopsporing.As of Visual Studio Code version 1.9 you can debug PowerShell scripts without having to open the folder containing the PowerShell script. Gewoon openen met de PowerShell-scriptbestand File -> bestand openen... , stel een onderbrekingspunt in op een regel (druk op F9) en druk op F5 foutopsporing te starten.Simply open the PowerShell script file with File->Open File..., set a breakpoint on a line (press F9) and then press F5 to start debugging. Hier ziet u het actiedeelvenster voor foutopsporing worden weergegeven waarmee u in het foutopsporingsprogramma, stap, hervatten en stop foutopsporing te verdelen.You will see the Debug actions pane appear which allows you to break into the debugger, step, resume and stop debugging.

Werkruimte foutopsporingWorkspace debugging

Werkruimte foutopsporing verwijst naar het opsporen van fouten in de context van een map die u hebt geopend in met behulp van Visual Studio Code map openen... van de bestand menu.Workspace debugging refers to debugging in the context of a folder that you have opened in Visual Studio Code using Open Folder... from the File menu. De map die u opent is meestal de projectmap PowerShell en/of de hoofdmap van de Git-opslagplaats.The folder you open is typically your PowerShell project folder and/or the root of your Git repository.

U kunt zelfs in deze modus starten foutopsporing van het momenteel geselecteerde PowerShell-script door op F5 te drukken.Even in this mode, you can start debugging the currently selected PowerShell script by simply pressing F5. Echter, kunt u voor het definiëren van configuraties met meerdere foutopsporing dan alleen het geopende bestand foutopsporing werkruimte foutopsporing.However, workspace debugging allows you to define multiple debug configurations other than just debugging the currently open file. U kunt bijvoorbeeld een configuraties toevoegen:For instance, you can add a configurations to:

  • Pester tests in de foutopsporing startenLaunch Pester tests in the debugger
  • Een specifiek bestand met argumenten in het foutopsporingsprogramma startenLaunch a specific file with arguments in the debugger
  • Een interactieve sessie in de foutopsporing startenLaunch an interactive session in the debugger
  • Het foutopsporingsprogramma koppelen aan een hostproces van PowerShellAttach the debugger to a PowerShell host process

Volg deze stappen om uw configuratiebestand foutopsporing te maken:Follow these steps to create your debug configuration file:

  1. Open de Debug weergeven door te drukken Ctrl + Shift + D (Cmd + Shift + D op Mac).Open the Debug view by pressing Ctrl+Shift+D (Cmd+Shift+D on Mac).
  2. Druk op de configureren tandwielpictogram-pictogram op de werkbalk.Press the Configure gear icon in the toolbar.
  3. Visual Studio Code wordt u gevraagd te omgeving Selecteer.Visual Studio Code will prompt you to Select Environment. Kies PowerShell.Choose PowerShell.

    Als u dit doet, Visual Studio Code een map en een bestand '.vscode\launch.json' gemaakt in de hoofdmap van uw werkruimtemap.When you do this, Visual Studio Code creates a directory and a file ".vscode\launch.json" in the root of your workspace folder. Hier wordt de configuratie van de foutopsporing is opgeslagen.This is where your debug configuration is stored. Als de bestanden zich in een Git-opslagplaats, wilt u waarschijnlijk het bestand launch.json doorvoeren.If your files are in a Git repository, you will typically want to commit the launch.json file. De inhoud van het bestand launch.json zijn:The contents of the launch.json file are:

{
    "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}"
        }
    ]
}

Hiermee wordt de algemene scenario's voor foutopsporing.This represents the common debug scenarios. Echter, wanneer u dit bestand in de editor opent, ziet u een configuratie toevoegen... knop.However, when you open this file in the editor, you will see an Add Configuration... button. U kunt drukt u op deze knop om meer PowerShell foutopsporing configuraties toevoegt.You can press this button to add more PowerShell debug configurations. Een handige configuratie om toe te voegen is PowerShell: Script starten.One handy configuration to add is PowerShell: Launch Script. Met deze configuratie kunt u een specifiek bestand met optionele argumenten die moet worden gestart telkens wanneer u op F5 drukken ongeacht welk bestand is momenteel actief zijn in de editor.With this configuration, you can specify a specific file with optional arguments that should be launched whenever you press F5 no matter which file is currently active in the editor.

Wanneer de configuratie van de foutopsporing is gemaakt, kunt u selecteren welke configuratie u gebruiken tijdens een foutopsporingssessie voor wilt door een te selecteren in de configuratie van de foutopsporing vervolgkeuzelijst in de Debug van weergave-werkbalk.Once the debug configuration is established, you can select which configuration you want to use during a debug session by selecting one from the debug configuration drop-down in the Debug view's toolbar.

Er zijn enkele blogs die mogelijk nuttig om aan de slag met PowerShell-extensie voor Visual Studio Code te gaanThere are a few blogs that may be helpful to get you started using PowerShell extension for Visual Studio Code

PowerShell-extensie voor Visual Studio CodePowerShell Extension for Visual Studio Code

Broncode van de PowerShell-uitbreiding kunt u vinden op GitHub.The PowerShell extension's source code can be found on GitHub.