Skip to content

Commit 6765959

Browse files
AnnaMHuffAnnaMHuff
authored
Merge pull request #313798 from MSFT-FrankLpnsk/winget-v0
[Azure VPN Client] Adding Winget document
2 parents b8957d4 + ecb20e8 commit 6765959

5 files changed

Lines changed: 112 additions & 3 deletions

File tree

‎articles/vpn-gateway/TOC.yml‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -316,6 +316,8 @@
316316
href: azure-vpn-client-prerequisites-check.md
317317
- name: Azure VPN Client versions
318318
href: azure-vpn-client-versions.md
319+
- name: Download Azure VPN Client with Windows Package Manager (WinGet)
320+
href: point-to-site-vpn-client-winget.md
319321
- name: Report Azure VPN Client problems - Feedback Hub
320322
href: https://learn.microsoft.com/troubleshoot/azure/vpn-gateway/feedback-hub-azure-vpn-client?toc=/azure/vpn-gateway/TOC.json
321323
- name: Intune - Deploy VPN client profile

‎articles/vpn-gateway/azure-vpn-client-versions.md‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,11 @@ This article helps you view each of the versions of the Azure VPN Client. As new
1616

1717
## Azure VPN Client - Windows
1818

19+
### Supported Windows Versions
20+
[!INCLUDE [Supported Windows versions](../../includes/vpn-gateway-vwan-azure-vpn-client-windows-supported.md)]
21+
22+
### Release notes and version information
23+
1924
[!INCLUDE [windows client versions](../../includes/vpn-gateway-azure-vpn-client-windows-table.md)]
2025

2126
## Azure VPN Client - Linux

‎articles/vpn-gateway/point-to-site-vpn-client-winget.md‎

Lines changed: 98 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,98 @@
1+
---
2+
title: 'Install P2S VPN clients - Using Winget'
3+
titleSuffix: Azure VPN Gateway
4+
description: Learn how to install the VPN client for VPN Gateway P2S configurations with WinGet/Windows Package Manager. This article applies to Windows Azure VPN client.
5+
author: flapinski
6+
ms.service: azure-vpn-gateway
7+
ms.topic: how-to
8+
ms.date: 03/26/2026
9+
ms.author: flapinski
10+
# Customer intent: As a Windows user configuring a VPN client, I want to install the Azure VPN client using WinGet, so that I can securely connect to my Azure virtual network.
11+
---
12+
13+
# Install Azure VPN Client using Windows Package Manager (winget)
14+
The Azure VPN Client is now available through **Windows Package Manager (winget)**, giving you a fast, command-line-friendly way to install and update the client directly from your terminal. This is especially useful in environments where organizational policy restricts access to the Microsoft Store.
15+
16+
Windows Package Manager (`winget`) is a built-in command-line tool for Windows that lets you discover, install, and update applications. The Azure VPN Client package on winget provides a self-contained installer. No Microsoft Store access or authentication is required.
17+
18+
## Supported Platforms
19+
20+
| Operating System | Supported |
21+
|-----------------------------------|-----------|
22+
| Windows 11 (21H2 and later) | ✅ |
23+
| Windows Server 2025 | ✅ |
24+
25+
See more on Azure VPN Client supported windows settings [here](azure-vpn-client-versions.md).
26+
27+
## Prerequisites
28+
- **Windows Package Manager (winget)** must be available on your system. Learn more about installation [here](https://learn.microsoft.com/windows/package-manager/winget/).
29+
- An active internet connection is required to download the package.
30+
- Administrator rights are **not** required to install or connect.
31+
32+
## How to Install
33+
Open a terminal (PowerShell, Command Prompt, or Windows Terminal) and run:
34+
```
35+
36+
winget install "Azure VPN Client" --source winget
37+
```
38+
39+
40+
## How to Update
41+
When a newer version of the Azure VPN Client is available, you may see an in-app notification prompting you to update. To apply the update, run:
42+
43+
```
44+
45+
winget upgrade "Azure VPN Client"
46+
47+
```
48+
49+
To check for all available updates on your system:
50+
51+
```
52+
53+
winget upgrade
54+
55+
```
56+
57+
## How to Uninstall
58+
To remove the Azure VPN Client, run:
59+
60+
```
61+
winget uninstall "Azure VPN Client"
62+
63+
```
64+
65+
66+
## Limitations and Known Considerations
67+
- **Update notifications:** The in-app update prompt notifies you that a new version is available, but the update itself must be applied by running the `winget upgrade` command. Auto-update on launch isn't currently supported through this channel.
68+
69+
- **No GUI installer:** This method uses the command line. Users who prefer a graphical click-to-install experience should use the [Microsoft Store listing](https://apps.microsoft.com/detail/9NP355QT2SQB) or the [Download Center](https://aka.ms/azvpnclientdownload) where available.
70+
71+
- **Platform restrictions:** Only Windows 11 and Windows Server 2025 or later are supported.
72+
---
73+
74+
75+
76+
## Alternative Installation Methods
77+
| Method | Best For |
78+
|--------------------|-----------------------------------------------|
79+
| **Microsoft Store** | Users with Store access who prefer GUI install |
80+
| **winget (CLI)** | Scripted/automated deployments, Store-blocked environments |
81+
| **Download Center** | Direct download via browser (see link below) |
82+
83+
> [!NOTE]
84+
> The Azure VPN Client may be released to winget and Download Center on a staggered schedule compared to the Microsoft Store.
85+
86+
For the direct download option, visit: [https://aka.ms/azvpnclientdownload](https://aka.ms/azvpnclientdownload)
87+
88+
---
89+
90+
## Learn More
91+
- [Azure VPN Client documentation](point-to-site-about.md)
92+
- [Configure Azure VPN Client — Point-to-Site connections](point-to-site-vpn-client-certificate-windows-azure-vpn-client.md)
93+
- [Windows Package Manager (winget) documentation](https://learn.microsoft.com/windows/package-manager/winget/)
94+
- [winget install command reference](https://learn.microsoft.com/windows/package-manager/winget/install)
95+
96+
---
97+
98+

‎includes/vpn-gateway-download-vpn-client.md‎

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,9 +11,14 @@ ms.topic: include
1111

1212
* Install using Client Install files: [https://aka.ms/azvpnclientdownload](https://aka.ms/azvpnclientdownload).
1313
* Install directly, when signed in on a client computer: [Microsoft Store](https://go.microsoft.com/fwlink/?linkid=2117554).
14+
* Install using the Windows Package Manager (WinGet). You can run the following command to install and learn more about the WinGet method in [this document](../articles/vpn-gateway/point-to-site-vpn-client-winget.md).
15+
```azurecli-interactive
16+
winget install Microsoft.AzureVPNClient --source winget
17+
```
18+
1419

1520
1. Install the Azure VPN Client to each computer.
1621

1722
1. Verify that the Azure VPN Client has permission to run in the background. For steps, see [Windows background apps](https://support.microsoft.com/windows/windows-background-apps-and-your-privacy-83f2de44-d2d9-2b29-4649-2afe0913360a#ID0EBD=Windows_11).
1823

19-
1. To verify the installed client version, open the Azure VPN Client. Go to the bottom of the client and click **... -> ? Help**. In the right pane, you can see the client version number.
24+
1. To verify the installed client version, open the Azure VPN Client. Go to the bottom of the client and select **... -> ? Help**. In the right pane, you can see the client version number.

‎includes/vpn-gateway-vwan-azure-vpn-client-windows-supported.md‎

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -9,5 +9,4 @@ ms.topic: include
99
---
1010
While it's possible that the Azure VPN Client for Windows might work on other operating system versions, the Azure VPN Client for Windows is only supported on the following releases:
1111

12-
* Supported Windows releases: Windows 10, Windows 11 on X64 processors.
13-
* The Azure VPN Client for Windows is not supported for systems running on an ARM processor.
12+
* Supported Windows releases: Windows 10, Windows 11 on X64, X86, ARM, and ARM64 architectures.

0 commit comments

Comments
 (0)