Skip to main content

1E 8.1 (on-premises)

Discovery.SendArpRequest

Method

SendArpRequest

Module

Discovery

Library

Discovery

Action

Performs an ARP request to retrieve the physical address for the supplied IPv4 address.

Parameters

IpAddress (string): The IPv4 address that the ARP request is intended to retrieve a physical address for.

Return values

IpAddress (string): The destination IP for the ARP request.

MacAddress (string): The physical address that corresponds to IpAddress.

Example

Returns a MacAddress and an IpAddress in a single row.

Discovery.SendArpRequest(IpAddress:"1.2.3.4");

Platforms

  • Windows

Notes

This method will only attempt to send ARP requests for IPv4 addresses. IPv6 addresses will be ignored, and a warning will be logged.

Warning

This method may request information over the wire. As such, it shouldn't be sent to a lot of machines. Staggering is also a recommended practice.

Warning

This method will never return anything other than SuccessNoContent or Success. If the ARP request is unsuccessful, the reason will be logged at warn level and SuccessNoContent will be returned.

In this section: