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
Summary:
The documentation page exclusively uses PowerShell cmdlets and examples for VPN troubleshooting, with no Azure CLI, Bash, or Linux-native command examples provided. The prerequisites and instructions focus on Azure PowerShell and Cloud Shell, which, while available cross-platform, are more familiar to Windows users. There is no mention of Linux shell scripting or CLI workflows in the main content, and the only reference to CLI is in the 'Related content' section, not in the main instructional flow.
Recommendations:
- Add parallel Azure CLI examples for all PowerShell commands, ideally using Bash syntax.
- Update prerequisites to mention both Azure PowerShell and Azure CLI as supported options, with links to installation guides for each.
- Where PowerShell is referenced, clarify that Azure CLI is also available and provide a tabbed interface or side-by-side examples for both.
- Include Linux/Bash-specific notes or tips where relevant, such as accessing logs or using CLI tools.
- Ensure that links to CLI-based troubleshooting are more prominent, not just in 'Related content'.
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
# [**Connection**](#tab/connection)
Use [Start-AzNetworkWatcherResourceTroubleshooting](/powershell/module/az.network/start-aznetworkwatcherresourcetroubleshooting) to start troubleshooting the VPN connection.
# [**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.
---
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.