Skip to content

Update Docker information #11883

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Mar 26, 2025
Merged

Update Docker information #11883

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
81f258d
Update Docker information
sdwheeler Mar 11, 2025
ecf1348
Minor edit
sdwheeler Mar 11, 2025
22c9450
Acrolinx edits and minor clarifications
sdwheeler Mar 20, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
101 changes: 45 additions & 56 deletions reference/docs-conceptual/install/PowerShell-in-Docker.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,83 +1,72 @@
---
description: How to use PowerShell that's preinstalled in a Docker image.
ms.date: 08/01/2024
description: How to use PowerShell in a Docker image.
ms.date: 03/11/2025
ms.devlang: powershell
ms.topic: conceptual
title: Using PowerShell in Docker
title: Use PowerShell in Docker
---

# Using PowerShell in Docker
# Use PowerShell in Docker

We publish Docker images with PowerShell preinstalled. This article shows you how to get
started using PowerShell in the Docker container.
The .NET team publishes Docker images with PowerShell preinstalled. This article shows you how to
get started using PowerShell in the Docker container.

## Finding available images
## Find available images

The released images require Docker 17.05 or newer. It's also expected that you are able to run
Docker without `sudo` or local administrative rights. Please follow Docker's official
[instructions][01] to install `docker` correctly.
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][02].

The release containers derive from the official distribution image, then install dependencies, and
finally install the PowerShell package.
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][01].

These containers live at [Microsoft Artifact Registry][05].
## Use PowerShell in a container

For more information about these Docker images, visit the [PowerShell-Docker][02] repository on
GitHub.

## Using PowerShell in a container

The following steps show the Docker commands required to download the image containing the latest
available stable version of PowerShell and start an interactive PowerShell session.
The following command downloads the image containing the latest available stable versions of the
.NET SDK and PowerShell.

```console
docker run -it mcr.microsoft.com/powershell
docker pull mcr.microsoft.com/dotnet/sdk:9.0
```

Use the following command to download and run the image containing the latest available preview
version of PowerShell.

```console
docker run -it mcr.microsoft.com/powershell:preview
```
> [!IMPORTANT]
> The Docker images are built from official operating system (OS) images provide by the OS
> distributor. These images may not have the latest security updates. Microsoft recommends that you
> update the OS packages to the latest version to ensure the latest security updates are applied.

### Remove the image when no longer needed

The following command is used to delete the Docker image when you no longer need it.
Use the following command to start an interactive PowerShell session in the container.

```console
docker rmi mcr.microsoft.com/powershell
docker run -it mcr.microsoft.com/dotnet/sdk:9.0 pwsh
```

## Legal and Licensing
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][07] for a list of available tags.

PowerShell is licensed under the [MIT license][03].
- For more information about tags, the [Supported tag policy][06]
- For more information about supported operating systems, see the [Supported platforms policy][05]

### Windows Docker file and image licenses
## Support lifecycle

By requesting and using the Container OS Image for Windows containers, you acknowledge, understand,
and consent to the Supplemental License Terms available on Docker hub:
The [.NET support policy][03] 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][04] repository
on GitHub.

- [Window Server Core][06]
- [Nano Server][04]
The images previously published by the PowerShell team will be marked as deprecated in the Microsoft
Container Registry (MCR).

### Telemetry
## Telemetry

By default, PowerShell collects limited telemetry without personally identifiable information 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][07].
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][08].

<!-- link references -->
[01]: https://docs.docker.com/engine/installation/
[02]: https://github.com/PowerShell/PowerShell-Docker
[03]: https://github.com/PowerShell/PowerShell/tree/master/LICENSE.txt
[04]: https://mcr.microsoft.com/product/windows/nanoserver
[05]: https://mcr.microsoft.com/product/powershell
[06]: https://mcr.microsoft.com/product/windows/servercore
[07]: https://privacy.microsoft.com/privacystatement/
[01]: /dotnet/architecture/microservices/net-core-net-framework-containers/official-net-docker-images
[02]: https://docs.docker.com/engine/installation/
[03]: https://github.com/dotnet/core/blob/main/support.md
[04]: https://github.com/dotnet/dotnet-docker
[05]: https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-platforms.md
[06]: https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-tags.md
[07]: https://mcr.microsoft.com/en-us/artifact/mar/dotnet/sdk/about
[08]: https://privacy.microsoft.com/privacystatement/