Skip to main content

Test-Online

SYNOPSIS

Tests ICMP reachability using the historical Keldor output shape.

SYNTAX

Test-Online [[-ComputerName] <String[]>] [<CommonParameters>]

DESCRIPTION

Deprecated compatibility wrapper for Test-ResponseTime. It tests ICMP echo response only; it does not determine whether a computer is generally online or whether PowerShell remoting is available.

EXAMPLES

EXAMPLE 1

Test-Online -ComputerName server01

Tests ICMP reachability and returns Name and Status compatibility properties.

PARAMETERS

-ComputerName

Specifies one or more ICMP targets.

Type: String[]
Parameter Sets: (All)
Aliases: Host, Name, Computer, CN

Required: False
Position: 1
Default value: $env:COMPUTERNAME
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

OUTPUTS

System.Management.Automation.PSCustomObject

NOTES

Use Test-ResponseTime for explicit ICMP latency testing. Removal is targeted for Keldor 1.0.0.

ALIASES

None.

PLATFORM APPLICABILITY

Windows only. The platform-aware loader does not export this command on Linux or macOS.

POWERSHELL COMPATIBILITY

See PowerShell compatibility for the supported runtime policy. PowerShell 7.6 LTS is preferred.

https://docs.keldor.dev/powershell/keldor/Test-Online