Edit

Share via

Get-AzNetworkManagerVerifierWorkspaceReachabilityAnalysisRun

Module:
Az.Network Module

To get network manager verifier workspace reachability analysis run.

Syntax

ByList (Default) 

Get-AzNetworkManagerVerifierWorkspaceReachabilityAnalysisRun
    -NetworkManagerName <String>
    -ResourceGroupName <String>
    -VerifierWorkspaceName <String>
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

ByName 

Get-AzNetworkManagerVerifierWorkspaceReachabilityAnalysisRun
    -NetworkManagerName <String>
    -ResourceGroupName <String>
    -VerifierWorkspaceName <String>
    [-Name <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

ByResourceId 

Get-AzNetworkManagerVerifierWorkspaceReachabilityAnalysisRun
    -ResourceId <String>
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Description

When given a 'Name', the Get-AzNetworkManagerVerifierWorkspaceReachabilityAnalysisRun cmdlet gets that specific network manager verifier workspace reachability analysis run. When not given a 'Name', the Get-AzNetworkManagerVerifierWorkspaceReachabilityAnalysisRun cmdlet gets a list of the network manager verifier workspace reachability analysis runs in the specified workspace.

Examples

Example 1

Get-AzNetworkManagerVerifierWorkspaceReachabilityAnalysisRun -NetworkManagerName "testNM" -ResourceGroupName "testRG" -VerifierWorkspaceName "testVNV"

Name                  : testAsyncOpBehvaiorRun
VerifierWorkspaceName :
ResourceGroupName     : testRG
NetworkManagerName    : testNM
Properties            : Microsoft.Azure.Commands.Network.Models.NetworkManager.PSReachabilityAnalysisRunProperties
Type                  : Microsoft.Network/networkManagers/verifierWorkspaces/reachabilityAnalysisRuns
SystemData            : Microsoft.Azure.Commands.Network.Models.NetworkManager.PSSystemData
SystemDataText        : {
                          "CreatedBy": "test@email.com",
                          "CreatedByType": "User",
                          "CreatedAt": "2024-09-05T19:39:38.2563968Z",
                          "LastModifiedBy": "test@email.com",
                          "LastModifiedByType": "User",
                          "LastModifiedAt": "2024-09-05T19:40:01.1132044Z"
                        }
Id                    : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testRG/providers/Microsoft.Network/networkManagers/testNM/verifierW
                        orkspaces/testVNV/reachabilityAnalysisRuns/testAsyncOpBehvaiorRun

Name                  : testrun
VerifierWorkspaceName :
ResourceGroupName     : testRG
NetworkManagerName    : testNM
Properties            : Microsoft.Azure.Commands.Network.Models.NetworkManager.PSReachabilityAnalysisRunProperties
Type                  : Microsoft.Network/networkManagers/verifierWorkspaces/reachabilityAnalysisRuns
SystemData            : Microsoft.Azure.Commands.Network.Models.NetworkManager.PSSystemData
SystemDataText        : {
                          "CreatedBy": "test@email.com",
                          "CreatedByType": "User",
                          "CreatedAt": "2024-09-19T16:01:54.313026Z",
                          "LastModifiedBy": "test@email.com",
                          "LastModifiedByType": "User",
                          "LastModifiedAt": "2024-09-19T16:02:07.4222816Z"
                        }
Id                    : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testRG/providers/Microsoft.Network/networkManagers/testNM/verifierW
                        orkspaces/testVNV/reachabilityAnalysisRuns/testrun

Name                  : testrun1
VerifierWorkspaceName :
ResourceGroupName     : testRG
NetworkManagerName    : testNM
Properties            : Microsoft.Azure.Commands.Network.Models.NetworkManager.PSReachabilityAnalysisRunProperties
Type                  : Microsoft.Network/networkManagers/verifierWorkspaces/reachabilityAnalysisRuns
SystemData            : Microsoft.Azure.Commands.Network.Models.NetworkManager.PSSystemData
SystemDataText        : {
                          "CreatedBy": "test@email.com",
                          "CreatedByType": "User",
                          "CreatedAt": "2024-09-19T16:04:57.7083709Z",
                          "LastModifiedBy": "test@email.com",
                          "LastModifiedByType": "User",
                          "LastModifiedAt": "2024-09-19T16:05:08.4340122Z"
                        }
Id                    : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testRG/providers/Microsoft.Network/networkManagers/testNM/verifierW
                        orkspaces/testVNV/reachabilityAnalysisRuns/testrun1

Name                  : testrun2
VerifierWorkspaceName :
ResourceGroupName     : testRG
NetworkManagerName    : testNM
Properties            : Microsoft.Azure.Commands.Network.Models.NetworkManager.PSReachabilityAnalysisRunProperties
Type                  : Microsoft.Network/networkManagers/verifierWorkspaces/reachabilityAnalysisRuns
SystemData            : Microsoft.Azure.Commands.Network.Models.NetworkManager.PSSystemData
SystemDataText        : {
                          "CreatedBy": "test@email.com",
                          "CreatedByType": "User",
                          "CreatedAt": "2024-09-19T16:07:08.2595595Z",
                          "LastModifiedBy": "test@email.com",
                          "LastModifiedByType": "User",
                          "LastModifiedAt": "2024-09-19T16:07:18.9324364Z"
                        }
Id                    : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testRG/providers/Microsoft.Network/networkManagers/testNM/verifierW
                        orkspaces/testVNV/reachabilityAnalysisRuns/testrun2

Name                  : testrun3
VerifierWorkspaceName :
ResourceGroupName     : testRG
NetworkManagerName    : testNM
Properties            : Microsoft.Azure.Commands.Network.Models.NetworkManager.PSReachabilityAnalysisRunProperties
Type                  : Microsoft.Network/networkManagers/verifierWorkspaces/reachabilityAnalysisRuns
SystemData            : Microsoft.Azure.Commands.Network.Models.NetworkManager.PSSystemData
SystemDataText        : {
                          "CreatedBy": "test@email.com",
                          "CreatedByType": "User",
                          "CreatedAt": "2024-09-19T16:08:38.3602762Z",
                          "LastModifiedBy": "test@email.com",
                          "LastModifiedByType": "User",
                          "LastModifiedAt": "2024-09-19T16:08:50.960041Z"
                        }
Id                    : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testRG/providers/Microsoft.Network/networkManagers/testNM/verifierW
                        orkspaces/testVNV/reachabilityAnalysisRuns/testrun3

Name                  : testrunfan1
VerifierWorkspaceName :
ResourceGroupName     : testRG
NetworkManagerName    : testNM
Properties            : Microsoft.Azure.Commands.Network.Models.NetworkManager.PSReachabilityAnalysisRunProperties
Type                  : Microsoft.Network/networkManagers/verifierWorkspaces/reachabilityAnalysisRuns
SystemData            : Microsoft.Azure.Commands.Network.Models.NetworkManager.PSSystemData
SystemDataText        : {
                          "CreatedBy": "test@email.com",
                          "CreatedByType": "User",
                          "CreatedAt": "2024-09-19T21:03:46.2977531Z",
                          "LastModifiedBy": "test@email.com",
                          "LastModifiedByType": "User",
                          "LastModifiedAt": "2024-09-19T21:03:59.9659393Z"
                        }
Id                    : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testRG/providers/Microsoft.Network/networkManagers/testNM/verifierW
                        orkspaces/testVNV/reachabilityAnalysisRuns/testrunfan1

Gets list of network manager verifier workspace reachability analysis runs for 'testVNV' verifier workspace.

Example 2

$run = Get-AzNetworkManagerVerifierWorkspaceReachabilityAnalysisRun -NetworkManagerName "NetworkManagerTest" -ResourceGroupName "ResourceGroupTest" -VerifierWorkspaceName "VNVTest" -Name "demorun"
$run.Properties

Description    :
IntentId       : /subscriptions/f0dc2b34-dfad-40e4-83e0-2309fed8d00b/resourceGroups/ResourceGroupTest/providers/Microsoft.Netw
                 ork/networkManagers/NetworkManagerTest/verifierWorkspaces/VNVTest/reachabilityAnalysisIntents/demoIntent1
IntentContent  : Microsoft.Azure.Commands.Network.Models.NetworkManager.PSIntentContent
AnalysisResult : {"resultOutcome":"NoPacketsReached","unreachedTrace":"[{\"name\":\"default\",\"resourceId\":\"/subscri
                 ptions/00000000-0000-0000-0000-000000000000/resourceGroups/testResources/providers/Microso
                 ft.Network/virtualNetworks/vnetVerifierTesting-vnet/subnets/default\",\"resourceType\":\"Microsoft.Net
                 work/virtualNetworks/subnets\",\"packet\":{\"destinationAddress\":\"::\",\"destinationPort\":\"0\",\"s
                 ourceAddress\":\"::\",\"sourcePort\":\"0\",\"protocol\":\"TCP\"},\"explanation\":{\"description\":\"Pa
                 cked dropped at subnet as subnet does not have a ip prefix for the analysis IP
                 version.\",\"explanationCode\":\"NO_SUBNET_PREFIX\"}}]"}
ErrorMessage   :

$run.Properties.IntentContent.IpTraffic | Format-List *

SourceResourceId      : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testResources/providers/Microsoft.Network/virtualNetworks/vnetVerifi
                        erTesting-vnet/subnets/default
DestinationResourceId : internet
IpTraffic             : Microsoft.Azure.Commands.Network.Models.NetworkManager.PSIPTraffic
IntentContentText     : {
                          "SourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testResources/providers/Microsoft.Network/vir
                        tualNetworks/vnetVerifierTesting-vnet/subnets/default",
                          "DestinationResourceId": "internet",
                          "IpTraffic": {
                            "SourceIps": [
                              "::"
                            ],
                            "DestinationIps": [
                              "::"
                            ],
                            "SourcePorts": [
                              "*"
                            ],
                            "DestinationPorts": [
                              "*"
                            ],
                            "Protocols": [
                              "TCP"
                            ]
                          }
                        }

$run.Properties.IntentContent.IpTraffic | Format-List *

SourceIps        : {::}
DestinationIps   : {::}
SourcePorts      : {*}
DestinationPorts : {*}
Protocols        : {TCP}
IpTrafficText    : {
                     "SourceIps": [
                       "::"
                     ],
                     "DestinationIps": [
                       "::"
                     ],
                     "SourcePorts": [
                       "*"
                     ],
                     "DestinationPorts": [
                       "*"
                     ],
                     "Protocols": [
                       "TCP"
                     ]
                   }

Gets network manager verifier workspace reachability analysis run for 'testrun'.

Parameters

-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

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Name

The resource name.

Parameter properties

Type:String
Default value:None
Supports wildcards:True
DontShow:False
Aliases:ResourceName

Parameter sets

ByName
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-NetworkManagerName

The network manager name.

Parameter properties

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

Parameter sets

ByList
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
ByName
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-ResourceGroupName

The resource group name.

Parameter properties

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

Parameter sets

ByList
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
ByName
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-ResourceId

The Verifier Workspace Analysis Run resource id.

Parameter properties

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

Parameter sets

ByResourceId
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-VerifierWorkspaceName

The verifier workspace name.

Parameter properties

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

Parameter sets

ByList
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
ByName
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

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

String

Outputs

PSReachabilityAnalysisRun