Test-VipReachability
Tests whether DIPs are reachable.
Syntax
Default (Default)
Test-VipReachability
[[-OperationId] <String>]
[-SourceIP] <String>
[[-CompartmentId] <String>]
[-TargetVIP] <String>
[-Muxes] <Hashtable[]>
[-Dips] <Hashtable[]>
[[-SequenceNumber] <Int32>]
[[-PayloadSize] <Int32>]
[<CommonParameters>]
Description
The Test-VipReachability cmdlet tests whether a list of datacenter IP addresses (DIPs) can be reached through the specified multiplexers (MUXes).
The test covers layer-3 connectivity to the MUX nodes, and from the MUX nodes to the DIP hosts.
The test first sends Internet Control Message Protocol (ICMP) echo requests to the virtual IP (VIP) address. The MUX intercepts the echo requests and sends responses that appear to come from the targeted VIP.
The test then sends ICMP echo requests from the MUX host to the DIP host on the provider network. The results of the test are reported in the output object.
Examples
Example 1: Test VIP reachability
PS C:\> for ($mux in $VipHostMapping.MuxList) {
$secpasswd = ConvertTo-SecureString <plaintext password> -AsPlainText -Force
$creds = New-Object System.Management.Automation.PSCredential (<username>, $secpasswd)
$mux.Credentials = $creds
}
PS C:\> for ($dip in $VipHostMapping.DIPHosts) {
$secpasswd = ConvertTo-SecureString <plaintext password> -AsPlainText -Force
$creds = New-Object System.Management.Automation.PSCredential (<username>, $secpasswd)
$dip.HostInfo.Credentials = $creds
}
PS C:\> Test-VIPReachability -OperationId 1 -SourceIP "10.123.176.108" -TargetVIP "10.123.177.110" -Muxes $VipHostMapping.MuxList -Dips $VipHostMapping.DIPHosts
The first command populates the credentials for the MUX nodes to test.
The second command populates the credentials for the DIPs to test.
The last command tests the VIP reachability for the specified MUXes and DIPs.
Parameters
-CompartmentId
Specifies the ID of the network compartment to use to inject ICMP echo requests.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 2 |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Dips
Specifies an array of DIPs to test.
Parameter properties
| Type: | Hashtable[] |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 5 |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Muxes
Specifies an array of MUXes to load-balance the DIPs.
Parameter properties
| Type: | Hashtable[] |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 4 |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-OperationId
Specifies an ID for the operation.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 0 |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-PayloadSize
Specifies the size of the payload to carry in ICMP messages.
Parameter properties
| Type: | Int32 |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 7 |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-SequenceNumber
Specifies the ICMP sequence number.
Parameter properties
| Type: | Int32 |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 6 |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-SourceIP
Specifies the IP address of the source node.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 1 |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-TargetVIP
Specifies the IP address of the target VIP.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 3 |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| 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.