How to use upKeeper Application Handler

upKeeper Application Handler utilizes winget command line utility which enables installing applications and other packages from the command line as system or user.
This tool serves as a wrapper around winget, simplifying the process of installing, updating, and uninstalling packages.

System Requirements

- Windows 11
- Upkeeper Manager 5.2.x or later
- .net 10 desktop runtime (will try to download and install if missing)

Basic Usage

upKeeper.Application.Handler.exe [<command>] [<options>]

Available Commands

install --id <id>       Installs the given package id.
uninstall --id <id>     Uninstalls the given package id.
update|upgrade          Installs and/or uninstall user packages.
search --query <query>    Searches for packages from configured sources.

Use the help flag to show usage information. [--help]

Available Options

--best-practice, --bp   Add best practice options to winget command arguments, such as:
                       '--accept-package-agreements --accept-source-agreements --disable-interactivity --force --silent'
--log-to-file           Log to local file.
--log-level <level>     Set log level. Debug, Information, Warning, Error or Fatal.
--scope machine|user    Set the scope for the command.

Install Command Options

--custom "<string>"        Arguments to be passed on to the installer in addition to the defaults.
--override "<string>"   A string that will be passed directly to the installer.
--upgrade-precommand "<string>"    A command string that will be executed before winget upgrade.

Uninstall Command Options

--override-uninstall "<string>" A command string that will be executed instead of winget uninstall.    
--precommand "<string>"    A command string that will be executed before winget uninstall.

Default Values

- Default Scope: Depends on execution context
 - When run in user context: 'user'
 - When run in NT-SYSTEM context: 'machine'
- Default Log Level: 'Warning'

Log File Locations

When using the --log-to-file option, logs are written to:
- NT-SYSTEM context: C:\WINDOWS\TEMP\upKeeper_Application_Handler.log
- User context: C:\Users\[username]\AppData\Local\Temp\upKeeper_Application_Handler.log

Examples

Installing a Package

This installs Visual Studio Code with best practice options, which includes silent installation and acceptance of agreements.

upKeeper.Application.Handler.exe install --id Microsoft.VisualStudioCode --bp

Uninstalling a Package

This uninstalls Microsoft Teams from the machine context (all users).

upKeeper.Application.Handler.exe uninstall --id Microsoft.Teams --scope machine

Updating Packages

This updates all packages in the default scope by checking the configured applications in the registry, with detailed logging to a file.

upKeeper.Application.Handler.exe update --log-to-file --log-level Information