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