Skip to content

Commit e45a3d4

Browse files
authored
Merge pull request #134107 from paulth1/network-watcher-update
edit pass: network-watcher-update
2 parents 7a0a376 + 73cab03 commit e45a3d4

File tree

1 file changed

+36
-31
lines changed

1 file changed

+36
-31
lines changed
Lines changed: 36 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
2-
title: Update the Network Watcher Extension to the latest version
3-
description: Learn how to Update Network Watcher Extension to the latest the version
2+
title: Update the Network Watcher extension to the latest version
3+
description: Learn how to update the Azure Network Watcher extension to the latest version.
44
services: virtual-machines-windows
55
documentationcenter: ''
66
author: damendo
@@ -16,54 +16,61 @@ ms.date: 09/23/2020
1616
ms.author: damendo
1717

1818
---
19-
# How to update the Network Watcher Extension to the latest the version
19+
# Update the Network Watcher extension to the latest version
2020

2121
## Overview
2222

23-
[Azure Network Watcher](../../network-watcher/network-watcher-monitoring-overview.md) is a network performance monitoring, diagnostic, and analytics service that allows monitoring of Azure networks. The Network Watcher Agent virtual machine extension is a requirement for capturing network traffic on demand, and other advanced functionality on Azure virtual machines.
24-
The Network Watcher extension is used by features like Connection Monitor, Connection Monitor (Preview), Connection Troubleshoot and Packet Capture.
23+
[Azure Network Watcher](../../network-watcher/network-watcher-monitoring-overview.md) is a network performance monitoring, diagnostic, and analytics service that monitors Azure networks. The Network Watcher Agent virtual machine (VM) extension is a requirement for capturing network traffic on demand and using other advanced functionality on Azure VMs. The Network Watcher extension is used by features like Connection Monitor, Connection Monitor (preview), connection troubleshoot, and packet capture.
2524

2625
## Prerequisites
27-
This document assumes you have the Network Watcher Extension installed in your virtual machine and provide instructions for updating it to the latest version.
26+
27+
This article assumes you have the Network Watcher extension installed in your VM.
2828

2929
## Latest version
30+
3031
The latest version of the Network Watcher extension is currently `1.4.1654.1`.
3132

32-
## Updating your extension
33+
## Update your extension
34+
35+
To update your extension, you need to know your extension version.
36+
37+
### Check your extension version
38+
39+
You can check your extension version by using the Azure portal, the Azure CLI, or PowerShell.
3340

34-
### Check your extension version
41+
#### Use the Azure portal
3542

36-
**Using the Azure portal**
43+
1. Go to the **Extensions** pane of your VM in the Azure portal.
44+
1. Select the **AzureNetworkWatcher** extension to see the details pane.
45+
1. Locate the version number in the **Version** field.  
3746

38-
1. Go to the ‘Extensions’ blade of your VM in the Azure portal.  
39-
2. Click on the ‘AzureNetworkWatcher’ extension to see the details pane.
40-
3. Locate the version number in the ‘Version’ field.  
47+
#### Use the Azure CLI
4148

42-
**Using Azure CLI**
43-
Run the below command from an Azure CLI prompt.  
49+
Run the following command from an Azure CLI prompt:
4450

4551
```azurecli
4652
az vm extension list --resource-group  <ResourceGroupName> --vm-name <VMName>
4753
```
4854

49-
Locate the AzureNetworkWatcher extension in the output and identify the version number from the TypeHandlerVersion field in the output. 
55+
Locate the AzureNetworkWatcher extension in the output. Identify the version number in the "TypeHandlerVersion" field in the output. 
5056

57+
#### Use PowerShell
5158

52-
**Using PowerShell**
53-
Run the following commands from a PowerShell prompt:  
59+
Run the following commands from a PowerShell prompt:
5460

5561
```powershell
5662
Get-AzVMExtension -ResourceGroupName <ResourceGroupName> -VMName <VMName> 
5763
```
5864

59-
Locate the AzureNetworkWatcher extension in the output and identify the version number from the “TypeHandlerVersion” field in the output.  
60-
65+
Locate the AzureNetworkWatcher extension in the output. Identify the version number in the "TypeHandlerVersion" field in the output.
6166

6267
### Update your extension
6368

64-
In case, your version is lower than `1.4.1654.1` (the current latest version), update your extension using any of the following options.
69+
If your version is earlier than `1.4.1654.1`, which is the current latest version, update your extension by using any of the following options.
70+
71+
#### Option 1: Use PowerShell
6572

66-
**Option 1: Use PowerShell**
73+
Run the following commands:
6774

6875
```powershell
6976
#Linux command
@@ -73,10 +80,9 @@ Set-AzVMExtension ` -ResourceGroupName "myResourceGroup1" ` -Location "WestUS"
7380
Set-AzVMExtension ` -ResourceGroupName "myResourceGroup1" ` -Location "WestUS" ` -VMName "myVM1" ` -Name "AzureNetworkWatcherExtension" ` -Publisher "Microsoft.Azure.NetworkWatcher" -Type "NetworkWatcherAgentWindows"
7481
```
7582

83+
#### Option 2: Use the Azure CLI
7684

77-
**Option 2: Use Azure CLI**
78-
79-
Force upgrade
85+
Force an upgrade.
8086

8187
```azurecli
8288
#Linux command
@@ -86,17 +92,17 @@ az vm extension set --resource-group "myResourceGroup1" --vm-name "myVM1" --name
8692
az vm extension set --resource-group "myResourceGroup1" --vm-name "myVM1" --name "NetworkWatcherAgentWindows" --publisher "Microsoft.Azure.NetworkWatcher" --force-update
8793
```
8894

89-
If that doesn't work. Remove and install the extension again, using the steps below. This will automatically add the latest version.
95+
If that doesn't work, remove and install the extension again, and follow these steps to automatically add the latest version.
9096

91-
Removing the extension
97+
Remove the extension.
9298

9399
```azurecli
94100
#Same for Linux and Windows
95101
az vm extension delete --resource-group "myResourceGroup1" --vm-name "myVM1" -n "AzureNetworkWatcherExtension"
96102
97103
```
98104

99-
Installing the extension again
105+
Install the extension again.
100106

101107
```azurecli
102108
#Linux command
@@ -107,11 +113,10 @@ az vm extension set --resource-group "DALANDEMO" --vm-name "Linux-01" --name "Ne
107113
108114
```
109115

110-
**Option 3: Reboot your VMs**
111-
112-
If you have auto-upgrade set to true for the NetworkWatcher extension. Rebooting your VM install the latest extension.
116+
#### Option 3: Reboot your VMs
113117

118+
If you have auto-upgrade set to true for the Network Watcher extension, reboot your VM installation to the latest extension.
114119

115120
## Support
116121

117-
If you need more help at any point in this article, you can refer to the Network Watcher Extension documentation ([Linux](./network-watcher-linux.md), [Windows](./network-watcher-windows.md)) or contact the Azure experts on the [MSDN Azure and Stack Overflow forums](https://azure.microsoft.com/support/forums/). Alternatively, you can file an Azure support incident. Go to the [Azure support site](https://azure.microsoft.com/support/options/) and select Get support. For information about using Azure Support, read the [Microsoft Azure support FAQ](https://azure.microsoft.com/support/faq/).
122+
If you need more help at any point in this article, see the Network Watcher extension documentation for [Linux](./network-watcher-linux.md) or [Windows](./network-watcher-windows.md). You can also contact the Azure experts on the [MSDN Azure and Stack Overflow forums](https://azure.microsoft.com/support/forums/). Alternatively, file an Azure support incident. Go to the [Azure support site](https://azure.microsoft.com/support/options/), and select **Get support**. For information about using Azure Support, read the [Microsoft Azure support FAQ](https://azure.microsoft.com/support/faq/).

0 commit comments

Comments
 (0)