extern/PowerShell
1
0
Fork 0
mirror of https://github.com/fleschutz/PowerShell.git synced 2024-11-25 01:14:16 +01:00
Code Issues Packages Projects Releases Wiki Activity
54635c32da
PowerShell/docs/list-wsl-distros.md
Markus Fleschutz 54635c32da Updated the manuals
2024-11-08 12:35:11 +01:00

1.6 KiB
Raw Blame History

Script: list-wsl-distros.ps1

This PowerShell script lists installed/available Linux distributions for Windows Subsystem for Linux (WSL).

Parameters

/home/markus/Repos/PowerShell/scripts/list-wsl-distros.ps1 [<CommonParameters>]

[<CommonParameters>]
    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.

Example

PS> ./list-wsl-distros.ps1
NAME            STATE           VERSION
* Ubuntu-24.04    Stopped         2
...

Notes

Author: Markus Fleschutz | License: CC0

Related Links

https://github.com/fleschutz/PowerShell

Script Content

<#
.SYNOPSIS
        Lists distros for Windows Subsystem for Linux
.DESCRIPTION
        This PowerShell script lists installed/available Linux distributions for Windows Subsystem for Linux (WSL).
.EXAMPLE
        PS> ./list-wsl-distros.ps1
	  NAME            STATE           VERSION
	* Ubuntu-24.04    Stopped         2
	...
.LINK
        https://github.com/fleschutz/PowerShell
.NOTES
        Author: Markus Fleschutz | License: CC0
#>

try {
	if ($IsLinux -or $IsMacOS) { throw "Requires Windows Subsystem for Linux (WSL)" }

	& wsl.exe --list --verbose
	" "
	& wsl.exe --list --online
	" "
	& wsl.exe --status
	exit 0 # success
} catch {
        "⚠️ Error: $($Error[0]) in script line $($_.InvocationInfo.ScriptLineNumber)."
        exit 1
}

(generated by convert-ps2md.ps1 using the comment-based help of list-wsl-distros.ps1 as of 11/08/2024 12:34:52)