Vpn Troubleshoot Powershell - Document Details

About This Page

This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.

View on GitHub 📚 View on Microsoft Learn

Bias Analysis

Detected Bias Types

powershell_heavy

windows_first

missing_linux_example

windows_tools

Summary

The documentation page exclusively uses PowerShell cmdlets and Azure PowerShell modules for all examples and instructions, with no mention or examples of Linux-native tools, Bash, or Azure CLI commands within the main content. The prerequisites and workflow are centered around PowerShell and Azure Cloud Shell (which defaults to PowerShell), and Windows-centric tools like Storage Explorer are referenced. Although a related link to an Azure CLI-based guide is provided at the end, the main troubleshooting workflow is presented only in PowerShell, implicitly prioritizing Windows environments and omitting Linux parity.

Recommendations

Provide equivalent Azure CLI (az) command examples alongside PowerShell for all troubleshooting steps.
Explicitly mention that Azure Cloud Shell supports both Bash and PowerShell, and show how to select Bash.
Include Linux/Bash-specific instructions for setting up prerequisites and running troubleshooting commands.
Reference cross-platform tools for accessing storage account logs (e.g., az storage blob download, or third-party Linux tools) in addition to Storage Explorer.
Consider restructuring the documentation to present both PowerShell and CLI/Bash workflows in parallel tabs or sections, ensuring equal visibility.

Create Pull Request

Scan History

Date	Scan	Status	Result
2026-01-14 00:00	#250	in_progress	Biased
2026-01-13 00:00	#246	completed	Biased
2026-01-11 00:00	#240	completed	Biased
2026-01-10 00:00	#237	completed	Biased
2026-01-09 00:34	#234	completed	Biased
2026-01-08 00:53	#231	completed	Biased
2026-01-06 18:15	#225	cancelled	Clean
2025-08-17 00:01	#83	cancelled	Clean
2025-07-13 21:37	#48	completed	Biased
2025-07-12 23:44	#41	cancelled	Biased
2025-07-09 13:09	#3	cancelled	Clean
2025-07-08 04:23	#2	cancelled	Biased

Flagged Code Snippets

# [**Connection**](#tab/connection)

Use [Start-AzNetworkWatcherResourceTroubleshooting](/powershell/module/az.network/start-aznetworkwatcherresourcetroubleshooting) to start troubleshooting the VPN connection.

---

After the troubleshooting request is completed, ***healthy*** or ***unhealthy*** is returned. Detailed logs are stored in the storage account container you specified in the previous command. For more information, see [Log files](vpn-troubleshoot-overview.md#log-files). You can use Storage explorer or any other way you prefer to access and download the logs. For more information, see [Get started with Storage Explorer](../vs-azure-tools-storage-manage-with-storage-explorer.md). 

## Troubleshoot using a new storage account

In this section, you learn how to troubleshoot a VPN virtual network gateway or a VPN connection using a new storage account.

# [**Gateway**](#tab/gateway) 

Use [New-AzStorageAccount](/powershell/module/az.storage/new-azstorageaccount) and [New-AzStorageContainer](/powershell/module/az.storage/new-azstoragecontainer) to create a new storage account and a container. Then, use [Start-AzNetworkWatcherResourceTroubleshooting](/powershell/module/az.network/start-aznetworkwatcherresourcetroubleshooting) to start troubleshooting the VPN gateway.

# [**Connection**](#tab/connection)

Use [New-AzStorageAccount](/powershell/module/az.storage/new-azstorageaccount) and [New-AzStorageContainer](/powershell/module/az.storage/new-azstoragecontainer) to create a new storage account and a container. Then, use [Start-AzNetworkWatcherResourceTroubleshooting](/powershell/module/az.network/start-aznetworkwatcherresourcetroubleshooting) to start troubleshooting the VPN gateway.