Skip to content

3/19/2025 PM Publish #3535

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 1 commit into from
Mar 19, 2025
Merged

3/19/2025 PM Publish #3535

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
94 changes: 52 additions & 42 deletions docs-conceptual/azps-13.3.0/install-azps-windows.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
---
description: Learn how to install and run Azure PowerShell on Windows. You can install Azure PowerShell on Windows with one command.
description: Learn how to install and run Azure PowerShell on Windows to manage your Azure resources with PowerShell. Step-by-step guide for seamless installation and updates.
ms.custom: devx-track-azurepowershell
ms.devlang: powershell
ms.service: azure-powershell
ms.topic: conceptual
title: Install Azure PowerShell on Windows | Microsoft Docs
title: Install Azure PowerShell on Windows
zone_pivot_group_filename: azure/zone-pivot-groups.json
zone_pivot_groups: install-azps-windows
---
Expand All @@ -22,7 +22,7 @@ The recommended installation method and PowerShell version for the Az PowerShell
::: zone pivot="windows-psgallery"

This article explains how to install the Az PowerShell module on Windows from the
[PowerShell Gallery](/powershell/scripting/gallery/overview).
[PowerShell Gallery][powershell-gallery].

## Prerequisites

Expand All @@ -40,26 +40,24 @@ This article explains how to install the Az PowerShell module on Windows from th

> [!IMPORTANT]
> If you have the AzureRM PowerShell module installed, see
> [Az and AzureRM coexistence](troubleshooting.md#az-and-azurerm-coexistence) before proceeding.
> [Az and AzureRM coexistence][azurerm-coexistence] before proceeding.

# [PowerShell 7](#tab/powershell)

- Install a supported version of
[PowerShell version 7 or higher](/powershell/scripting/install/installing-powershell-on-windows)
- Install a supported version of [PowerShell version 7 or higher][install-pwsh]

# [Windows PowerShell](#tab/windowspowershell)

- Update to
[Windows PowerShell 5.1](/powershell/scripting/windows-powershell/install/installing-windows-powershell#upgrading-existing-windows-powershell)
- Install [.NET Framework 4.7.2 or later](/dotnet/framework/install)
- Update to [Windows PowerShell 5.1][update-powershell51]
- Install [.NET Framework 4.7.2 or later][install-dotnet]
- Update PowerShellGet

Launch Windows PowerShell 5.1 elevated as an administrator and run the following command to
update PowerShellGet:
Launch Windows PowerShell 5.1 elevated as an administrator and run the following command to update
PowerShellGet:

```powershell
Install-Module -Name PowerShellGet -Force
```
```powershell
Install-Module -Name PowerShellGet -Force
```

---

Expand All @@ -78,21 +76,19 @@ This article explains how to install the Az PowerShell module on Windows from th
```

For more information about execution policies, see
[about_Execution_Policies](/powershell/module/microsoft.powershell.core/about/about_execution_policies).
[about_Execution_Policies][execution-policies].

## Installation

Use the [Install-Module](/powershell/module/powershellget/install-module) cmdlet to install the Az
PowerShell module:
Use the [Install-Module][install-module] cmdlet to install the Az PowerShell module:

```powershell
Install-Module -Name Az -Repository PSGallery -Force
```

## Update the Az PowerShell module

Use [Update-Module](/powershell/module/powershellget/update-module) to update to the latest version
of the Az PowerShell module:
Use [Update-Module][update-module] to update to the latest version of the Az PowerShell module:

```powershell
Update-Module -Name Az -Force
Expand All @@ -103,15 +99,14 @@ PowerShell module from your system.

## Uninstallation

To remove the Az PowerShell module, see
[Uninstall the Azure PowerShell module](uninstall-az-ps.md).
To remove the Az PowerShell module, see [Uninstall the Azure PowerShell module][uninstall-azps].

::: zone-end

::: zone pivot="windows-msi"

This article explains how to install the Az PowerShell module on Windows using an MSI installer. The
MSI installer is provided for environments where the PowerShell Gallery may be blocked by a
MSI installer is provided for environments where the PowerShell Gallery might be blocked by a
firewall, or an offline installer is needed.

> [!IMPORTANT]
Expand All @@ -134,11 +129,10 @@ firewall, or an offline installer is needed.

> [!IMPORTANT]
> If you have the AzureRM PowerShell module installed, see
> [Az and AzureRM coexistence](troubleshooting.md#az-and-azurerm-coexistence) before proceeding.
> [Az and AzureRM coexistence][azurerm-coexistence] before proceeding.

- Update to
[Windows PowerShell 5.1](/powershell/scripting/windows-powershell/install/installing-windows-powershell#upgrading-existing-windows-powershell)
- Install [.NET Framework 4.7.2 or later](/dotnet/framework/install)
- Update to [Windows PowerShell 5.1][update-powershell51]
- Install [.NET Framework 4.7.2 or later][install-dotnet]

- Set the PowerShell script execution to remote signed or less restrictive

Expand All @@ -155,19 +149,19 @@ firewall, or an offline installer is needed.
```

For more information about execution policies, see
[about_Execution_Policies](/powershell/module/microsoft.powershell.core/about/about_execution_policies).
[about_Execution_Policies][execution-poliicies].

## Installation and update

The MSI package for Azure PowerShell is available from
[GitHub](https://github.com/Azure/azure-powershell/releases):
The MSI package for Azure PowerShell is available from [GitHub][azps-github]:

1. Visit
[github.com/Azure/azure-powershell/releases](https://github.com/Azure/azure-powershell/releases)
1. Locate the most recent Az PowerShell module. They are listed chronologically with no name. For example, `9.5.0`
1. Scroll down to the end of the patch notes and click the arrow next to "Assets" to reveal the
MSI options.
1. Click on the Az-Cmdlets MSI of your choice to start the download
[github.com/Azure/azure-powershell/releases][azps-github-releases]
1. Locate the most recent Az PowerShell module. They're listed chronologically with no name. For
example, `13.3.0`
1. Scroll down to the end of the patch notes and select the arrow next to "Assets" to reveal the MSI
options.
1. Select the Az-Cmdlets MSI of your choice to start the download

The installer automatically removes older versions of the Az PowerShell module that were installed
using an MSI. The MSI package installs modules in `"${env:ProgramFiles}\WindowsPowerShell\Modules"`
Expand All @@ -185,24 +179,40 @@ Connect-AzAccount

Use your Azure account login credentials to log into the browser window that opens.

You'll need to repeat this step for every new PowerShell session you start. To learn how to persist
You need to repeat this step for every new PowerShell session you start. To learn how to persist
your Azure sign-in across PowerShell sessions, see
[Azure PowerShell context objects](context-persistence.md).
[Azure PowerShell context objects][context-persistence].

## Troubleshooting

For solutions to common installation issues with the Az PowerShell module, see
[Troubleshoot installation problems with the Az PowerShell module](troubleshooting.md#installation).
[Troubleshoot installation problems with the Az PowerShell module][troubleshoot-install].

## Provide feedback

To file an issue about the Az PowerShell module, see:
[file an issue on GitHub](https://github.com/Azure/azure-powershell/issues)
To file an issue about the Az PowerShell module, see: [File an issue on GitHub][report-issue]

To provide feedback from within a PowerShell session, use the
[Send-Feedback](/powershell/module/az.accounts/send-feedback) cmdlet.
To provide feedback from within a PowerShell session, use the [Send-Feedback][send-feedback] cmdlet.

## Next Steps

To learn more about managing your Azure resources with the Az PowerShell module, see
[Get Started with Azure PowerShell](get-started-azureps.md).
[Get Started with Azure PowerShell][get-started].

<!-- link references -->

[powershell-gallery]: /powershell/scripting/gallery/overview
[azurerm-coexistence]: troubleshooting.md#az-and-azurerm-coexistence
[install-pwsh]: /powershell/scripting/install/installing-powershell-on-windows
[update-powershell51]: /powershell/scripting/windows-powershell/install/installing-windows-powershell#upgrading-existing-windows-powershell
[install-dotnet]: /dotnet/framework/install
[execution-policies]: /powershell/module/microsoft.powershell.core/about/about_execution_policies
[install-module]: /powershell/module/powershellget/install-module
[update-module]: /powershell/module/powershellget/update-module
[uninstall-azps]: uninstall-az-ps.md
[azps-github-releases]: https://github.com/Azure/azure-powershell/releases
[context-persistence]: context-persistence.md
[troubleshoot-install]: troubleshooting.md#installation
[report-issue]: https://github.com/Azure/azure-powershell/issues
[send-feedback]: /powershell/module/az.accounts/send-feedback
[get-started]: get-started-azureps.md