Test-VipReachability
Tests whether DIPs are reachable.
Syntax
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.
Type: | String |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Dips
Specifies an array of DIPs to test.
Type: | Hashtable[] |
Position: | 5 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Muxes
Specifies an array of MUXes to load-balance the DIPs.
Type: | Hashtable[] |
Position: | 4 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OperationId
Specifies an ID for the operation.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PayloadSize
Specifies the size of the payload to carry in ICMP messages.
Type: | Int32 |
Position: | 7 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SequenceNumber
Specifies the ICMP sequence number.
Type: | Int32 |
Position: | 6 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SourceIP
Specifies the IP address of the source node.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TargetVIP
Specifies the IP address of the target VIP.
Type: | String |
Position: | 3 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Inputs
None