Win32_PingStatus

The Win32_PingStatus class contains the values returned by the standard ping command. More information on ping can be found in RFC 791.

Quick Start

Properties

In this WMI class, all WMI properties are read-only. You can only read values but not change them.

Address

Data type String

The Address property holds the value of the address requested. This can be either hostname (‘wxyz1234’) or IP address (‘193.128.177.124’).

BufferSize

Data type UInt32

The BufferSize property indicates the buffer size sent with the ping command. The default value is 32.

NoFragmentation

Data type Boolean

The NoFragmentation property sets a ‘Don’t Fragment’ on packets sent. The default is $false, not fragmented.

PrimaryAddressResolutionStatus

Data type UInt32

The PrimaryAddressResolutionStatus property holds status information resulting from the gethostbyname call. This property reports the status of the resolution of the address value (ie value of the address property) given in the query. It is not related to any other resolution performed.

The property can take the following values:

$PrimaryAddressResolutionStatus_ReturnValue = 
@{
    0='Success'
   ..='Other'
}

ProtocolAddress

Data type String

The ProtocolAddress property contains the address that the destination used to reply.

ProtocolAddressResolved

Data type String

The ProtocolAddressResolved property contains the resolved address corresponding to the ProtocolAddress property

RecordRoute

Data type UInt32

The RecordRoute property indicates how many hops should be recorded while the packet is enroute. The default is zero.

ReplyInconsistency

Data type Boolean

The ReplyInconsistency property reports inconsistent reply data.

ReplySize

Data type UInt32

The ReplySize property indicates the size of the buffer returned.

ResolveAddressNames

Data type Boolean

The ResolveAddressesNames indicates whether or not the command will resolve address names of output address values. The default is $false – no resolution.

ResponseTime

Data type UInt32

The ResponseTime property indicates the time elapsed to handle the request.

ResponseTimeToLive

Data type UInt32

The ResponseTimeToLive property indicates the time to live from moment the request is received.

RouteRecord

Data type String[] (Array)

The RouteRecord property holds a record of intermediate hops.

 This property is an array. It contains multiple values. Use square brackets to index individual values, or use the PowerShell -join operator to convert the array to a string.

RouteRecordResolved

Data type String[] (Array)

The RouteRecordResolved property holds the resolved address corresponding to the RouteRecord entry.

 This property is an array. It contains multiple values. Use square brackets to index individual values, or use the PowerShell -join operator to convert the array to a string.

SourceRoute

Data type String

The SourceRoute property contais a comma separated list of valid Source Routes.

SourceRouteType

Data type UInt32

The SourceRouteType property indicates the type of source route option to be used on host list specified in the SourceRoute property. If a value outside of the ValueMap is specified 0 is assumed. The default is zero.

$SourceRouteType_ReturnValue = 
@{
    0='None'
    1='Loose Source Routing'
    2='Strict Source Routing'
}

StatusCode

Data type UInt32

The StatusCode property returns the ping status codes.

$StatusCode_ReturnValue = 
@{
    0='Success'
  11001='Buffer Too Small'
  11002='Destination Net Unreachable'
  11003='Destination Host Unreachable'
  11004='Destination Protocol Unreachable'
  11005='Destination Port Unreachable'
  11006='No Resources'
  11007='Bad Option'
  11008='Hardware Error'
  11009='Packet Too Big'
  11010='Request Timed Out'
  11011='Bad Request'
  11012='Bad Route'
  11013='TimeToLive Expired Transit'
  11014='TimeToLive Expired Reassembly'
  11015='Parameter Problem'
  11016='Source Quench'
  11017='Option Too Big'
  11018='Bad Destination'
  11032='Negotiating IPSEC'
  11050='General Failure'
}

Timeout

Data type UInt32

The Timeout property indicates the Timeout value in milliseconds. If a response is not received in this time no response will be assumed. The default is 4000 milliseconds.

TimeStampRecord

Data type UInt32[] (Array)

The TimeStampRecord property holds a record timestamps for intermediate hops.

 This property is an array. It contains multiple values. Use square brackets to index individual values, or use the PowerShell -join operator to convert the array to a string.

TimeStampRecordAddress

Data type String[] (Array)

The TimeStampRecordAddress property holds the intermediate hop corresponding to the TimeStampRecord entry.

 This property is an array. It contains multiple values. Use square brackets to index individual values, or use the PowerShell -join operator to convert the array to a string.

TimeStampRecordAddressResolved

Data type String[] (Array)

The TimeStampRecordAddressResolved property holds the resolved address corresponding to the TimeStampRecordAddress entry.

 This property is an array. It contains multiple values. Use square brackets to index individual values, or use the PowerShell -join operator to convert the array to a string.

TimestampRoute

Data type UInt32

The TimestampRoute property indicates how many hops should be recorded with time stamp information while the packet is enroute. A Timestamp is the number of milliseconds that have passed since midnight UT. If the time is not available in milliseconds or cannot be provided with respect to midnight UT then any time may be inserted as a timestamp provided the high order bit of the timestamp field is set to one to indicate the use of a non-standard value. The default is zero.

TimeToLive

Data type UInt32

The TimeToLive property indicates the lifespan of the ping packet in seconds. This is an upper limit and not absolute as all routers MUST decrement this value by one and hops between routers rarely take this amount of time. When this value becomes zero the packet will be dropped by the router. The default value is 80 seconds.

TypeofService

Data type UInt32

the TypeOfService property provides an indication of the abstract parameters of the quality of service desired. These parameters are to be used to guide the selection of the actual service parameters when transmitting a datagram through a particular network. The default value is 0.

bits 0-2: Precedence.

bit 3: 0 = Normal Delay, 1 = Low Delay.

bits 4: 0 = Normal Throughput, 1 = High Throughput.

bits 5: 0 = Normal Relibility, 1 = High Relibility.

bit 6-7: Reserved.

Precedence

111 – Network Control

110 – Internetwork Control

101 – CRITIC/ECP

100 – Flash Override

011 – Flash

010 – Immediate

001 – Priority

000 – Routine

For a detailed description of the various serive types, refer to RFC 791, page 12.

Methods

Examples

Help and Questions

  Community Content

You are cordially invited to add knowledge to this page. If you have sample code or additional information related to this WMI class, please share it. Use the comment form to send your information. We will edit and incorparate it into the reference library. Thank you!

Please do not use the comment form to submit questions. If you have questions or need assistance, visit our free forum: Help me with WMI.

 Content last updated: 2013-12-27 15:03:07 (UTC).

Facebooktwittergoogle_pluspinterestlinkedinFacebooktwittergoogle_pluspinterestlinkedin