Document Details
Vpn Troubleshoot Powershell
❌
This page contains Windows bias
About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
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 ID | Status | Bias Status |
|---|---|---|---|
| 2025-08-17 00:01 | #83 | in_progress | ✅ Clean |
| 2025-07-13 21:37 | #48 | completed | ❌ Biased |
| 2025-07-12 23:44 | #41 | in_progress | ❌ Biased |
| 2025-07-09 13:09 | #3 | cancelled | ✅ Clean |
| 2025-07-08 04:23 | #2 | cancelled | ❌ Biased |
Flagged Code Snippets
---
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.
# [**Connection**](#tab/connection)
Use [Start-AzNetworkWatcherResourceTroubleshooting](/powershell/module/az.network/start-aznetworkwatcherresourcetroubleshooting) to start troubleshooting the VPN connection.