[Bug] Characters in paths permitted by Linux (usable via BTRFS) that aren't permitted by `PathCleanupSpec` become `$Null` or invalid codepoints.

[RokeJulianLockhart]

Windows Version

10.0.26120.0

WSL Version

2.6.0.0

Are you using WSL 1 or WSL 2?

1. WSL 2

2. WSL 1

Kernel Version

uname -a

uname -a returns:

Linux version 6.6.87.2-microsoft-standard-WSL2 (root@439a258ad544) (gcc (GCC) 11.2.0, GNU ld (GNU Binutils) 2.37) #1 SMP PREEMPT_DYNAMIC Thu Jun 5 18:30:46 UTC 2025

Distro Version

lsb-release

LSB has been long deprecated, so it isn't available outside of Debian derivatives. Consequently, etc/os-release returns cpe:/o:fedoraproject:fedora:39 and HOME_URL="https://github.com/WhitewaterFoundry/Fedora-Remix-for-WSL".

Other Software

microsoft/terminal#19058 (comment) includes this information (from an unrelated BR about MAX_PATH):

1. Obviously, explorer.exe applies:

   1. #!/usr/bin/env pwsh
      #Requires -PSEdition 'Core'
      If ($IsWindows)
      {
      	Get-Item -Path (
      		Get-Command 'explorer' | `
      		Select-Object -ExpandProperty 'Source'
      	) | `
      	Select-Object -ExpandProperty 'VersionInfo' | `
      	Format-List
      }

      ¹

   2. OriginalFilename  : EXPLORER.EXE.MUI
      FileDescription   : Windows Explorer
      ProductName       : Microsoft® Windows® Operating System
      Comments          :
      CompanyName       : Microsoft Corporation
      FileName          : C:\Windows\explorer.exe
      FileVersion       : 10.0.26100.4441 (WinBuild.160101.0800)
      ProductVersion    : 10.0.26100.4441
      IsDebug           : False
      IsPatched         : False
      IsPreRelease      : False
      IsPrivateBuild    : False
      IsSpecialBuild    : False
      Language          : English (United Kingdom)
      LegalCopyright    : © Microsoft Corporation. All rights reserved.
      LegalTrademarks   :
      PrivateBuild      :
      SpecialBuild      :
      FileVersionRaw    : 10.0.26100.2415
      ProductVersionRaw : 10.0.26100.2415

2. However, Bug: The first file and directory names to exceed the 260-character MAX_PATH limit appear truncated. files-community/Files#17133 (comment) could also apply here:

   1. #!/usr/bin/env pwsh
      Get-AppxPackage FilesPreview

   2. Publisher         : CN=Yair Aichenbaum, O=Yair Aichenbaum, L=Baltimore, S=Maryland, C=US
      ResourceId        :
      InstallLocation   : C:\Program Files\WindowsApps\FilesPreview_3.9.10.0_x64__1y0xx7n9077q4
      IsFramework       : False
      IsResourcePackage : False
      IsBundle          : False
      IsDevelopmentMode : False
      NonRemovable      : False
      Dependencies      : {Microsoft.WindowsAppRuntime.1.7_7000.522.1444.0_x64__8wekyb3d8bbwe,
                          Microsoft.VCLibs.140.00.UWPDesktop_14.0.33728.0_x64__8wekyb3d8bbwe,
                          Microsoft.VCLibs.140.00_14.0.33519.0_x64__8wekyb3d8bbwe}
      IsPartiallyStaged : False
      SignatureKind     : Developer
      Status            : Ok

Repro Steps

As files-community/Files#17205 (comment) explains:

1. Using a real Linux OS, in a BTRFS filesystem, create a path longer than MAX_PATH that contains tab characters.

2. On the host, execute the undermentioned:

   #!/usr/bin/env pwsh
   #Requires -PSEdition Core
   If ($IsWindows) { wmic diskdrive list brief }

   ²

3. When the correct filesystem has been identified:

   #!/usr/bin/env pwsh
   #Requires -PSEdition Core
   If ($IsWindows) { sudo wsl --mount \\.\PHYSICALDRIVE1 --bare }

4. Likewise, on WSL:

   #!/usr/bin/env sh
   sudo lsblk -o NAME,FSTYPE,FSVER,FSAVAIL,MOUNTPOINTS

   This shall return output similar to the undermentioned:

   NAME   FSTYPE FSVER FSAVAIL MOUNTPOINTS
   sda    ext4   1.0
   sdb    ext4   1.0
   sdc    swap   1             [SWAP]
   sdd    ext4   1.0    954.6G /mnt/wslg/distro
                               /
   sde
   ├─sde1 vfat   FAT32
   ├─sde2 ext4   1.0
   ├─sde3 ext4   1.0
   └─sde4 btrfs           1.2T /mnt/rjlb/fedora

   Utilise the output to confirm that the device has been mounted into wsl, then set its path as $dev_id, and define a mount point at $path.

5. When the correct filesystem has been identified:

   #!/usr/bin/env sh
   sudo mkdir /mnt/$path && \
   sudo mount -t btrfs -o ro /dev/$dev_id /mnt/$path

   ³

Expected Behavior

Consumers should be provided with escaped or verbatim representations of the file paths.

Actual Behavior

Most importantly, explorer.exe (and others, like FilesCommunity.Files, hence the report here, rather than at Feedback Hub) render replacement characters for invalid codepoints where the tabs should be. WSL shouldn't ever replace valid UTF codepoints with invalid codepoints. UNICODE doesn't ever permit that.

Additionally, IDK whether it's due to being past MAX_PATH or the filenames themselves, but if I open a wt.exe instance (via FilesPreview, because of microsoft/terminal#19058 (comment)) at Microsoft.PowerShell.Core\FileSystem::\\wsl.localhost\fedoraremix\mnt\rjlb_data\@{'Name'='Entities'}#.dir\@{'Status'='Commenced'; 'Name'='In Use'}#.dir\@{'Person'='Beedell'; 'Identifier'='S21AIB'}#.dir\@{'Name'='Entity-Specific'}#.dir\@{'Person'='Roke'; 'Identifier'='S1EV2L'}#.dir\@{'Name'='Temporary'}#.dir, then run:

1. tree spawns in a new OpenConsole window (which it never does elsewhere), then crashes (per WinDbg):

   C:\__w\1\s\src\server\ConDrvDeviceComm.cpp(147)\OpenConsole.exe!00007FF7CF792894: (caller: 00007FF7CF7925C7) ReturnHr(1) tid(6020) 800700E9 No process is on the other end of the pipe.
   ntdll!NtTerminateProcess+0x14:
   00007ffc`1f7dfc34 c3              ret
   0:007> k
    # Child-SP          RetAddr               Call Site
   00 0000002b`3a7ffc38 00007ffc`1f75fd8e     ntdll!NtTerminateProcess+0x14
   01 0000002b`3a7ffc40 00007ffc`1e9218ab     ntdll!RtlExitUserProcess+0x11e
   02 0000002b`3a7ffc70 00007ff7`cf70a4b9     KERNEL32!ExitProcessImplementation+0xb
   03 0000002b`3a7ffca0 00007ff7`cf72eb47     OpenConsole+0xa4b9
   04 0000002b`3a7ffcd0 00007ffc`1e90e8d7     OpenConsole+0x2eb47
   05 0000002b`3a7fff50 00007ffc`1f75fbcc     KERNEL32!BaseThreadInitThunk+0x17
   06 0000002b`3a7fff80 00000000`00000000     ntdll!RtlUserThreadStart+0x2c

   Originally, I thought it was designed to close on completion, but tree, in all other circumstances, doesn't spawn a new window. It wouldn't make much sense for a standalone window, anyway. (I've a .dump /ma, if of use, although IDK whether that would probably be best provided to the Windows Terminal team.)

2. Per When Get-ChildItem's $PWD contains children whose names are comprised of characters disallowed by PathCleanupSpec, it renders them as $Null. PowerShell/PowerShell#25680 (comment), Get-ChildItem, no names are returned, despite Windows disallowing $Null filenames:

   PS Microsoft.PowerShell.Core\FileSystem::\\wsl.localhost\fedoraremix\mnt\rjlb_data\@{'Name'='Entities'}#.dir\@{'Status'='Commenced'; 'Name'='In Use'}#.dir\@{'Person'='Beedell'; 'Identifier'='S21AIB'}#.dir\@{'Name'='Entity-Specific'}#.dir\@{'Person'='Roke'; 'Identifier'='S1EV2L'}#.dir\@{'Name'='Temporary'}#.dir> ls
   
       Directory: \\wsl.localhost\fedoraremix\mnt\rjlb_data\@{'Name'='Entities'}#.dir\@{'Status'='Commenced'; 'Name'='In
   Use'}#.dir\@{'Person'='Beedell'; 'Identifier'='S21AIB'}#.dir\@{'Name'='Entity-Specific'}#.dir\@{'Person'='Roke';
   'Identifier'='S1EV2L'}#.dir\@{'Name'='Temporary'}#.dir
   
   Mode                 LastWriteTime         Length Name
   ----                 -------------         ------ ----
   d----          2024-04-08    13:30
   d----          2023-09-25    23:51
   d----          2023-03-21    16:30
   d----          2023-12-16    03:10
   d----          2023-04-15    19:55
   d----          2022-10-23    22:23
   d----          2023-09-22    22:00
   d----          2023-09-22    22:01
   -----          2022-06-23    14:26     1011594814
   -----          2022-05-12    23:15         144430
   -----          2022-07-01    00:20            557
   -----          2022-01-07    00:50         373962
   -----          2023-09-22    22:02             67
   -----          2021-03-19    14:41          65647 @{'Status'='Completed'; 'Name'='Instagram Illustration';
                                                     'Identifier'='S1G0ZM'}#.JPEG
   -----          2022-05-12    23:15           3296
   -----          2022-05-26    13:21         440127
   -----          2022-05-26    13:25          18313
   -----          2022-06-30    09:13         141148
   -----          2022-06-30    09:14         250847
   -----          2022-07-01    17:35          35892
   -----          2022-07-02    01:14         165810
   -----          2022-07-02    01:14          48157
   -----          2022-07-03    14:10         376541
   -----          2021-12-24    15:18           9367
   -----          2022-03-23    14:59          25051
   -----          2023-07-04    23:41          34374

Heck, I shan't be surprised if this relates to microsoft/WinDbg-Feedback#248 (comment) too.

Diagnostic Logs

I've attempted to adhere to github.com/microsoft/WSL/blob/769e508a341ad45dd24ee0794e75a15a6d211986/CONTRIBUTING.md?plain=1#L104C1-L112C65, but it merely hangs:

Footnotes

1. stackoverflow.com/revisions/45517267/4 ↩

2. blog.bryanroessler.com/2020-12-14-btrfs-on-wsl2/ ↩

3. askubuntu.com/revisions/296342/3 ↩

[github-actions]

Logs are required for review from WSL team

If this a feature request, please reply with '/feature'. If this is a question, reply with '/question'.
Otherwise please attach logs by following the instructions below, your issue will not be reviewed unless they are added. These logs will help us understand what is going on in your machine.

How to collect WSL logs

Download and execute collect-wsl-logs.ps1 in an administrative powershell prompt:

Invoke-WebRequest -UseBasicParsing "https://raw.githubusercontent.com/microsoft/WSL/master/diagnostics/collect-wsl-logs.ps1" -OutFile collect-wsl-logs.ps1
Set-ExecutionPolicy Bypass -Scope Process -Force
.\collect-wsl-logs.ps1

The script will output the path of the log file once done.

If this is a networking issue, please use collect-networking-logs.ps1, following the instructions here

Once completed please upload the output files to this Github issue.

Click here for more info on logging
If you choose to email these logs instead of attaching to the bug, please send them to wsl-gh-logs@microsoft.com with the number of the github issue in the subject, and in the message a link to your comment in the github issue and reply with '/emailed-logs'.

[RokeJulianLockhart]

#13166 (comment)

.\collect-wsl-logs.ps1 doesn't work!

1. WSL/diagnostics/collect-wsl-logs.ps1

   Lines 1 to 165 in 902848b

   	#Requires -RunAsAdministrator
   	[CmdletBinding()]
   	Param (
   	$LogProfile = $null,
   	[switch]$Dump = $false
   	)
   	Set-StrictMode -Version Latest
   	$folder = "WslLogs-" + (Get-Date -Format "yyyy-MM-dd_HH-mm-ss")
   	mkdir -p $folder | Out-Null
   	if ($LogProfile -eq $null -Or ![System.IO.File]::Exists($LogProfile))
   	{
   	if ($LogProfile -eq $null)
   	{
   	$url = "https://raw.githubusercontent.com/microsoft/WSL/master/diagnostics/wsl.wprp"
   	}
   	elseif ($LogProfile -eq "storage")
   	{
   	$url = "https://raw.githubusercontent.com/microsoft/WSL/master/diagnostics/wsl_storage.wprp"
   	}
   	else
   	{
   	Write-Error "Unknown log profile: $LogProfile"
   	exit 1
   	}
   	$LogProfile = "$folder/wsl.wprp"
   	try {
   	Invoke-WebRequest -UseBasicParsing $url -OutFile $LogProfile
   	}
   	catch {
   	throw
   	}
   	}
   	reg.exe export HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Lxss $folder/HKCU.txt 2>&1 | Out-Null
   	reg.exe export HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Lxss $folder/HKLM.txt 2>&1 | Out-Null
   	reg.exe export HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\P9NP $folder/P9NP.txt 2>&1 | Out-Null
   	reg.exe export HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WinSock2 $folder/Winsock2.txt 2>&1 | Out-Null
   	reg.exe export "HKEY_CLASSES_ROOT\CLSID\{e66b0f30-e7b4-4f8c-acfd-d100c46c6278}" $folder/wslsupport-proxy.txt 2>&1 | Out-Null
   	reg.exe export "HKEY_CLASSES_ROOT\CLSID\{a9b7a1b9-0671-405c-95f1-e0612cb4ce7e}" $folder/wslsupport-impl.txt 2>&1 | Out-Null
   	Get-ItemProperty -Path "Registry::HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion" > $folder/windows-version.txt
   	Get-Service wslservice -ErrorAction Ignore | Format-list * -Force > $folder/wslservice.txt
   	$wslconfig = "$env:USERPROFILE/.wslconfig"
   	if (Test-Path $wslconfig)
   	{
   	Copy-Item $wslconfig $folder | Out-Null
   	}
   	get-appxpackage MicrosoftCorporationII.WindowsSubsystemforLinux -ErrorAction Ignore > $folder/appxpackage.txt
   	get-acl "C:\ProgramData\Microsoft\Windows\WindowsApps" -ErrorAction Ignore | Format-List > $folder/acl.txt
   	Get-WindowsOptionalFeature -Online > $folder/optional-components.txt
   	bcdedit.exe > $folder/bcdedit.txt
   	$uninstallLogs = "$env:TEMP/wsl-uninstall-logs.txt"
   	if (Test-Path $uninstallLogs)
   	{
   	Copy-Item $uninstallLogs $folder | Out-Null
   	}
   	$wprOutputLog = "$folder/wpr.txt"
   	wpr.exe -start $LogProfile -filemode 2>&1 >> $wprOutputLog
   	if ($LastExitCode -Ne 0)
   	{
   	Write-Host -ForegroundColor Yellow "Log collection failed to start (exit code: $LastExitCode), trying to reset it."
   	wpr.exe -cancel 2>&1 >> $wprOutputLog
   	wpr.exe -start $LogProfile -filemode 2>&1 >> $wprOutputLog
   	if ($LastExitCode -Ne 0)
   	{
   	Write-Host -ForegroundColor Red "Couldn't start log collection (exitCode: $LastExitCode)"
   	}
   	}
   	try
   	{
   	Write-Host -NoNewLine "Log collection is running. Please "
   	Write-Host -NoNewLine -ForegroundColor Red "reproduce the problem "
   	Write-Host -NoNewLine "and once done press any key to save the logs."
   	$KeysToIgnore =
   	16, # Shift (left or right)
   	17, # Ctrl (left or right)
   	18, # Alt (left or right)
   	20, # Caps lock
   	91, # Windows key (left)
   	92, # Windows key (right)
   	93, # Menu key
   	144, # Num lock
   	145, # Scroll lock
   	166, # Back
   	167, # Forward
   	168, # Refresh
   	169, # Stop
   	170, # Search
   	171, # Favorites
   	172, # Start/Home
   	173, # Mute
   	174, # Volume Down
   	175, # Volume Up
   	176, # Next Track
   	177, # Previous Track
   	178, # Stop Media
   	179, # Play
   	180, # Mail
   	181, # Select Media
   	182, # Application 1
   	183 # Application 2
   	$Key = $null
   	while ($Key -Eq $null -Or $Key.VirtualKeyCode -Eq $null -Or $KeysToIgnore -Contains $Key.VirtualKeyCode)
   	{
   	$Key = $Host.UI.RawUI.ReadKey('NoEcho,IncludeKeyDown')
   	}
   	Write-Host "`nSaving logs..."
   	}
   	finally
   	{
   	wpr.exe -stop $folder/logs.etl 2>&1 >> $wprOutputLog
   	}
   	if ($Dump)
   	{
   	$Assembly = [PSObject].Assembly.GetType('System.Management.Automation.WindowsErrorReporting')
   	$DumpMethod = $Assembly.GetNestedType('NativeMethods', 'NonPublic').GetMethod('MiniDumpWriteDump', [Reflection.BindingFlags] 'NonPublic, Static')
   	$dumpFolder = Join-Path (Resolve-Path "$folder") dumps
   	New-Item -ItemType "directory" -Path "$dumpFolder"
   	$executables = "wsl", "wslservice", "wslhost", "msrdc", "dllhost"
   	foreach($process in Get-Process | Where-Object { $executables -contains $_.ProcessName})
   	{
   	$dumpFile = "$dumpFolder/$($process.ProcessName).$($process.Id).dmp"
   	Write-Host "Writing $($dumpFile)"
   	$OutputFile = New-Object IO.FileStream($dumpFile, [IO.FileMode]::Create)
   	$Result = $DumpMethod.Invoke($null, @($process.Handle,
   	$process.id,
   	$OutputFile.SafeFileHandle,
   	[UInt32] 2,
   	[IntPtr]::Zero,
   	[IntPtr]::Zero,
   	[IntPtr]::Zero))
   	$OutputFile.Close()
   	if (-not $Result)
   	{
   	Write-Host "Failed to write dump for: $($dumpFile)"
   	}
   	}
   	}
   	$logArchive = "$(Resolve-Path $folder).zip"
   	Compress-Archive -Path $folder -DestinationPath $logArchive
   	Remove-Item $folder -Recurse
   	Write-Host -ForegroundColor Green "Logs saved in: $logArchive. Please attach that file to the GitHub issue."

2. 

   Evidential Logs

   PS C:\Users\rokej> Invoke-WebRequest -UseBasicParsing "https://raw.githubusercontent.com/microsoft/WSL/master/diagnostics/collect-wsl-logs.ps1" -OutFile collect-wsl-logs.ps1
   PS C:\Users\rokej> Set-ExecutionPolicy Bypass -Scope Process -Force
   PS C:\Users\rokej> .\collect-wsl-logs.ps1
   Get-WindowsOptionalFeature: C:\Users\rokej\collect-wsl-logs.ps1:57
   Line |
     57 |  Get-WindowsOptionalFeature -Online > $folder/optional-components.txt
        |  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        | Class not registered
   100%  [>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>]e press any key to save the logs.

If the CLIXML proves it, Get-Error | Export-CLIXML "$Filename" returns:

<Objs Version="1.1.0.1" xmlns="http://schemas.microsoft.com/powershell/2004/04">
  <Obj RefId="0">
    <TN RefId="0">
      <T>System.Management.Automation.ErrorRecord#PSExtendedError</T>
      <T>System.Object</T>
    </TN>
    <ToString>Class not registered_x000D__x000A_</ToString>
    <MS>
      <Obj N="Exception" RefId="1">
        <TN RefId="1">
          <T>System.Runtime.InteropServices.COMException</T>
          <T>System.Runtime.InteropServices.ExternalException</T>
          <T>System.SystemException</T>
          <T>System.Exception</T>
          <T>System.Object</T>
        </TN>
        <ToString>System.Runtime.InteropServices.COMException (0x80040154): Class not registered_x000D__x000A__x000D__x000A_   at System.Management.Automation.MshCommandRuntime.ThrowTerminatingError(ErrorRecord errorRecord)</ToString>
        <Props>
          <I32 N="ErrorCode">-2147221164</I32>
          <S N="TargetSite">Void ThrowTerminatingError(System.Management.Automation.ErrorRecord)</S>
          <S N="Message">Class not registered_x000D__x000A_</S>
          <Obj N="Data" RefId="2">
            <TN RefId="2">
              <T>System.Collections.ListDictionaryInternal</T>
              <T>System.Object</T>
            </TN>
            <DCT />
          </Obj>
          <Nil N="InnerException" />
          <Nil N="HelpLink" />
          <S N="Source">System.Management.Automation</S>
          <I32 N="HResult">-2147221164</I32>
          <S N="StackTrace">   at System.Management.Automation.MshCommandRuntime.ThrowTerminatingError(ErrorRecord errorRecord)</S>
        </Props>
      </Obj>
      <Nil N="TargetObject" />
      <S N="FullyQualifiedErrorId">Microsoft.Dism.Commands.GetWindowsOptionalFeatureCommand</S>
      <Obj N="InvocationInfo" RefId="3">
        <TN RefId="3">
          <T>System.Management.Automation.InvocationInfo</T>
          <T>System.Object</T>
        </TN>
        <ToString>System.Management.Automation.InvocationInfo</ToString>
        <Props>
          <Obj N="MyCommand" RefId="4">
            <TN RefId="4">
              <T>System.Management.Automation.CmdletInfo</T>
              <T>System.Management.Automation.CommandInfo</T>
              <T>System.Object</T>
            </TN>
            <ToString>Get-WindowsOptionalFeature</ToString>
            <Props>
              <S N="Verb">Get</S>
              <S N="Noun">WindowsOptionalFeature</S>
              <S N="HelpFile">Microsoft.Dism.PowerShell.dll-Help.xml</S>
              <Nil N="PSSnapIn" />
              <Version N="Version">3.0</Version>
              <S N="ImplementingType">Microsoft.Dism.Commands.GetWindowsOptionalFeatureCommand</S>
              <S N="Definition">_x000D__x000A_Get-WindowsOptionalFeature -Path &lt;string&gt; [-FeatureName &lt;string&gt;] [-PackageName &lt;string&gt;] [-PackagePath &lt;string&gt;] [-WindowsDirectory &lt;string&gt;] [-SystemDrive &lt;string&gt;] [-LogPath &lt;string&gt;] [-ScratchDirectory &lt;string&gt;] [-LogLevel &lt;LogLevel&gt;] [&lt;CommonParameters&gt;]_x000D__x000A__x000D__x000A_Get-WindowsOptionalFeature -Online [-FeatureName &lt;string&gt;] [-PackageName &lt;string&gt;] [-PackagePath &lt;string&gt;] [-WindowsDirectory &lt;string&gt;] [-SystemDrive &lt;string&gt;] [-LogPath &lt;string&gt;] [-ScratchDirectory &lt;string&gt;] [-LogLevel &lt;LogLevel&gt;] [&lt;CommonParameters&gt;]_x000D__x000A_</S>
              <Nil N="DefaultParameterSet" />
              <Obj N="OutputType" RefId="5">
                <TN RefId="5">
                  <T>System.Collections.ObjectModel.ReadOnlyCollection`1[[System.Management.Automation.PSTypeName, System.Management.Automation, Version=7.6.0.4, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]</T>
                  <T>System.Object</T>
                </TN>
                <LST>
                  <S>System.Collections.Generic.List`1[[Microsoft.Dism.Commands.BasicFeatureObject, Microsoft.Dism.PowerShell, Version=10.0.0.0, Culture=neutral, PublicKeyToken=null]]</S>
                  <S>Microsoft.Dism.Commands.AdvancedFeatureObject</S>
                </LST>
              </Obj>
              <S N="Options">ReadOnly</S>
              <S N="Name">Get-WindowsOptionalFeature</S>
              <S N="CommandType">Cmdlet</S>
              <S N="Source">Dism</S>
              <S N="Visibility">Public</S>
              <S N="ModuleName">Dism</S>
              <S N="Module">Dism</S>
              <S N="RemotingCapability">PowerShell</S>
              <Obj N="Parameters" RefId="6">
                <TN RefId="6">
                  <T>System.Collections.Generic.Dictionary`2[[System.String, System.Private.CoreLib, Version=10.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e],[System.Management.Automation.ParameterMetadata, System.Management.Automation, Version=7.6.0.4, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]</T>
                  <T>System.Object</T>
                </TN>
                <DCT>
                  <En>
                    <S N="Key">FeatureName</S>
                    <S N="Value">System.Management.Automation.ParameterMetadata</S>
                  </En>
                  <En>
                    <S N="Key">PackageName</S>
                    <S N="Value">System.Management.Automation.ParameterMetadata</S>
                  </En>
                  <En>
                    <S N="Key">PackagePath</S>
                    <S N="Value">System.Management.Automation.ParameterMetadata</S>
                  </En>
                  <En>
                    <S N="Key">Path</S>
                    <S N="Value">System.Management.Automation.ParameterMetadata</S>
                  </En>
                  <En>
                    <S N="Key">Online</S>
                    <S N="Value">System.Management.Automation.ParameterMetadata</S>
                  </En>
                  <En>
                    <S N="Key">WindowsDirectory</S>
                    <S N="Value">System.Management.Automation.ParameterMetadata</S>
                  </En>
                  <En>
                    <S N="Key">SystemDrive</S>
                    <S N="Value">System.Management.Automation.ParameterMetadata</S>
                  </En>
                  <En>
                    <S N="Key">LogPath</S>
                    <S N="Value">System.Management.Automation.ParameterMetadata</S>
                  </En>
                  <En>
                    <S N="Key">ScratchDirectory</S>
                    <S N="Value">System.Management.Automation.ParameterMetadata</S>
                  </En>
                  <En>
                    <S N="Key">LogLevel</S>
                    <S N="Value">System.Management.Automation.ParameterMetadata</S>
                  </En>
                  <En>
                    <S N="Key">Verbose</S>
                    <S N="Value">System.Management.Automation.ParameterMetadata</S>
                  </En>
                  <En>
                    <S N="Key">Debug</S>
                    <S N="Value">System.Management.Automation.ParameterMetadata</S>
                  </En>
                  <En>
                    <S N="Key">ErrorAction</S>
                    <S N="Value">System.Management.Automation.ParameterMetadata</S>
                  </En>
                  <En>
                    <S N="Key">WarningAction</S>
                    <S N="Value">System.Management.Automation.ParameterMetadata</S>
                  </En>
                  <En>
                    <S N="Key">InformationAction</S>
                    <S N="Value">System.Management.Automation.ParameterMetadata</S>
                  </En>
                  <En>
                    <S N="Key">ProgressAction</S>
                    <S N="Value">System.Management.Automation.ParameterMetadata</S>
                  </En>
                  <En>
                    <S N="Key">ErrorVariable</S>
                    <S N="Value">System.Management.Automation.ParameterMetadata</S>
                  </En>
                  <En>
                    <S N="Key">WarningVariable</S>
                    <S N="Value">System.Management.Automation.ParameterMetadata</S>
                  </En>
                  <En>
                    <S N="Key">InformationVariable</S>
                    <S N="Value">System.Management.Automation.ParameterMetadata</S>
                  </En>
                  <En>
                    <S N="Key">OutVariable</S>
                    <S N="Value">System.Management.Automation.ParameterMetadata</S>
                  </En>
                  <En>
                    <S N="Key">OutBuffer</S>
                    <S N="Value">System.Management.Automation.ParameterMetadata</S>
                  </En>
                  <En>
                    <S N="Key">PipelineVariable</S>
                    <S N="Value">System.Management.Automation.ParameterMetadata</S>
                  </En>
                </DCT>
              </Obj>
              <Obj N="ParameterSets" RefId="7">
                <TN RefId="7">
                  <T>System.Collections.ObjectModel.ReadOnlyCollection`1[[System.Management.Automation.CommandParameterSetInfo, System.Management.Automation, Version=7.6.0.4, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]</T>
                  <T>System.Object</T>
                </TN>
                <LST>
                  <S>-Path &lt;string&gt; [-FeatureName &lt;string&gt;] [-PackageName &lt;string&gt;] [-PackagePath &lt;string&gt;] [-WindowsDirectory &lt;string&gt;] [-SystemDrive &lt;string&gt;] [-LogPath &lt;string&gt;] [-ScratchDirectory &lt;string&gt;] [-LogLevel &lt;LogLevel&gt;] [&lt;CommonParameters&gt;]</S>
                  <S>-Online [-FeatureName &lt;string&gt;] [-PackageName &lt;string&gt;] [-PackagePath &lt;string&gt;] [-WindowsDirectory &lt;string&gt;] [-SystemDrive &lt;string&gt;] [-LogPath &lt;string&gt;] [-ScratchDirectory &lt;string&gt;] [-LogLevel &lt;LogLevel&gt;] [&lt;CommonParameters&gt;]</S>
                </LST>
              </Obj>
            </Props>
            <MS>
              <S N="Namespace">Dism</S>
              <S N="HelpUri">https://go.microsoft.com/fwlink/?LinkId=289358</S>
              <S N="DLL">C:\Windows\system32\WindowsPowerShell\v1.0\Modules\Dism\Microsoft.Dism.PowerShell.dll</S>
            </MS>
          </Obj>
          <Obj N="BoundParameters" RefId="8">
            <TN RefId="8">
              <T>System.Collections.Generic.Dictionary`2[[System.String, System.Private.CoreLib, Version=10.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e],[System.Object, System.Private.CoreLib, Version=10.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]</T>
              <T>System.Object</T>
            </TN>
            <DCT />
          </Obj>
          <Obj N="UnboundArguments" RefId="9">
            <TN RefId="9">
              <T>System.Collections.Generic.List`1[[System.Object, System.Private.CoreLib, Version=10.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]</T>
              <T>System.Object</T>
            </TN>
            <LST />
          </Obj>
          <I32 N="ScriptLineNumber">57</I32>
          <I32 N="OffsetInLine">1</I32>
          <I64 N="HistoryId">3</I64>
          <S N="ScriptName">C:\Users\rokej\collect-wsl-logs.ps1</S>
          <S N="Line">Get-WindowsOptionalFeature -Online &gt; $folder/optional-components.txt_x000A_</S>
          <S N="Statement">Get-WindowsOptionalFeature -Online &gt; $folder/optional-components.txt</S>
          <S N="PositionMessage">At C:\Users\rokej\collect-wsl-logs.ps1:57 char:1_x000D__x000A_+ Get-WindowsOptionalFeature -Online &gt; $folder/optional-components.txt_x000D__x000A_+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~</S>
          <S N="PSScriptRoot">C:\Users\rokej</S>
          <S N="PSCommandPath">C:\Users\rokej\collect-wsl-logs.ps1</S>
          <S N="InvocationName">Get-WindowsOptionalFeature</S>
          <I32 N="PipelineLength">0</I32>
          <I32 N="PipelinePosition">0</I32>
          <B N="ExpectingInput">false</B>
          <Obj N="CommandOrigin" RefId="10">
            <TN RefId="10">
              <T>System.Management.Automation.CommandOrigin</T>
              <T>System.Enum</T>
              <T>System.ValueType</T>
              <T>System.Object</T>
            </TN>
            <ToString>Internal</ToString>
            <I32>1</I32>
          </Obj>
          <Nil N="DisplayScriptPosition" />
        </Props>
      </Obj>
      <I32 N="ErrorCategory_Category">0</I32>
      <S N="ErrorCategory_Activity">Get-WindowsOptionalFeature</S>
      <S N="ErrorCategory_Reason">COMException</S>
      <S N="ErrorCategory_TargetName"></S>
      <S N="ErrorCategory_TargetType"></S>
      <S N="ErrorCategory_Message">NotSpecified: (:) [Get-WindowsOptionalFeature], COMException</S>
      <B N="SerializeExtendedInfo">false</B>
      <S N="ErrorDetails_ScriptStackTrace">at &lt;ScriptBlock&gt;, C:\Users\rokej\collect-wsl-logs.ps1: line 57_x000D__x000A_at &lt;ScriptBlock&gt;, &lt;No file&gt;: line 1</S>
    </MS>
  </Obj>
</Objs>

In order to demonstrate that I'm not being lazy, I've asked about this at #13169 (comment).

[github-actions]

Logs are required for review from WSL team

If this a feature request, please reply with '/feature'. If this is a question, reply with '/question'.
Otherwise please attach logs by following the instructions below, your issue will not be reviewed unless they are added. These logs will help us understand what is going on in your machine.

How to collect WSL logs

Download and execute collect-wsl-logs.ps1 in an administrative powershell prompt:

Invoke-WebRequest -UseBasicParsing "https://raw.githubusercontent.com/microsoft/WSL/master/diagnostics/collect-wsl-logs.ps1" -OutFile collect-wsl-logs.ps1
Set-ExecutionPolicy Bypass -Scope Process -Force
.\collect-wsl-logs.ps1

The script will output the path of the log file once done.

If this is a networking issue, please use collect-networking-logs.ps1, following the instructions here

Once completed please upload the output files to this Github issue.

Click here for more info on logging
If you choose to email these logs instead of attaching to the bug, please send them to wsl-gh-logs@microsoft.com with the number of the github issue in the subject, and in the message a link to your comment in the github issue and reply with '/emailed-logs'.

[RokeJulianLockhart]

#13166 (comment)

@benhillis, I've already responded to this. We should prevent it repeating that every time I modify the issue's title.

[RokeJulianLockhart]

#13166 (comment)

I've filed #13224 (comment) to remediate the diagnostic script having failed.