Clarify that AppX reparse points do not support listing their targets anymore in v7.2+

[mklement0]

Prerequisites

• Existing Issue: Search the existing issues for this repository. If there is an issue that fits your needs do not file a new one. Subscribe, react, or comment on that issue instead.
• Descriptive Title: Write the title for this issue as a short synopsis. If possible, provide context. For example, "Typo in Get-Foo cmdlet" instead of "Typo."
• Verify Version: If there is a mismatch between documentation and the behavior on your system, ensure that the version you are using is the same as the documentation. Check this box if they match or the issue you are reporting is not version specific.

Links

• https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_FileSystem_Provider?view=powershell-7.4

• https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_FileSystem_Provider?view=powershell-7.3

• https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_FileSystem_Provider?view=powershell-7.2

• https://learn.microsoft.com/en-us/powershell/module/Microsoft.PowerShell.Management/Get-ChildItem?view=powershell-7.4

• https://learn.microsoft.com/en-us/powershell/module/Microsoft.PowerShell.Management/Get-ChildItem?view=powershell-7.3

• https://learn.microsoft.com/en-us/powershell/module/Microsoft.PowerShell.Management/Get-ChildItem?view=powershell-7.2

Summary

Support for determining the targets of AppX reparse points (aka AppExecLinks, such as winget / Microsoft Store-installed applications) was removed in v7.3, and, according to @sdwheeler, back-ported to v7.2

• See APPEXECLINK reparsepoints do not show target and link type PowerShell/PowerShell#19760 (comment) for background information.

Details

The upshot for AppX reparse points in v7.2+ is:

• They no longer print their target after -> in the formatted output.

  • Consider change the formatting for APPEXECLINK reparsepoint to not have the -> part PowerShell/PowerShell#19794 suggests eventually removing -> too.

• Their type-native .LinkTarget property and their ETS .LinkType and .Target properties (an alias of .LinkTarget) are all $null; the type-native .ResolvedTarget property now returns the reparse point's own full path.

• Visually, the l as the first character in the Mode column is now the only indicator that the item is a reparse point.

• To programmatically identify an AppX reparse point now requires:

  • $item.Attributes.HasFlag([System.IO.FileAttributes] 'ReparsePoint') -and $null -eq $item.LinkType
  • If the ETS properties are present, more simply:
    • $item.Mode -like 'l*' -and $null -eq $item.LinkType

Suggested Fix

It's probably worth mentioning at least a condensed version of the above in the linked topics.

[sdwheeler]

This also affects 7.2.11. The change was backported to 7.2 at some point.

[sdwheeler]

To programmatically identify an AppX reparse point now requires:

I talked with @SteveL-MSFT about getting the .LinkType member populated.