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.
Before you begin
Section titled “Before you begin”- The agent is installed and enrolled.
epw.exeis at%ProgramFiles%\EndpointWorks\Agent\bin\epw.exeand on the machinePATH. - Plan: Business or higher for the read-only commands. Premium for
install,upgradeandbaseline 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.
Commands
Section titled “Commands”| 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.
Example
Section titled “Example”PS> epw search firefoxPS> epw show Mozilla.Firefox --versionsPS> epw install Mozilla.FirefoxIf the device is offline, add --queue. The request is sent at the next check-in and epw exits 25.
How it differs from winget
Section titled “How it differs from winget”| 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.
Limits
Section titled “Limits”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.
Troubleshooting
Section titled “Troubleshooting”| 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.