Agent Commands

Last Updated: June 30, 2026

Below are some common commands that you can use with the Virtual Appliance Agent on Windows, macOS, and Linux devices.

For overrides, refer to Override Options for Windows and Override Options for Mac & Linux.

Windows

Start the Agent

Copy Code 
"C:\Program Files (x86)\Printer Properties Pro\Printer Installer Client\PrinterInstallerClient.exe" hideclientwindow

Open the Printer Installer Client Console

Copy Code 
"C:\Program Files (x86)\Printer Properties Pro\Printer Installer Client\PrinterInstallerClient.exe" showclientwindow

Open the Select new default printer Window

Copy Code 
"C:\Program Files (x86)\Printer Properties Pro\Printer Installer Client\PrinterInstallerClient.exe" autoopensetdefault

Open the Select a printer to delete Window

Copy Code 
"C:\Program Files (x86)\Printer Properties Pro\Printer Installer Client\PrinterInstallerClient.exe" autoopendeleteprinter

Open the Installed Printers List

Copy Code 
"C:\Program Files (x86)\Printer Properties Pro\Printer Installer Client\PrinterInstallerClient.exe" autoopenviewprinter

Open the Self-service Portal

Copy Code 
"C:\Program Files (x86)\Printer Properties Pro\Printer Installer Client\PrinterInstallerClient.exe" autoopensystray

Refresh the Agent

Copy Code 
"C:\Program Files (x86)\Printer Properties Pro\Printer Installer Client\PrinterInstallerClient.exe" refresh

Refresh the Agent (Silent)

Copy Code 
"C:\Program Files (x86)\Printer Properties Pro\Printer Installer Client\PrinterInstallerClient.exe" silentrefresh

Shut Down the Agent

Copy Code 
"C:\Program Files (x86)\Printer Properties Pro\Printer Installer Client\PrinterInstallerClient.exe" Shutdown

Uninstall the Agent

Copy Code 
C:\Windows\SysWOW64\msiexec.exe /x {A9DE0858-9DDD-4E1B-B041-C2AA90DCBF74}

macOS

Download the Agent-Installation File

Copy Code 
PIC="PrinterInstallerClientSetup.pkg"
if [[ $(uname -m) == 'arm64' ]]; then
PIC="PrinterInstallerClientSetup_arm64.pkg"
fi
curl -o /tmp/PrinterInstallerClientSetup.pkg <HOME_URL_HERE>/client/setup/$PIC

Replace <HOME_URL_HERE> with your instance's URL.

Start the Agent

Copy Code 
sudo launchctl load -w /Library/LaunchDaemons/com.printerlogic.client.plist

Stop the Agent

Copy Code 
sudo launchctl unload /Library/LaunchDaemons/com.printerlogic.client.plist

Update the Agent

Copy Code 
 curl -o /tmp/PrinterInstallerClientUpdater.pkg https://<HOMEURL>/client/setup/PrinterInstallerClientUpdater.pkg 
sudo installer -allowUntrusted -pkg /tmp/PrinterInstallerClientUpdater.pkg -target /

Linux

Start the Agent

Copy Code 
sudo systemctl start printer-installer-client

Stop the Agent

Copy Code 
sudo systemctl stop printer-installer-client
sudo killall -s SIGKILL PrinterInstallerClientService
sudo killall -s SIGKILL PrinterInstallerClientInterface
sudo killall -s SIGKILL PrinterLogicIdpAuthentication
sudo killall -s SIGKILL system_tray_icon
#If the device is configured as the Service Client, the commands below stop the additional services running.
sudo killall -s SIGKILL PrinterLogicServiceManager
sudo killall -s SIGKILL PrinterLogicServicePrinterApp
sudo killall -s SIGKILL PrinterLogicServiceIdentitySync
sudo killall -s SIGKILL PrinterLogicServiceSNMP
sudo killall -s SIGKILL PrinterLogicServiceOffNetworkClient
sudo killall -s SIGKILL PrinterLogicServiceOffNetworkServer

macOS and Linux

Refresh the Agent

Copy Code 
sudo /opt/PrinterInstallerClient/bin/refresh.sh

Uninstall the Agent

Copy Code 
sudo /opt/PrinterInstallerClient/bin/uninstall.sh

Create a Debug Bundle

This command creates a debug bundle for troubleshooting with our Support team and stores it in /opt/PrinterInstallerClient/bin, using the naming scheme "PrinterLogic-debug-<timestamp>.zip."

Copy Code 
sudo /opt/PrinterInstallerClient/bin/bundle_debug.sh

List All Virtual Appliance Binaries Currently Running

Copy Code 
sudo ps aux | grep "$(cat /etc/pl_dir)"

Set a Proxy Server on macOS or Linux

Copy Code 
http_proxy=<proxy_server_fqdn_or_ip>:<port>
https_proxy=<proxy_server_fqdn_or_ip>:<port>

The following are examples:

  • http_proxy=proxy.mycompany.com:8080.
  • https_proxy=proxy.mycompany.com:8080.

To completely turn off the proxy, refer to Override Options for Mac & Linux.