az network watcher

Manage the Azure Network Watcher. Network Watcher assists with monitoring and diagnosing conditions at a network scenario level. To learn more visit https://docs.microsoft.com/azure/network-watcher/.

Commands

Name Description Type Status
az network watcher configure

Configure the Network Watcher service for different regions.

Core GA
az network watcher connection-monitor

Manage connection monitoring between an Azure Virtual Machine and any IP resource.

Core GA
az network watcher connection-monitor create

Create a connection monitor.

Core GA
az network watcher connection-monitor delete

Delete a connection monitor for the given region.

Core GA
az network watcher connection-monitor endpoint

Manage endpoint of a connection monitor.

Core Preview
az network watcher connection-monitor endpoint add

Add an endpoint to a connection monitor.

Core Preview
az network watcher connection-monitor endpoint list

List all endpoints from a connection monitor.

Core Preview
az network watcher connection-monitor endpoint remove

Remove an endpoint from a connection monitor.

Core Preview
az network watcher connection-monitor endpoint show

Show an endpoint from a connection monitor.

Core Preview
az network watcher connection-monitor endpoint wait

Place the CLI in a waiting state until a condition is met.

Core Preview
az network watcher connection-monitor list

List connection monitors for the given region.

Core GA
az network watcher connection-monitor output

Manage output of connection monitor.

Core Preview
az network watcher connection-monitor output add

Add an output to a connection monitor.

Core Preview
az network watcher connection-monitor output list

List all output from a connection monitor.

Core Preview
az network watcher connection-monitor output remove

Remove all outputs from a connection monitor.

Core Preview
az network watcher connection-monitor output wait

Place the CLI in a waiting state until a condition is met.

Core Preview
az network watcher connection-monitor query

Query a snapshot of the most recent connection state of a connection monitor.

Core GA
az network watcher connection-monitor show

Shows a connection monitor by name.

Core GA
az network watcher connection-monitor start

Start the specified connection monitor.

Core GA
az network watcher connection-monitor stop

Stop the specified connection monitor.

Core GA
az network watcher connection-monitor test-configuration

Manage test configuration of a connection monitor.

Core Preview
az network watcher connection-monitor test-configuration add

Add a test configuration to a connection monitor.

Core Preview
az network watcher connection-monitor test-configuration list

List all test configurations of a connection monitor.

Core Preview
az network watcher connection-monitor test-configuration remove

Remove a test configuration from a connection monitor.

Core Preview
az network watcher connection-monitor test-configuration show

Show a test configuration from a connection monitor.

Core Preview
az network watcher connection-monitor test-configuration wait

Place the CLI in a waiting state until a condition is met.

Core Preview
az network watcher connection-monitor test-group

Manage a test group of a connection monitor.

Core Preview
az network watcher connection-monitor test-group add

Add a test group along with new-added/existing endpoint and test configuration to a connection monitor.

Core Preview
az network watcher connection-monitor test-group list

List all test groups of a connection monitor.

Core Preview
az network watcher connection-monitor test-group remove

Remove test group from a connection monitor.

Core Preview
az network watcher connection-monitor test-group show

Show a test group of a connection monitor.

Core Preview
az network watcher connection-monitor test-group wait

Place the CLI in a waiting state until a condition is met.

Core Preview
az network watcher connection-monitor wait

Place the CLI in a waiting state until a condition is met.

Core GA
az network watcher flow-log

Manage network security group flow logging.

Core GA
az network watcher flow-log create

Create a flow log on a network security group.

Core GA
az network watcher flow-log delete

Delete the specified flow log resource.

Core GA
az network watcher flow-log list

List all flow log resources for the specified Network Watcher.

Core GA
az network watcher flow-log show

Get the flow log configuration of a network security group.

Core GA
az network watcher flow-log update

Update the flow log configuration of a network security group.

Core GA
az network watcher flow-log wait

Place the CLI in a waiting state until a condition is met.

Core GA
az network watcher list

List Network Watchers.

Core GA
az network watcher packet-capture

Manage packet capture sessions on VMs.

Core GA
az network watcher packet-capture create

Create and start a packet capture session.

Core GA
az network watcher packet-capture delete

Delete a packet capture session.

Core GA
az network watcher packet-capture list

List all packet capture sessions within a region.

Core GA
az network watcher packet-capture show

Show details of a packet capture session.

Core GA
az network watcher packet-capture show-status

Show the status of a packet capture session.

Core GA
az network watcher packet-capture stop

Stop a running packet capture session.

Core GA
az network watcher packet-capture wait

Place the CLI in a waiting state until a condition is met.

Core GA
az network watcher run-configuration-diagnostic

Run a configuration diagnostic on a target resource.

Core GA
az network watcher show-next-hop

Get information on the next hop of a VM.

Core GA
az network watcher show-security-group-view

Get detailed security information on a VM for the currently configured network security group.

Core GA
az network watcher show-topology

Get the network topology of a resource group, virtual network or subnet.

Core GA
az network watcher test-connectivity

Test if a connection can be established between a Virtual Machine and a given endpoint.

Core Preview
az network watcher test-ip-flow

Test IP flow to/from a VM given the currently configured network security group rules.

Core GA
az network watcher troubleshooting

Manage Network Watcher troubleshooting sessions.

Core GA
az network watcher troubleshooting show

Get the results of the last troubleshooting operation.

Core GA
az network watcher troubleshooting start

Troubleshoot issues with VPN connections or gateway connectivity.

Core GA

az network watcher configure

Configure the Network Watcher service for different regions.

az network watcher configure --locations
                             [--enabled {false, true}]
                             [--resource-group]
                             [--tags]

Examples

Configure Network Watcher for the West US region.

az network watcher configure -g NetworkWatcherRG  -l westus --enabled true

Required Parameters

--locations -l

Space-separated list of locations to configure.

Optional Parameters

--enabled

Enabled status of Network Watcher in the specified regions.

accepted values: false, true
--resource-group -g

Name of resource group. Required when enabling new regions.

When a previously disabled region is enabled to use Network Watcher, a Network Watcher resource will be created in this resource group.

--tags

Space-separated tags: key[=value] [key[=value] ...]. Use "" to clear existing tags.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc
default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az network watcher list

List Network Watchers.

az network watcher list
Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc
default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az network watcher run-configuration-diagnostic

Run a configuration diagnostic on a target resource.

Requires that Network Watcher is enabled for the region in which the target is located.

az network watcher run-configuration-diagnostic --resource
                                                [--destination]
                                                [--direction {Inbound, Outbound}]
                                                [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                                [--parent]
                                                [--port]
                                                [--protocol {TCP, UDP}]
                                                [--queries]
                                                [--resource-group]
                                                [--resource-type {applicationGateways, networkInterfaces, virtualMachines}]
                                                [--source]

Examples

Run configuration diagnostic on a VM with a single query.

az network watcher run-configuration-diagnostic --resource {VM_ID} --direction Inbound --protocol TCP --source 12.11.12.14 --destination 10.1.1.4 --port 12100

Run configuration diagnostic on a VM with multiple queries.

az network watcher run-configuration-diagnostic --resource {VM_ID} --queries '[{"direction": "Inbound", "protocol": "TCP", "source": "12.11.12.14", "destination": "10.1.1.4", "destinationPort": "12100"}, {"direction": "Inbound", "protocol": "TCP", "source": "12.11.12.0/32", "destination": "10.1.1.4", "destinationPort": "12100"}, {"direction": "Outbound", "protocol": "TCP", "source": "12.11.12.14", "destination": "10.1.1.4", "destinationPort": "12100"}]'

Required Parameters

--resource

Name or ID of the target resource to diagnose. If an ID is given, other resource arguments should not be given.

Optional Parameters

--destination

Traffic destination. Accepted values are '*', IP address/CIDR, or Service Tag.

--direction

Direction of the traffic.

accepted values: Inbound, Outbound
--no-wait

Do not wait for the long-running operation to finish.

accepted values: 0, 1, f, false, n, no, t, true, y, yes
--parent

Parent path, e.g., virtualMachineScaleSets/vmss1.

--port

Traffic destination port. Accepted values are '*', port number (3389) or port range (80-100).

--protocol

Protocol to be verified on.

accepted values: TCP, UDP
--queries

JSON list of queries to use. Use @{path} to load from a file. Support shorthand-syntax, json-file and yaml-file. Try "??" to show more.

--resource-group -g

Name of the resource group the target resource is in.

--resource-type -t

Resource type.

accepted values: applicationGateways, networkInterfaces, virtualMachines
--source

Traffic source. Accepted values are '*', IP address/CIDR, or Service Tag.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc
default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az network watcher show-next-hop

Get information on the next hop of a VM.

Requires that Network Watcher is enabled for the region in which the VM is located. For more information about show-next-hop visit https://learn.microsoft.com/en-us/azure/network-watcher/diagnose-vm-network-routing-problem-cli.

az network watcher show-next-hop --dest-ip
                                 --source-ip
                                 --vm
                                 [--nic]
                                 [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                 [--resource-group]

Examples

Get the next hop from a VMs assigned IP address to a destination at 10.1.0.4.

az network watcher show-next-hop -g MyResourceGroup --vm MyVm --source-ip 10.0.0.4 --dest-ip 10.1.0.4

Required Parameters

--dest-ip

Destination IPv4 address.

--source-ip

Source IPv4 address.

--vm

Name or ID of the VM to target. If the name of the VM is provided, the --resource-group is required.

Optional Parameters

--nic

Name or ID of the NIC resource to test. If the VM has multiple NICs and IP forwarding is enabled on any of them, this parameter is required.

--no-wait

Do not wait for the long-running operation to finish.

accepted values: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

Name of the resource group the target VM is in.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc
default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az network watcher show-security-group-view

Get detailed security information on a VM for the currently configured network security group.

az network watcher show-security-group-view --vm
                                            [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                            [--resource-group]

Examples

Get the network security group information for the specified VM.

az network watcher show-security-group-view -g MyResourceGroup --vm MyVm

Required Parameters

--vm

Name or ID of the VM to target. If the name of the VM is provided, the --resource-group is required.

Optional Parameters

--no-wait

Do not wait for the long-running operation to finish.

accepted values: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

Name of the resource group the target VM is in.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc
default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az network watcher show-topology

Get the network topology of a resource group, virtual network or subnet.

For more information about using network topology visit https://learn.microsoft.com/en-us/azure/network-watcher/view-network-topology.

az network watcher show-topology [--location]
                                 [--resource-group]
                                 [--subnet]
                                 [--vnet]

Examples

Use show-topology to get the topology of resources within a resource group.

az network watcher show-topology -g MyResourceGroup

Optional Parameters

--location -l

Location. Defaults to the location of the target resource group. Topology information is only shown for resources within the target resource group that are within the specified region.

--resource-group -g

Name of the target resource group to perform topology on.

--subnet

Name or ID of the subnet to target. If name is used, --vnet NAME must also be supplied.

--vnet

Name or ID of the virtual network to target.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc
default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az network watcher test-connectivity

Preview

This command is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Test if a connection can be established between a Virtual Machine and a given endpoint.

To check connectivity between two VMs in different regions, use the VM ids instead of the VM names for the source and destination resource arguments. To register for this feature or see additional examples visit https://learn.microsoft.com/en-us/azure/network-watcher/network-watcher-connectivity-cli.

az network watcher test-connectivity --source-resource
                                     [--dest-address]
                                     [--dest-port]
                                     [--dest-resource]
                                     [--headers]
                                     [--method {Get}]
                                     [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--protocol {Http, Https, Icmp, Tcp}]
                                     [--resource-group]
                                     [--source-port]
                                     [--valid-status-codes]

Examples

Check connectivity between two virtual machines in the same resource group over port 80.

az network watcher test-connectivity -g MyResourceGroup --source-resource MyVmName1 --dest-resource MyVmName2 --dest-port 80

Check connectivity between two virtual machines in the same subscription in two different resource groups over port 80.

az network watcher test-connectivity --source-resource MyVmId1 --dest-resource MyVmId2 --dest-port 80

Required Parameters

--source-resource

Name or ID of the resource from which to originate traffic. Currently only Virtual Machines are supported.

Optional Parameters

--dest-address

IP address or URI at which to receive traffic.

--dest-port

Port number on which to receive traffic.

--dest-resource

Name or ID of the resource to receive traffic. Currently only Virtual Machines are supported.

--headers

Space-separated list of headers in KEY=VALUE format. Support shorthand-syntax, json-file and yaml-file. Try "??" to show more.

--method

HTTP method to use.

accepted values: Get
--no-wait

Do not wait for the long-running operation to finish.

accepted values: 0, 1, f, false, n, no, t, true, y, yes
--protocol

Protocol to test on.

accepted values: Http, Https, Icmp, Tcp
--resource-group -g

Name of the resource group the target resource is in.

--source-port

Port number from which to originate traffic.

--valid-status-codes

Space-separated list of HTTP status codes considered valid. Support shorthand-syntax, json-file and yaml-file. Try "??" to show more.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc
default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az network watcher test-ip-flow

Test IP flow to/from a VM given the currently configured network security group rules.

Requires that Network Watcher is enabled for the region in which the VM is located. For more information visit https://learn.microsoft.com/en-us/azure/network-watcher/diagnose-vm-network-traffic-filtering-problem-cli.

az network watcher test-ip-flow --direction {Inbound, Outbound}
                                --local
                                --protocol {TCP, UDP}
                                --remote
                                --vm
                                [--nic]
                                [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                [--resource-group]

Examples

Run test-ip-flow verify to test logical connectivity from a VM to the specified destination IPv4 address and port.

az network watcher test-ip-flow -g MyResourceGroup --direction Outbound --protocol TCP --local 10.0.0.4:* --remote 10.1.0.4:80 --vm MyVm

Required Parameters

--direction

Direction of the packet relative to the VM.

accepted values: Inbound, Outbound
--local

Private IPv4 address for the VMs NIC and the port of the packet in X.X.X.X:PORT format. * can be used for port when direction is outbound.

--protocol

Protocol to test.

accepted values: TCP, UDP
--remote

IPv4 address and port for the remote side of the packet X.X.X.X:PORT format. * can be used for port when the direction is inbound.

--vm

Name or ID of the VM to target. If the name of the VM is provided, the --resource-group is required.

Optional Parameters

--nic

Name or ID of the NIC resource to test. If the VM has multiple NICs and IP forwarding is enabled on any of them, this parameter is required.

--no-wait

Do not wait for the long-running operation to finish.

accepted values: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

Name of the resource group the target VM is in.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc
default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.