Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
The .NET team publishes Docker images with PowerShell preinstalled. This article shows you how to get started using PowerShell in the Docker container.
Find available images
These images require Docker 17.05 or newer. Also, you must be able to run Docker without sudo or
local administrative rights. For install instructions, see Docker's official documentation.
The .NET team publishes several Docker images designed for different development scenarios. Only the image for the .NET SDK contains PowerShell. For more information, see Official .NET Docker images.
Use PowerShell in a container
The following command downloads the image containing the latest available stable versions of the .NET SDK and PowerShell.
docker pull mcr.microsoft.com/dotnet/sdk:9.0
Use the following command to start an interactive PowerShell session in the container.
docker run -it mcr.microsoft.com/dotnet/sdk:9.0 pwsh
To download and run the latest Long Term Support (LTS) version of PowerShell, change the image name
to mcr.microsoft.com/dotnet/sdk:8.0. When you use these image tags, Docker downloads the
appropriate image for your host operating system. If you want an image for a specific operating
system, you can specify the operating system in the image tag. See the
Microsoft Artifact Registry for a list of available tags.
- For more information about tags, the Supported tag policy
- For more information about supported operating systems, see the Supported platforms policy
Support lifecycle
The .NET support policy defines how these images are supported. These images are provided for development and testing purposes only. If you need a production-ready image, you should build your own images. For more information about these Docker images, visit the dotnet-docker repository on GitHub.
The images previously published by the PowerShell team will be marked as deprecated in the Microsoft Container Registry (MCR).
Telemetry
By default, PowerShell collects limited telemetry without personal data to help aid development of
future versions of PowerShell. To opt-out of sending telemetry, create an environment variable
called POWERSHELL_TELEMETRY_OPTOUT set to a value of 1 before starting PowerShell from the
installed location. The telemetry we collect falls under the Microsoft Privacy Statement.
Collaborate with us on GitHub
The source for this content can be found on GitHub, where you can also create and review issues and pull requests. For more information, see our contributor guide.
