Skip to content

ethanbergstrom/Cobalt

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

43 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CI

Cobalt

Cobalt is a simple PowerShell Crescendo wrapper for WinGet

Requirements

In addition to PowerShell 5.1+ and an Internet connection on a Windows machine, WinGet must also be installed. Microsoft recommends installing WinGet from the Windows Store as part of the App Installer package.

Install Cobalt

Install-Module Cobalt -Force

Sample usages

Search for a package

Find-WinGetPackage -ID openJS.nodejs

Find-WinGetPackage -ID Mozilla.Firefox -Exact

Get a package's detailed information from the repository

Get-WinGetPackageInfo -ID CPUID.CPU-Z -Version 1.95

Find-WinGetPackage -ID Mozilla.Firefox -Exact | Get-WinGetPackageInfo

Get all available versions of a package

Get-WinGetPackageInfo -ID CPUID.CPU-Z -Versions

Find-WinGetPackage -ID Mozilla.Firefox -Exact | Get-WinGetPackageInfo -Versions

Install a package

Find-WinGetPackage OpenJS.NodeJS -Exact | Install-WinGetPackage

Install-WinGetPackage 7zip.7zip

Install a list of packages

@('CPUID.CPU-Z','7zip.7zip') | ForEach-Object { Install-WinGetPackage $_ }

Install a specific version of a package

Install-WinGetPackage CPUID.CPU-Z -Version 1.95

Install multiple packages with specific versions

@(
    @{
        id = 'CPUID.CPU-Z'
        version = '1.95'
    },
    @{
        id = 'putty.putty'
        version = '0.74'
    }
) | Install-WinGetPackage

Get list of installed packages

Get-WinGetPackage nodejs

Get list of installed packages that can be upgraded

Get-WinGetPackageUpdate

Upgrade a package

Update-WinGetPackage CPUID.CPU-Z

Upgrade a list of packages

@('CPUID.CPU-Z','7zip.7zip') | ForEach-Object { Update-WinGetPackage -ID $_ }

Upgrade all packages

⚠️ Use at your own risk! WinGet will try to upgrade all layered software it finds, may not always succeed, and may upgrade software you don't want upgraded.

Update-WinGetPackage -All

Uninstall a package

Get-WinGetPackage nodejs | Uninstall-WinGetPackage

Uninstall-WinGetPackage 7zip.7zip

Manage package sources

Register-WinGetSource privateRepo -Argument 'https://somewhere/out/there/api/v2/'
Find-WinGetPackage nodejs -Source privateRepo -Exact | Install-WinGetPackage
Unregister-WinGetSource privateRepo

Cobalt integrates with WinGet.exe to manage and store source information

Known Issues

Stability

WinGet's behavior and APIs are still very unstable. Do not be surprised if this module stops working with newer versions of WinGet.

Retrieving package upgrade list hangs on first use

Due to a bug that is resolved in WinGet v1.3 preview releases, if Get-WinGetPackageUpdate is ran with WinGet v1.2.x or below without having first accepted source license agreements, the cmdlet will hang indefinitely due to source agreements not having been accepted.

Available workarounds include:

  • Running another cmdlet that invokes correctly-behaving WinGet behavior (ex: Get-WinGetPackage)
  • Manually accepting the source agreement via the WinGet CLI

After WinGet v1.3 is generally available with the bug fixed, a new version of this module will be released to resolve this issue.

Legal and Licensing

Cobalt is licensed under the MIT license.