/vscode-powershell

Provides PowerShell language and debugging support for Visual Studio Code

Primary LanguageTypeScriptMIT LicenseMIT

PowerShell for Visual Studio Code

CI Tests Version Installs Join the chat on Discord

This extension provides rich PowerShell language support for Visual Studio Code (VS Code). Now you can write and debug PowerShell scripts using the excellent IDE-like interface that VS Code provides.

This repository, vscode-powershell, is the Language Server Protocol client for VS Code and PowerShellEditorServices is the server (also used by other editors, such as Emacs and Vim).

Available Features

Bundled with the extension is the PowerShell ISE theme. It is not activated by default, but after installing this extension either click Set Color Theme or use the theme picker and select PowerShell ISE.

Platform Support

The extension should work anywhere VS Code itself and PowerShell Core 7.2 or higher is supported. For Windows PowerShell, only version 5.1 is supported and only on a best-effort basis. PowerShell Core 6, 7.0, and 7.1 have reached end-of-support. We test the following configurations:

  • Windows Server 2022 with Windows PowerShell 5.1 and PowerShell Core 7.2
  • Windows Server 2019 with Windows PowerShell 5.1 and PowerShell Core 7.2
  • macOS 11 with PowerShell Core 7.2
  • Ubuntu 20.04 with PowerShell Core 7.2

Read the installation instructions to get more details on how to use the extension on these platforms.

For Windows PowerShell 5.1, .NET Framework 4.8 or higher is required.

Installing the Extension

The PowerShell extension can be installed from the Visual Studio Code Marketplace by clicking the Install Button. You can also install the PowerShell extension from within VS Code by opening the Extensions view with keyboard shortcut Ctrl+Shift+X, typing PowerShell, and selecting the extension.

We would encourage you to try the pre-release version whenever possible. When a Pre-Release is available, it can be installed from the marketplace using the Switch to Pre-Release Version button. You can switch back to the stable version of the extension by using the Switch to Release Version button that will appear. You can also downgrade to other versions of the extension using the arrow next to the Uninstall button and choosing Install Another Version.

Getting Help

Please our support document.

Contributing to the Code

Check out the development documentation for more details on how to contribute to this extension!

Security Note

For any security issues, please see here.

Maintainers

Current

Emeriti

License

This extension is licensed under the MIT License. Please see the third-party notices file for details on the third-party binaries that we include with releases of this project.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.