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
286 changes: 153 additions & 133 deletions redir/.openpublishing.redirection.json

Large diffs are not rendered by default.

This file was deleted.

18 changes: 9 additions & 9 deletions reference/docs-conceptual/install/install-alpine.md
Original file line number Diff line number Diff line change
@@ -1,19 +1,18 @@
---
description: Information about installing PowerShell on Alpine Linux
ms.date: 10/16/2025
title: Installing PowerShell on Alpine Linux
description: How to install PowerShell on Alpine Linux
ms.date: 11/19/2025
title: Install PowerShell on Alpine Linux
---
# Installing PowerShell on Alpine Linux
# Install PowerShell 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.

> [!NOTE]
> PowerShell 7.4 is an in-place upgrade that removes previous versions of PowerShell 7. Preview
> versions of PowerShell can be installed side-by-side with other versions of PowerShell. If you
> need to run PowerShell 7.4 side-by-side with a previous version, reinstall the previous version
> using the [binary archive][05] method.
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.

[!INCLUDE [Latest version](../../includes/latest-install.md)]

Expand All @@ -24,6 +23,7 @@ to the package depends on the version of PowerShell you want to install.

- PowerShell 7.4 - `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.6-preview - `https://github.com/PowerShell/PowerShell/releases/download/v7.6.0-preview.5/powershell-7.6.0-preview.5-linux-musl-x64.tar.gz`

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

Expand Down
19 changes: 10 additions & 9 deletions reference/docs-conceptual/install/install-debian.md
Original file line number Diff line number Diff line change
@@ -1,19 +1,18 @@
---
description: Information about installing PowerShell on Debian Linux
ms.date: 10/16/2025
title: Installing PowerShell on Debian
description: How to install PowerShell on Debian Linux
ms.date: 11/19/2025
title: Install PowerShell on Debian
---
# Installing PowerShell on Debian
# Install PowerShell 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.

> [!NOTE]
> PowerShell 7.4 is an in-place upgrade that removes previous versions of PowerShell 7. Preview
> versions of PowerShell can be installed side-by-side with other versions of PowerShell. If you
> need to run PowerShell 7.4 side-by-side with a previous version, reinstall the previous version
> using the [binary archive][05] method.
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.

Debian uses APT (Advanced Package Tool) as a package manager.

Expand Down Expand Up @@ -75,6 +74,8 @@ The link to the current version is:
- `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.6-preview universal package for supported versions of Debian
- `https://github.com/PowerShell/PowerShell/releases/download/v7.6.0-preview.5/powershell-preview_7.6.0-preview.5-1.deb_amd64.deb`

The following shell script downloads and installs the current release of PowerShell. You can
change the URL to download the version of PowerShell that you want to install.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,20 +1,19 @@
---
description: Information about installing PowerShell on macOS
ms.date: 10/23/2025
title: Installing PowerShell on macOS
description: How to install PowerShell on macOS
ms.date: 11/19/2025
title: Install PowerShell on macOS
---

# Installing PowerShell on macOS
# Install PowerShell on macOS

PowerShell 7 or higher requires macOS 13 and higher. All packages are available on the GitHub
[releases][11] page for PowerShell. After the package is installed, run `pwsh` from a terminal.
Before installing, check the list of [Supported versions][08].

> [!NOTE]
> PowerShell 7.4 is an in-place upgrade that removes previous versions of PowerShell 7. You can
> install preview versions of PowerShell side-by-side with other versions of PowerShell. If you need
> to run PowerShell 7.4 side-by-side with a previous version, reinstall the previous version using
> the [binary archive][03] method.
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][03] method.

[!INCLUDE [Latest version](../../includes/latest-install.md)]

Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,118 @@
---
description: How to install PowerShell on Windows IoT and Nano Server.
ms.date: 11/19/2025
title: Install PowerShell on Windows IoT and Nano Server
---
# Install PowerShell on Windows IoT and Nano Server

This article describes how to install PowerShell on Windows IoT and Nano Server.

## Deploy on Windows 11 IoT

Windows 11 IoT Enterprise comes with Windows PowerShell, which is used to deploy PowerShell 7.

```powershell
# Replace the placeholder information for the following variables:
$deviceip = '<device ip address>'
$zipfile = 'PowerShell-7.5.4-win-arm64.zip'
$downloadfolder = 'U:\Users\Administrator\Downloads'
# The download location is local to the device.
# There should be enough space for the zip file and the unzipped contents.

# Create PowerShell session to target device
Set-Item -Path WSMan:\localhost\Client\TrustedHosts $deviceip
$S = New-PSSession -ComputerName $deviceIp -Credential Administrator
# Copy the ZIP package to the device
Copy-Item $zipfile -Destination $downloadfolder -ToSession $S

#Connect to the device and expand the archive
Enter-PSSession $S
Set-Location U:\Users\Administrator\Downloads
Expand-Archive .\PowerShell-7.5.4-win-arm64.zip

# Set up remoting to PowerShell 7
Set-Location .\PowerShell-7.5.4-win-arm64
# Be sure to use the -PowerShellHome parameter otherwise it tries to create a new
# endpoint with Windows PowerShell 5.1
.\Install-PowerShellRemoting.ps1 -PowerShellHome .
```

When you set up PowerShell Remoting you get an error message and are disconnected from the device.
PowerShell has to restart WinRM. Now you can connect to PowerShell 7 endpoint on device.

```powershell

# Be sure to use the -Configuration parameter. If you omit it, you connect to Windows PowerShell 5.1
Enter-PSSession -ComputerName $deviceIp -Credential Administrator -Configuration PowerShell.7.5.4
```

Windows 11 IoT Core adds Windows PowerShell when you include _IOT_POWERSHELL_ feature. Use Windows
PowerShell to deploy PowerShell 7 using the same steps as Windows 11 IoT Enterprise.

To add the latest PowerShell in the shipping image, use the [Import-PSCoreRelease][02] command to
include the package in the workarea and add the _OPENSRC_POWERSHELL_ feature to your image.

> [!NOTE]
> For ARM64 architecture, Windows PowerShell isn't added when you include _IOT_POWERSHELL_. So the
> zip based install doesn't work. You need to use `Import-PSCoreRelease` command to add it in
> the image.

## Deploying on Nano Server

These instructions assume that the Nano Server is a "headless" OS that has a version of PowerShell
already running on it. For more information, see the [Nano Server Image Builder][01]
documentation.

PowerShell binaries can be deployed using two different methods.

1. Offline - Mount the Nano Server VHD and unzip the contents of the zip file to your chosen
location within the mounted image.
1. Online - Transfer the zip file over a PowerShell Session and unzip it in your chosen location.

In both cases, you need the [Windows x64 ZIP release package][03]. Run the commands within an
"Administrator" instance of PowerShell.

### Offline Deployment of PowerShell

1. Use your favorite zip utility to unzip the package to a directory within the mounted Nano Server
image.
1. Unmount the image and boot it.
1. Connect to the built-in instance of Windows PowerShell.

### Online Deployment of PowerShell

Deploy PowerShell to Nano Server using the following steps.

```powershell
# Replace the placeholder information for the following variables:
$ipaddr = '<Nano Server IP address>'
$credential = Get-Credential # <An Administrator account on the system>
$zipfile = 'PowerShell-7.5.4-win-x64.zip'
# Connect to the built-in instance of Windows PowerShell
$session = New-PSSession -ComputerName $ipaddr -Credential $credential
# Copy the file to the Nano Server instance
Copy-Item $zipfile C:\ -ToSession $session
# Enter the interactive remote session
Enter-PSSession $session
# Extract the ZIP file
Expand-Archive -Path C:\PowerShell-7.5.4-win-x64.zip -DestinationPath 'C:\Program Files\PowerShell 7'
```

## Supported versions of Windows

[!INCLUDE [Windows support](../../includes/windows-support.md)]

You can check the version that you are using by running `winver.exe`.

## Installation support

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.

[!INCLUDE [Latest version](../../includes/latest-install.md)]

<!-- link references -->
[01]: /windows-server/get-started/deploy-nano-server
[02]: https://github.com/ms-iot/iot-adk-addonkit/blob/master/Tools/IoTCoreImaging/Docs/Import-PSCoreRelease.md#Import-PSCoreRelease
[03]: https://github.com/PowerShell/PowerShell/releases/download/v7.5.4/PowerShell-7.5.4-win-x64.zip
Loading