Note

Access to this page requires authorization. You can try signing in or .

Access to this page requires authorization. You can try .

Test-AzNetworkWatcherConnectivity

Returns connectivity information for a specified source VM and a destination.

Syntax

SetByResource (Default) 

Test-AzNetworkWatcherConnectivity
 -NetworkWatcher <PSNetworkWatcher>
 -SourceId <String>
 [-SourcePort <Int32>]
 [-DestinationId <String>]
 [-DestinationAddress <String>]
 [-DestinationPort <Int32>]
 [-ProtocolConfiguration <PSNetworkWatcherProtocolConfiguration>]
 [-AsJob]
 [-DefaultProfile <IAzureContextContainer>]
 [<CommonParameters>]

SetByName 

Test-AzNetworkWatcherConnectivity
 -NetworkWatcherName <String>
 -ResourceGroupName <String>
 -SourceId <String>
 [-SourcePort <Int32>]
 [-DestinationId <String>]
 [-DestinationAddress <String>]
 [-DestinationPort <Int32>]
 [-ProtocolConfiguration <PSNetworkWatcherProtocolConfiguration>]
 [-AsJob]
 [-DefaultProfile <IAzureContextContainer>]
 [<CommonParameters>]

SetByLocation 

Test-AzNetworkWatcherConnectivity
 -Location <String>
 -SourceId <String>
 [-SourcePort <Int32>]
 [-DestinationId <String>]
 [-DestinationAddress <String>]
 [-DestinationPort <Int32>]
 [-ProtocolConfiguration <PSNetworkWatcherProtocolConfiguration>]
 [-AsJob]
 [-DefaultProfile <IAzureContextContainer>]
 [<CommonParameters>]

Description

The Test-AzNetworkWatcherConnectivity cmdlet returns connectivity information for a specified source VM and a destination. If connectivity between the source and destination cannot be established, the cmdlet returns details about the issue.

Examples

Example 1: Test Network Watcher Connectivity from a VM to a website

Test-AzNetworkWatcherConnectivity -NetworkWatcherName NetworkWatcher -ResourceGroupName NetworkWatcherRG -SourceId "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/ContosoRG/providers/Microsoft.Compute/virtualMachines/MultiTierApp0" -DestinationAddress "bing.com" -DestinationPort 80

ConnectionStatus : Reachable
AvgLatencyInMs : 4
MinLatencyInMs : 2
MaxLatencyInMs : 15
ProbesSent : 15
ProbesFailed : 0
Hops : [
 {
 "Type": "Source",
 "Id": "f8cff464-e13f-457f-a09e-4dcd53d38a85",
 "Address": "10.1.1.4",
 "ResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/ContosoRG/provi iders/Microsoft.Network/networkInterfaces/appNic0/ipConfigurations/ipconfig1",
 "NextHopIds": [
 "1034b1bf-0b1b-4f0a-93b2-900477f45485"
 ],
 "Issues": []
 },
 {
 "Type": "Internet",
 "Id": "1034b1bf-0b1b-4f0a-93b2-900477f45485",
 "Address": "13.107.21.200",
 "ResourceId": "Internet",
 "NextHopIds": [],
 "Issues": []
 }
 ]

In this example we test connectivity from a VM in Azure to www.bing.com.

Example 2

Returns connectivity information for a specified source VM and a destination. (autogenerated)

Test-AzNetworkWatcherConnectivity -DestinationAddress 'bing.com' -DestinationPort 80 -NetworkWatcher <PSNetworkWatcher> -SourceId '/subscriptions/00000000-0000-0000-0000-00000000000000000/resourceGroups/ContosoRG/providers/Microsoft.Compute/virtualMachines/MultiTierApp0'

Parameters

-AsJob

Run cmdlet in the background

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-DefaultProfile

The credentials, account, tenant, and subscription used for communication with azure.

Parameter properties

Type:IAzureContextContainer
Default value:None
Supports wildcards:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Parameter sets

-DestinationAddress

The IP address or URI the resource to which a connection attempt will be made.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-DestinationId

The ID of the resource to which a connection attempt will be made.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-DestinationPort

Port on which check connectivity will be performed.

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-Location

Location of the network watcher.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-NetworkWatcher

The network watcher resource.

Parameter properties

Type:PSNetworkWatcher
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-NetworkWatcherName

The name of network watcher.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False
Aliases:Name

Parameter sets

-ProtocolConfiguration

Protocol configuration on which check connectivity will be performed.

Parameter properties

Type:PSNetworkWatcherProtocolConfiguration
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-ResourceGroupName

The name of the network watcher resource group.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-SourceId

The ID of the resource from which a connectivity check will be initiated.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-SourcePort

The source port from which a connectivity check will be performed.

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

PSNetworkWatcher

String

Int32

Outputs

PSConnectivityInformation

Notes

Keywords: azure, azurerm, arm, resource, connectivity, management, manager, network, networking, network watcher

Related Links

Feedback

Was this page helpful?