Docs / Command Reference

message.show

Shows a basic OK-only message through the connected Lanview Agent on one client.

CategoryGeneral

ComponentServer console

Riskmedium

Requires reasonNo

Last verified2026-07-13

Allowed Sources

Lanview ConsoleLocal Server ConsoleBatch

Description

Shows a basic OK-only message through the connected Lanview Agent on one client. Creates one tracked MessageShow command. The Client Service forwards it to the locally connected Agent, and the Agent displays a WPF OK-only message dialog. Single-device only. Fails clearly if no suitable Agent is connected. No timeout, history, callback, Yes/No response, or run-as-user behaviour is implemented.

Syntax

message.show <deviceId|machineName> "text" [/icon information|warning|error|question] [/title "title text"] [/ontop]

Parameters

Parameter	Use	Description
`<deviceId\|machineName>`	Required	DeviceId or unique MachineName. text Message text, maximum 1000 characters.
`/icon`	Optional	Optional visual icon; defaults to information.
`/title`	Optional	Optional dialog title, maximum 120 characters; defaults to Message.
`/ontop`	Optional	Requests a topmost Agent message window.

Permissions

devices.send_message

Audit Events

Needs review

Server, Client and Studio Involvement

Needs review

Common Issues

The command may require an authenticated server console or named-pipe admin console session.
Targeted commands may fail if a device is offline, unapproved or not eligible.

Troubleshooting Notes

Needs review.