Skip to content

Automation

Frans van Dorsselaer edited this page Mar 26, 2022 · 3 revisions

ℹ️ This requires version 2.2.0 or higher

Commands like usbipd list and usbipd wsl list output their information in a human-readable table format where some of the strings may be truncated if they go beyond the column width. Furthermore, they only display a subset of the state.

To facilitate scripted automation, two features were added in version 2.2.0.

JSON

A new command was added which outputs all state information in JSON format:

usbipd state

PowerShell

A PowerShell module was added that further processes the JSON output to strongly-typed objects with additional metadata that can be inferred from the information. The PowerShell module is compatible with Powershell 5.1 (the default that comes with Windows 10) as well a PowerShell 7 (from the Windows Store). The PowerShell module is tied to the version of usbipd-win, so it will not be released to PowerShell Gallery separately. Instead, you will have to import the module manually as follows:

Import-Module $env:ProgramW6432'\usbipd-win\PowerShell\Usbipd.Powershell.dll'

The PowerShell module exposes a single command:

Get-UsbipdDevice

Example 1

To display a table of BusId and Description of all devices currently attached to WSL:

Get-UsbipdDevice | Where-Object {$_.IsWslAttached} | Format-Table BusId,Description

Example 2

To display all USB devices connected your computer that are currently not shared:

Get-UsbipdDevice | Where-Object {$_.IsConnected -and -not $_.IsBound}
Clone this wiki locally