Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
45 changes: 28 additions & 17 deletions reference/docs-conceptual/install/PowerShell-Support-Lifecycle.md
Original file line number Diff line number Diff line change
@@ -1,32 +1,43 @@
---
description: Details the policies governing support for PowerShell.
ms.date: 10/22/2025
ms.date: 03/06/2026
ms.topic: lifecycle
title: PowerShell Support Lifecycle
---
# PowerShell Support Lifecycle

> [!NOTE]
> This document is about support for PowerShell. Windows PowerShell (1.0 - 5.1) is a component of
> the Windows operating system. For more information, see
> [Product and Services Lifecycle Information][03].
There are multiple versions of PowerShell 7 that can be installed.

- **Stable release** - A stable release is a release that occurs between LTS releases. Stable
releases can contain critical fixes, innovations, and new features. Microsoft supports a Stable
release for about six months after the next LTS release.

PowerShell follows the [Microsoft Modern Lifecycle Policy][02]. Support dates follow the
[.NET Support Policy][06]. In this servicing approach, customers can choose Long Term Support (LTS)
releases or current releases.
The current Stable release is PowerShell v7.5.4.
- **Long Term Servicing (LTS) release** - An LTS release of PowerShell is an LTS release of .NET.
Updates to an LTS release only contain critical security updates and servicing fixes that are
designed to minimize impact on existing workloads.

An **LTS** release of PowerShell is an **LTS** release of .NET. Updates to an **LTS**
release only contain critical security updates and servicing fixes that are designed to minimize
impact on existing workloads.
The current LTS release is PowerShell v7.4.13.
- **Preview release** - A preview release is a version of PowerShell that's currently in
development. Preview releases can contain bug fixes, new features, and experiments. Preview
releases can contain bugs and might not be stable. For that reason, you shouldn't use them in
production environments. Preview versions aren't officially supported. They allow you to test out
new features and provide feedback. Your feedback is important and can influence the features that
get released.

A **current** release is a release that occurs between **LTS** releases. Current releases can
contain critical fixes, innovations, and new features. Microsoft supports a **current** release for
six months after the next **LTS** release.
The current Preview release is PowerShell v7.6.0-rc1.

Both **LTS** and **current** versions of PowerShell receive security updates and bug fixes.
Microsoft only supports the latest update version of a release.
PowerShell follows the [Microsoft Modern Lifecycle Policy][02]. The End of Support dates follow the
[.NET Support Policy][06] for the version of .NET that the release of PowerShell was built upon.
Both LTS and Stable releases of PowerShell receive security updates and bug fixes. Microsoft only
supports the latest update version of a release.

> [!NOTE]
> This document is about support for PowerShell, not Windows PowerShell. Windows PowerShell is a
> component of the Windows operating system and is subject to the Windows support lifecycle. For
> more information, see [Product and Services Lifecycle Information][03].

## Getting support
## Support options

Microsoft provides support for PowerShell on a best-effort basis. Support for Windows PowerShell 5.1
is provided through Windows support channels. You can use the standard paid support channels to get
Expand Down
65 changes: 34 additions & 31 deletions reference/docs-conceptual/install/install-alpine.md
Original file line number Diff line number Diff line change
@@ -1,31 +1,29 @@
---
description: How to install PowerShell on Alpine Linux
ms.date: 02/20/2026
title: Install PowerShell on Alpine Linux
ms.date: 03/06/2026
title: Install PowerShell 7 on Alpine Linux
---
# Install PowerShell on Alpine Linux
# Install PowerShell 7 on Alpine Linux

All packages are available on our GitHub [releases][03] page. After the package is installed, run
`pwsh` from a terminal. Run `pwsh-preview` if you installed a preview release. Before installing,
check the list of [Supported versions][02] below.
There are multiple package versions of PowerShell 7 that can be installed. This article focuses on
installing the latest stable release package. For more information about the package versions, see
the [PowerShell Support Lifecycle][04] article.

Newer versions of PowerShell 7 replace existing previous versions of PowerShell 7. Preview versions
of PowerShell can be installed side-by-side with other versions of PowerShell. Newer preview
versions replace existing previous preview versions. If you need to run PowerShell 7.5 side-by-side
with a previous version, reinstall the previous version using the [binary archive][05] method.
with a previous version, reinstall the previous version using the [binary archive][03] method.

[!INCLUDE [Latest version](../../includes/latest-install.md)]
## Install PowerShell 7

## Installation steps
On Alpine Linux, PowerShell is installed from the `tar.gz` package downloaded from the
[releases][01] page. Select the URL of the package version you want to install.

Installation on Alpine is based on downloading tar.gz package from the [releases][03] page. The URL
to the package depends on the version of PowerShell you want to install.

- PowerShell 7.4 (LTS) - `https://github.com/PowerShell/PowerShell/releases/download/v7.4.13/powershell-7.4.13-linux-musl-x64.tar.gz`
- PowerShell 7.5 - `https://github.com/PowerShell/PowerShell/releases/download/v7.5.4/powershell-7.5.4-linux-musl-x64.tar.gz`
- PowerShell 7.4 (LTS) - `https://github.com/PowerShell/PowerShell/releases/download/v7.4.13/powershell-7.4.13-linux-musl-x64.tar.gz`
- PowerShell 7.6-preview - `https://github.com/PowerShell/PowerShell/releases/download/v7.6.0-rc1/powershell-7.6.0-rc1-linux-musl-x64.tar.gz`

Then, in the terminal, execute the following shell commands to install PowerShell 7.4:
Use the following shell commands to install PowerShell 7:

```sh
#!/bin/bash
Expand Down Expand Up @@ -68,15 +66,14 @@ sudo ln -s /opt/microsoft/powershell/7/pwsh /usr/bin/pwsh
pwsh
```

## Uninstall PowerShell

```sh
sudo rm -rf /usr/bin/pwsh /opt/microsoft/powershell
```
## Start PowerShell 7

## PowerShell paths
After the package is installed, run `pwsh` from a terminal. If you have installed a Preview package,
run `pwsh-preview`.

- `$PSHOME` is `/opt/microsoft/powershell/7/`
- The location of `$PSHOME` varies based on the package you installed.
- For Stable and LTS packages: `/opt/microsoft/powershell/7/`
- For Preview packages: `/opt/microsoft/powershell/7-preview/`
- The profiles scripts are stored in the following locations:
- AllUsersAllHosts - `$PSHOME/profile.ps1`
- AllUsersCurrentHost - `$PSHOME/Microsoft.PowerShell_profile.ps1`
Expand All @@ -91,20 +88,26 @@ sudo rm -rf /usr/bin/pwsh /opt/microsoft/powershell
The profiles respect PowerShell's per-host configuration, so the default host-specific profiles
exists at `Microsoft.PowerShell_profile.ps1` in the same locations.

PowerShell respects the [XDG Base Directory Specification][04] on Linux.
PowerShell respects the [XDG Base Directory Specification][02] on Linux.

## Uninstall PowerShell 7

```sh
sudo rm -rf /usr/bin/pwsh /opt/microsoft/powershell
```

## Supported versions
## Supported OS versions

[!INCLUDE [Alpine support](../../includes/alpine-support.md)]

## Installation support
## Supported installation methods

Microsoft supports the installation methods in this document. There may be other methods of
installation available from other third-party sources. While those tools and methods may work,
Microsoft can't support those methods.
Microsoft supports the installation methods in this document. There may be other third-party methods
of installation available from other sources. While those tools and methods may work, Microsoft
can't support those methods.

<!-- link references -->
[02]: #supported-versions
[03]: https://aka.ms/PowerShell-Release?tag=stable
[04]: https://specifications.freedesktop.org/basedir/latest/
[05]: install-other-linux.md#binary-archives
[01]: https://github.com/PowerShell/PowerShell/releases
[02]: https://specifications.freedesktop.org/basedir/latest/
[03]: install-other-linux.md#binary-archives
[04]: PowerShell-Support-Lifecycle.md
76 changes: 42 additions & 34 deletions reference/docs-conceptual/install/install-debian.md
Original file line number Diff line number Diff line change
@@ -1,34 +1,36 @@
---
description: How to install PowerShell on Debian Linux
ms.date: 02/20/2026
title: Install PowerShell on Debian
ms.date: 03/06/2026
title: Install PowerShell 7 on Debian
---
# Install PowerShell on Debian
# Install PowerShell 7 on Debian

All packages are available on our GitHub [releases][02] page. Before installing, check the list of
[Supported versions][01] below. After the package is installed, run `pwsh` from a terminal. Run
`pwsh-lts` if you installed a preview release.
There are multiple package versions of PowerShell 7 that can be installed. This article focuses on
installing the latest stable release package. For more information about the package versions, see
the [PowerShell Support Lifecycle][05] article.

Newer versions of PowerShell 7 replace existing previous versions of PowerShell 7. Preview versions
of PowerShell can be installed side-by-side with other versions of PowerShell. Newer preview
versions replace existing previous preview versions. If you need to run PowerShell 7.5 side-by-side
with a previous version, reinstall the previous version using the [binary archive][05] method.
with a previous version, reinstall the previous version using the [binary archive][04] method.

Debian uses APT (Advanced Package Tool) as a package manager.
## Choose an installation method

[!INCLUDE [Latest version](../../includes/latest-install.md)]
On Debian Linux, you can install PowerShell using the universal `.deb` package from the Microsoft
package repository or by downloading a file from the GitHub [releases][01] page.

## Installation on Debian 11 or 12 via the Package Repository
### Install PowerShell 7 from the Package Repository

Microsoft builds and supports a variety of software products for Linux systems and makes them
available via Linux packaging clients (apt, dnf, yum, etc). These Linux software packages are hosted
on the _Linux package repository for Microsoft products_, [https://packages.microsoft.com][03], also
on the _Linux package repository for Microsoft products_, [https://packages.microsoft.com][02], also
known as _PMC_.

Installing PowerShell from PMC is the preferred method of installation.

> [!NOTE]
> This script only works for supported versions of Debian.
> This script only works for supported versions of Debian that have a package published to the
> Microsoft package repository.

```sh
#!/bin/bash
Expand Down Expand Up @@ -64,17 +66,15 @@ sudo apt-get install -y powershell
pwsh
```

## Installation via direct download
### Manually download and install PowerShell 7

PowerShell 7.2 introduced a universal package that makes installation easier. Download the universal
package from the [releases][02] page onto your Debian machine.
Download the universal package from the GitHub releases page. Choose the link for the version you
want to install.

The link to the current version is:

- PowerShell 7.4 (LTS) universal package for supported versions of Debian
- `https://github.com/PowerShell/PowerShell/releases/download/v7.4.13/powershell_7.4.13-1.deb_amd64.deb`
- PowerShell 7.5 universal package for supported versions of Debian
- `https://github.com/PowerShell/PowerShell/releases/download/v7.5.4/powershell_7.5.4-1.deb_amd64.deb`
- PowerShell 7.4 (LTS) universal package for supported versions of Debian
- `https://github.com/PowerShell/PowerShell/releases/download/v7.4.13/powershell_7.4.13-1.deb_amd64.deb`
- PowerShell 7.6-preview universal package for supported versions of Debian
- `https://github.com/PowerShell/PowerShell/releases/download/v7.6.0-rc1/powershell-preview_7.6.0-rc1-1.deb_amd64.deb`

Expand Down Expand Up @@ -109,15 +109,14 @@ rm powershell_7.5.4-1.deb_amd64.deb
pwsh
```

## Uninstall PowerShell
## Start PowerShell 7

```sh
sudo apt-get remove powershell
```
After the package is installed, run `pwsh` from a terminal. If you have installed a Preview package,
run `pwsh-preview`.

## PowerShell paths

- `$PSHOME` is `/opt/microsoft/powershell/7/`
- The location of `$PSHOME` varies based on the package you installed.
- For Stable and LTS packages: `/opt/microsoft/powershell/7/`
- For Preview packages: `/opt/microsoft/powershell/7-preview/`
- The profiles scripts are stored in the following locations:
- AllUsersAllHosts - `$PSHOME/profile.ps1`
- AllUsersCurrentHost - `$PSHOME/Microsoft.PowerShell_profile.ps1`
Expand All @@ -129,21 +128,30 @@ sudo apt-get remove powershell
- Default modules - `$PSHOME/Modules`
- PSReadLine history is recorded in `~/.local/share/powershell/PSReadLine/ConsoleHost_history.txt`

PowerShell respects the [XDG Base Directory Specification][04] on Linux.
The profiles respect PowerShell's per-host configuration, so the default host-specific profiles
exists at `Microsoft.PowerShell_profile.ps1` in the same locations.

PowerShell respects the [XDG Base Directory Specification][03] on Linux.

## Uninstall PowerShell 7

```sh
sudo apt-get remove powershell
```

## Supported versions
## Supported OS versions

[!INCLUDE [Debian support](../../includes/debian-support.md)]

## Installation support
## Supported installation methods

Microsoft supports the installation methods in this document. There may be other methods of
installation available from other third-party sources. While those tools and methods may work,
Microsoft can't support those methods.

<!-- link references -->
[01]: #supported-versions
[02]: https://aka.ms/PowerShell-Release?tag=stable
[03]: https://packages.microsoft.com
[04]: https://specifications.freedesktop.org/basedir/latest/
[05]: install-other-linux.md#binary-archives
[01]: https://github.com/PowerShell/PowerShell/releases
[02]: https://packages.microsoft.com
[03]: https://specifications.freedesktop.org/basedir/latest/
[04]: install-other-linux.md#binary-archives
[05]: PowerShell-Support-Lifecycle.md
Loading