You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
title: Create an Azure Network Watcher instance | Microsoft Docs
2
+
title: Create an Azure Network Watcher instance
3
3
description: Learn how to create an Azure Network Watcher in an Azure region by using the Azure portal or other technologies, and how to delete a Network Watcher.
Network Watcher is a regional service that enables you to monitor and diagnose conditions at a network scenario level in, to, and from Azure. Scenario level monitoring enables you to diagnose problems at an end to end network level view. Network diagnostic and visualization tools available with Network Watcher help you understand, diagnose, and gain insights to your network in Azure. Network Watcher is enabled through the creation of a Network Watcher resource. This resource allows you to utilize Network Watcher capabilities.
When you create or update a virtual network in your subscription, Network Watcher will be enabled automatically in your Virtual Network's region. There's no impact to your resources or associated charge for automatically enabling Network Watcher.
21
+
When you create or update a virtual network in your subscription, Network Watcher will be enabled automatically in your Virtual Network's region. Automatically enabling Network Watcher doesn't affect your resources or associated charge.
27
22
28
-
####Opt-out of Network Watcher automatic enablement
23
+
### Opt-out of Network Watcher automatic enablement
29
24
If you would like to opt out of Network Watcher automatic enablement, you can do so by running the following commands:
30
25
31
26
> [!WARNING]
32
-
> Opting-out of Network Watcher automatic enablement is a permanent change. Once you opt-out, you cannot opt-in without contacting [support](https://azure.microsoft.com/support/options/).
27
+
> Opting-out of Network Watcher automatic enablement is a permanent change. Once you opt-out, you cannot opt-in without contacting [Azure support](https://azure.microsoft.com/support/options/).
az feature register --name DisableNetworkWatcherAutocreation --namespace Microsoft.Network
41
36
az provider register -n Microsoft.Network
42
37
```
38
+
## Prerequisites
43
39
44
-
40
+
- An Azure account with an active subscription. [Create one for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
45
41
46
42
## Create a Network Watcher in the portal
47
43
48
-
1. Log into the [Azure portal](https://portal.azure.com) with an account that has the necessary permissions.
49
-
2. Select **More services**.
50
-
3. In the **All services** screen, enter **Network Watcher** in the **Filter services** search box and select it from the search result.
51
-
You can select all the subscriptions you want to enable Network Watcher for. This action creates a Network Watcher in every region that is available.
44
+
1. Sign in to the [Azure portal](https://portal.azure.com) with an account that has the necessary permissions.
45
+
46
+
2. In the search box at the top of the portal, enter *Network Watcher*.
47
+
48
+
3. In the search results, select **Network Watcher**.
49
+
50
+
4. Select **+ Add**.
52
51
53
-
52
+
5. In **Add network watcher**, select your Azure subscription, then select the region that you want to enable Azure Network Watcher for.
54
53
55
-
When you enable Network Watcher using the portal, the name of the Network Watcher instance is automatically set to *NetworkWatcher_region_name* where *region_name* corresponds to the Azure region where the instance is enabled. For example, a Network Watcher enabled in the West Central US region is named *NetworkWatcher_westcentralus*.
54
+
6. Select **Add**.
55
+
56
+
:::image type="content" source="./media/network-watcher-create/create-network-watcher.png" alt-text="Screenshot showing how to create a Network Watcher in the Azure portal.":::
57
+
58
+
When you enable Network Watcher using the Azure portal, the name of the Network Watcher instance is automatically set to *NetworkWatcher_region_name*, where *region_name* corresponds to the Azure region of the Network Watcher instance. For example, a Network Watcher enabled in the East US region is named *NetworkWatcher_eastus*.
56
59
57
60
The Network Watcher instance is automatically created in a resource group named *NetworkWatcherRG*. The resource group is created if it doesn't already exist.
58
61
59
-
If you wish to customize the name of a Network Watcher instance and the resource group it's placed into, you can use PowerShell, the Azure CLI, the REST API, or ARMClient methods described in the sections that follow. In each option, the resource group must exist before you create a Network Watcher in it.
62
+
If you wish to customize the name of a Network Watcher instance and the resource group it's placed into, you can use [PowerShell](#powershell) or [REST API](#restapi)methods. In each option, the resource group must exist before you create a Network Watcher in it.
60
63
61
-
## Create a Network Watcher with PowerShell
64
+
## <aname="powershell"></a> Create a Network Watcher using PowerShell
62
65
63
-
To create an instance of Network Watcher, run the following example:
66
+
Use [New-AzNetworkWatcher](/powershell/module/az.network/new-aznetworkwatcher) to create an instance of Network Watcher:
64
67
65
-
```powershell
66
-
New-AzNetworkWatcher -Name "NetworkWatcher_westcentralus" -ResourceGroupName "NetworkWatcherRG" -Location "West Central US"
To create an instance of Network Watcher, run the following example:
74
+
Use [az network watcher configure](/cli/azure/network/watcher#az-network-watcher-configure) to create an instance of Network Watcher:
72
75
73
-
```azurecli
76
+
```azurecli-interactive
74
77
az network watcher configure --resource-group NetworkWatcherRG --locations westcentralus --enabled
75
78
```
76
79
77
-
## Create a Network Watcher with the REST API
80
+
## <aname="restapi"></a> Create a Network Watcher using the REST API
78
81
79
-
The ARMclient is used to call the REST API using PowerShell. The ARMClient is found on chocolatey at [ARMClient on Chocolatey](https://chocolatey.org/packages/ARMClient)
82
+
The ARMclient is used to call the [REST API](/rest/api/network-watcher/network-watchers/create-or-update) using PowerShell. The ARMClient is found on chocolatey at [ARMClient on Chocolatey](https://chocolatey.org/packages/ARMClient)
80
83
81
-
### Log in with ARMClient
84
+
### Sign in with ARMClient
82
85
83
86
```powerShell
84
87
armclient login
@@ -90,7 +93,7 @@ armclient login
90
93
$subscriptionId = '<subscription id>'
91
94
$networkWatcherName = '<name of network watcher>'
92
95
$resourceGroupName = '<resource group name>'
93
-
$apiversion = "2016-09-01"
96
+
$apiversion = "2022-07-01"
94
97
$requestBody = @"
95
98
{
96
99
'location': 'West Central US'
@@ -102,35 +105,48 @@ armclient put "https://management.azure.com/subscriptions/${subscriptionId}/reso
102
105
103
106
## Create a Network Watcher using Azure Quickstart Template
104
107
105
-
To create an instance of Network Watcher, refer this [Quickstart Template](https://azure.microsoft.com/resources/templates/networkwatcher-create/)
108
+
To create an instance of Network Watcher, refer to this [Quickstart Template](/samples/azure/azure-quickstart-templates/networkwatcher-create).
106
109
107
-
## Delete a Network Watcher in the portal
110
+
## Delete a Network Watcher using the Azure portal
108
111
109
-
1. Navigate to **All Services** > **Networking** > **Network Watcher**.
110
-
2. Select the overview tab, if you're not already there. Use the dropdown to select the subscription you want to disable network watcher in.
111
-
3. Expand the list of locations for your chosen subscription by selecting on the arrow. For any given, use the 3 dots on the right to access the context menu.
112
-
4. Select **Disable network watcher** to start disabling. You'll be asked to confirm this step. Select **Yes** to continue.
113
-
On the portal, you'll have to do this individually for every region in every subscription.
112
+
1. Sign in to the [Azure portal](https://portal.azure.com) with an account that has the necessary permissions.
114
113
114
+
2. In the search box at the top of the portal, enter *Network Watcher*.
115
115
116
-
## Delete a Network Watcher with PowerShell
116
+
3. In the search results, select **Network Watcher**.
117
117
118
-
To delete an instance of Network Watcher, run the following example:
118
+
4. In the **Overview** page, select the Network Watcher instances that you want to delete, then select **Disable**.
:::image type="content" source="./media/network-watcher-create/delete-network-watcher.png" alt-text="Screenshot showing how to delete a Network Watcher in the Azure portal.":::
121
+
122
+
5. Enter *yes*, then select **Delete**.
123
+
124
+
:::image type="content" source="./media/network-watcher-create/confirm-delete-network-watcher.png" alt-text="Screenshot showing the confirmation page before deleting a Network Watcher in the Azure portal.":::
125
+
126
+
## Delete a Network Watcher using PowerShell
127
+
128
+
Use [Remove-AzNetworkWatcher](/powershell/module/az.network/remove-aznetworkwatcher) to delete an instance of Network Watcher:
0 commit comments