Share via


az network watcher connection-monitor

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

Connection monitor can be used to monitor network connectivity between an Azure virtual machine and an IP address. The IP address can be assigned to another Azure resource or a resource on the Internet or on-premises. To learn more visit https://aka.ms/connectionmonitordoc.

Commands

Name Description Type Status
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 connection-monitor create

Create a connection monitor.

az network watcher connection-monitor create --connection-monitor-name
                                             --endpoint-dest-name
                                             --endpoint-source-name
                                             --endpoint-source-resource-id
                                             --test-config-name
                                             [--endpoint-dest-address]
                                             [--endpoint-dest-coverage-level {AboveAverage, Average, BelowAverage, Default, Full, Low}]
                                             [--endpoint-dest-resource-id]
                                             [--endpoint-dest-type {AzureArcVM, AzureSubnet, AzureVM, AzureVMSS, AzureVNet, ExternalAddress, MMAWorkspaceMachine, MMAWorkspaceNetwork}]
                                             [--endpoint-source-address]
                                             [--endpoint-source-coverage-level {AboveAverage, Average, BelowAverage, Default, Full, Low}]
                                             [--endpoint-source-type {AzureArcVM, AzureSubnet, AzureVM, AzureVMSS, AzureVNet, ExternalAddress, MMAWorkspaceMachine, MMAWorkspaceNetwork}]
                                             [--frequency]
                                             [--http-method {Get, Post}]
                                             [--http-path]
                                             [--http-port]
                                             [--http-valid-status-codes]
                                             [--https-prefer {0, 1, f, false, n, no, t, true, y, yes}]
                                             [--icmp-disable-trace-route {0, 1, f, false, n, no, t, true, y, yes}]
                                             [--location]
                                             [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                             [--notes]
                                             [--output-type {Workspace}]
                                             [--preferred-ip-version {IPv4, IPv6}]
                                             [--protocol {Http, Icmp, Tcp}]
                                             [--resource-group]
                                             [--tags]
                                             [--tcp-disable-trace-route {0, 1, f, false, n, no, t, true, y, yes}]
                                             [--tcp-port]
                                             [--tcp-port-behavior {ListenIfAvailable, None}]
                                             [--test-group-disable {0, 1, f, false, n, no, t, true, y, yes}]
                                             [--test-group-name]
                                             [--threshold-failed-percent]
                                             [--threshold-round-trip-time]
                                             [--workspace-ids]

Examples

Create a connection monitor

az network watcher connection-monitor create --name MyV2ConnectionMonitor --endpoint-source- name "vm01" --endpoint-source-resource-id MyVM01ResourceID --endpoint-dest-name bing --endpoint-dest-address bing.com --test-config-name TCPTestConfig --protocol Tcp --tcp-port 2048
az network watcher connection-monitor create --endpoint-dest-address bing.com --endpoint- dest-name bing --endpoint-source-name "vm01" --endpoint-source-resource-id MyVM01ResourceID --location westus2 --name MyConnectionMonitorName --protocol Tcp --tcp-port 2048 --test- config-name TCPTestConfig

Required Parameters

--connection-monitor-name --name -n

Connection monitor name.

--endpoint-dest-name

The name of the destination of connection monitor endpoint. If you are creating a V2 Connection Monitor, it's required.

--endpoint-source-name

The name of the source of connection monitor endpoint. If you are creating a V2 Connection Monitor, it's required.

--endpoint-source-resource-id

Resource ID of the source of connection monitor endpoint. If endpoint is intended to used as source, this option is required.

--test-config-name

The name of the connection monitor test configuration. If you are creating a V2 Connection Monitor, it's required.

Optional Parameters

--endpoint-dest-address

Address of the destination of connection monitor endpoint (IP or domain name).

--endpoint-dest-coverage-level

Test coverage for the endpoint.

Accepted values: AboveAverage, Average, BelowAverage, Default, Full, Low
--endpoint-dest-resource-id

Resource ID of the destination of connection monitor endpoint.

--endpoint-dest-type

The endpoint type.

Accepted values: AzureArcVM, AzureSubnet, AzureVM, AzureVMSS, AzureVNet, ExternalAddress, MMAWorkspaceMachine, MMAWorkspaceNetwork
--endpoint-source-address

Address of the source of connection monitor endpoint (IP or domain name).

--endpoint-source-coverage-level

Test coverage for the endpoint.

Accepted values: AboveAverage, Average, BelowAverage, Default, Full, Low
--endpoint-source-type

The endpoint type.

Accepted values: AzureArcVM, AzureSubnet, AzureVM, AzureVMSS, AzureVNet, ExternalAddress, MMAWorkspaceMachine, MMAWorkspaceNetwork
--frequency

The frequency of test evaluation, in seconds.

Default value: 60
--http-method

The HTTP method to use.

Accepted values: Get, Post
--http-path

The path component of the URI. For instance, "/dir1/dir2".

--http-port

The port to connect to.

--http-valid-status-codes

Space-separated list of HTTP status codes to consider successful. For instance, '2xx 301-304 418' Support shorthand-syntax, json-file and yaml-file. Try "??" to show more.

--https-prefer

Value indicating whether HTTPS is preferred over HTTP in cases where the choice is not explicit. Allowed values: false, true.

Accepted values: 0, 1, f, false, n, no, t, true, y, yes
--icmp-disable-trace-route

Value indicating whether path evaluation with trace route should be disabled. false is default. Allowed values: false, true.

Accepted values: 0, 1, f, false, n, no, t, true, y, yes
--location -l

Location. Values from: az account list-locations. You can configure the default location using az configure --defaults location=<location>.

--no-wait

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

Accepted values: 0, 1, f, false, n, no, t, true, y, yes
--notes

Optional notes to be associated with the connection monitor.

--output-type --type

Connection monitor output destination type. Currently, only "Workspace" is supported.

Accepted values: Workspace
--preferred-ip-version

The preferred IP version to use in test evaluation. The connection monitor may choose to use a different version depending on other parameters.

Accepted values: IPv4, IPv6
--protocol

The protocol to use in test evaluation.

Accepted values: Http, Icmp, Tcp
--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--tags

Space-separated tags: key[=value] [key[=value] ...]. Use ''to clear existing tags. Support shorthand-syntax, json-file and yaml-file. Try "??" to show more.

--tcp-disable-trace-route

Value indicating whether path evaluation with trace route should be disabled. false is default. Allowed values: false, true.

Accepted values: 0, 1, f, false, n, no, t, true, y, yes
--tcp-port

The port to connect to.

--tcp-port-behavior

Destination port behavior.

Accepted values: ListenIfAvailable, None
--test-group-disable

Value indicating whether test group is disabled. false is default.

Accepted values: 0, 1, f, false, n, no, t, true, y, yes
--test-group-name

The name of the connection monitor test group.

Default value: DefaultTestGroup
--threshold-failed-percent

The maximum percentage of failed checks permitted for a test to evaluate as successful.

--threshold-round-trip-time

The maximum round-trip time in milliseconds permitted for a test to evaluate as successful.

--workspace-ids

Space-separated list of ids of log analytics workspace. 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 connection-monitor delete

Delete a connection monitor for the given region.

az network watcher connection-monitor delete --connection-monitor-name
                                             --location
                                             [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]

Examples

Delete a connection monitor for the given region.

az network watcher connection-monitor delete -l westus -n MyConnectionMonitorName

Required Parameters

--connection-monitor-name --name -n

Connection monitor name.

--location -l

Location. Values from: az account list-locations. You can configure the default location using az configure --defaults location=<location>.

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
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 connection-monitor list

List connection monitors for the given region.

az network watcher connection-monitor list --location

Examples

List a connection monitor for the given region.

az network watcher connection-monitor list -l westus
az az network watcher connection-monitor list --location westus --subscription MySubscription

Required Parameters

--location -l

Location. Values from: az account list-locations. You can configure the default location using az configure --defaults location=<location>.

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 connection-monitor query

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

az network watcher connection-monitor query --connection-monitor-name
                                            --location
                                            [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]

Examples

List a connection monitor for the given region.

az network watcher connection-monitor query -l westus -n MyConnectionMonitorName

Required Parameters

--connection-monitor-name --name -n

Connection monitor name.

--location -l

Location. Values from: az account list-locations. You can configure the default location using az configure --defaults location=<location>.

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
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 connection-monitor show

Shows a connection monitor by name.

az network watcher connection-monitor show --connection-monitor-name
                                           --location

Examples

Show a connection monitor for the given name.

az network watcher connection-monitor show -l westus -n MyConnectionMonitorName

Required Parameters

--connection-monitor-name --name -n

Connection monitor name.

--location -l

Location. Values from: az account list-locations. You can configure the default location using az configure --defaults location=<location>.

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 connection-monitor start

Start the specified connection monitor.

az network watcher connection-monitor start --connection-monitor-name
                                            --location
                                            [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]

Examples

Start the specified connection monitor.

az network watcher connection-monitor start -l westus -n MyConnectionMonitorName

Required Parameters

--connection-monitor-name --name -n

Connection monitor name.

--location -l

Location. Values from: az account list-locations. You can configure the default location using az configure --defaults location=<location>.

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
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 connection-monitor stop

Stop the specified connection monitor.

az network watcher connection-monitor stop --connection-monitor-name
                                           --location
                                           [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]

Examples

Stop the specified connection monitor.

az network watcher connection-monitor stop -l westus -n MyConnectionMonitorName

Required Parameters

--connection-monitor-name --name -n

Connection monitor name.

--location -l

Location. Values from: az account list-locations. You can configure the default location using az configure --defaults location=<location>.

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
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 connection-monitor wait

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

az network watcher connection-monitor wait [--connection-monitor-name]
                                           [--created]
                                           [--custom]
                                           [--deleted]
                                           [--exists]
                                           [--ids]
                                           [--interval]
                                           [--network-watcher-name]
                                           [--resource-group-name]
                                           [--subscription]
                                           [--timeout]
                                           [--updated]

Optional Parameters

--connection-monitor-name --name -n

Connection monitor name.

--created

Wait until created with 'provisioningState' at 'Succeeded'.

Default value: False
--custom

Wait until the condition satisfies a custom JMESPath query. E.g. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Wait until deleted.

Default value: False
--exists

Wait until the resource exists.

Default value: False
--ids

One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

--interval

Polling interval in seconds.

Default value: 30
--network-watcher-name

The name of the Network Watcher resource.

--resource-group-name -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--subscription

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

--timeout

Maximum wait in seconds.

Default value: 3600
--updated

Wait until updated with provisioningState at 'Succeeded'.

Default value: False
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.