Get-ChildItem IncludeRoot Parameter

Offen

#244 erstellt am 23.3.2020 2 Kommentare 3 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

Bewertung

Schwierigkeit: 5/5
Geschätzter Aufwand: Über eine Woche
Anfängerfreundlichkeit: 35/100

Issue-Typ: Feature
Klarheit: Größtenteils klar
Aktivitätsstatus: Veraltet
Tech-Stack: powershell
Bereich: cli

Rechercherichtung

Beginne mit dem RFC-Text und den verknüpften Beispielen, um den angeforderten Get-ChildItem-Workflow zu verstehen. Überprüfe das aktuelle Verhalten von -Recurse sowie den vorgeschlagenen Parameter IncludeRoot und die Ausgabe. Erledigt bedeutet, dass der Parameter, das Anwendungsbeispiel, die Ausgabe und die Designüberlegungen des RFC ausreichend geklärt sind, um mit der Implementierung zu beginnen.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

RFC:
Author: John Bevan
Status: Draft
SupercededBy:
Version:
Area: Standard Functions
Comments Due:
Plan to implement:

Get-ChildItem; Add IncludeRoot Switch

Suggestion: Currently if you wish to fetch an item and its children you have to make a call to Get-Item and Get-ChildItem. Since this is a common use case, it would be good to reduce this to a single call. By adding an IncludeRoot switch to Get-ChildItem we could easily have it fulfill this requirement.

Here are some examples of people who've hit this scenario & tried to get creative in resolving it.

Motivation

As a PowerShell user,
I can retrieve an item and its children,
so that I have the full tree returned in a single result set.

User Experience

Example of user experience with example code/script.
Include example of input and output.

Get-ChildItem -Path 'c:\demo' -IncludeRoot -Recurse | Select-Object -ExpandProperty FullName

c:\demo
c:\demo\subfolder
c:\demo\subfolder\one.txt
c:\demo\subfolder\two.txt

Specification

Include [Parameter()][Switch]$IncludeRoot in the list of available parameters.

Alternate Proposals and Considerations

The current workaround is to make separate calls to Get-Item and Get-ChildItem.

Vorherrschende Sprache: PowerShell
Sterne: 468
Forks: 143
Ø Merge: 9 Min.
Gemergte PRs (30 T.): 1

Beitragsleitfaden

Beitragsleitfaden öffnen

Erste Schritte

Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
Forken Sie das Repository und arbeiten Sie in einem Branch.
Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus PowerShell/PowerShell-RFC

Update template Plan to implement to allow additional option Offen

Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 68/100

PowerShell/PowerShell-RFC#404 · 1 Kommentar · Erstellt am 07.12.2025
PowerShell Community Dashboard: No Data After October 2024 Offen

PowerShell/PowerShell-RFC#407 · 1 Kommentar · 1 zugewiesene Person · Erstellt am 13.2.2026
Handling enums as cmdlet parameters. Offen

Schwierigkeit 4/5 3-5 Tage Anfängerfreundlichkeit 35/100

PowerShell/PowerShell-RFC#396 · Erstellt am 28.7.2025
Idea: Is there a need for having ExecutionPolicy for PS7 and WinPS be mirrored? Offen

Schwierigkeit 5/5 Über eine Woche Anfängerfreundlichkeit 20/100

PowerShell/PowerShell-RFC#334 · 2 Reaktionen · Erstellt am 26.9.2022
Idea: Release the SecretManagement and SecretStore modules with PowerShell Offen

Schwierigkeit 5/5 Über eine Woche Anfängerfreundlichkeit 35/100

PowerShell/PowerShell-RFC#327 · 28 Kommentare · 31 Reaktionen · Erstellt am 06.7.2022

Alle Issues in PowerShell/PowerShell-RFC