Skip to content

Use the epw command line

epw works like winget against your organization’s catalog. It never installs anything itself: every change is a request that the server decides and the agent’s broker service carries out.

  • The agent is installed and enrolled. epw.exe is at %ProgramFiles%\EndpointWorks\Agent\bin\epw.exe and on the machine PATH.
  • Plan: Business or higher for the read-only commands. Premium for install, upgrade and baseline install.
  • For requests, an admin turns on Allow requests from the epw command line in Organization › General. Self-service installs also need Allow self-service installs. Both are off by default.
Command Does Who can run it
epw search <query> Searches approved catalog versions, and says if each is available to this device Anyone
epw show <id> --versions Approved versions, trust and vulnerability state, and why a version isn’t allowed Anyone
epw list --upgradable Installed software with the newest approved version and its state Anyone
epw status Compliance, effective mode and last check-in, for people Anyone
epw healthcheck Health and compliance for scripts. Exits 0, 1 or 2 only Anyone
epw doctor Local diagnostics. --repair (admin) runs ew-agent repair Anyone
epw update Refreshes from the server and prints what upgrade would do. Never installs Anyone
epw install <id> Requests an install of a package available to this device Users for available items; admins
epw upgrade <id> or --all Requests the newest approved version. Never downgrades Users for available items; admins
epw baseline list, show, install Baselines on this device Anyone; install as for install
epw logs Your own request history. --all (admin) for everyone’s Anyone
epw export Device state as JSON Anyone

epw uninstall answers disabled (exit 23) in this release.

Global flags: --json, --quiet, --no-wait, --timeout <min> (default 60), --queue.

Terminal window
PS> epw search firefox
PS> epw show Mozilla.Firefox --versions
PS> epw install Mozilla.Firefox

If the device is offline, add --queue. The request is sent at the next check-in and epw exits 25.

winget epw
install --version, --override, --scope Not accepted. Arguments come only from the verified manifest
update installs updates update only refreshes. Run epw upgrade --all to apply
source add Not needed. The agent uses your organization’s source
HRESULT exit codes (0x8A15…) MSI-style codes plus 0-13 and 20-29

You can still run winget against your source on a device with the agent. Those installs show up at the next inventory.

10 change requests per hour per user on a device, and one at a time. The server also limits requests per device, per package and per organization. Over a limit, epw exits 29.

Exit Meaning Fix
9 The agent isn’t enrolled Check the enrollment token and server URL.
12 Needs an elevated prompt Run as administrator.
20 Not in your catalog Add the package to the catalog.
21 Not available to this device Assign it, or make it available to the device’s group.
22 Your plan doesn’t include this See Plans and features.
23 Refused by policy Requests or self-service are off, or the package is required or Intune-owned.

All codes: Agent and epw exit codes.