Get-ChildItem

Syntax

Get-ChildItem <string>] <string>] >] >] >] 

Get-ChildItem <string>] -LiteralPath <string> >] >] >] 

Beschreibung

Das Cmdlet Get-ChildItem ruft die Elemente an einem oder mehreren angegebenen Speicherorten ab. Wenn es sich bei dem Element um einen Container handelt, werden die Elemente innerhalb des Containers, die so genannten untergeordneten Elemente, abgerufen. Sie können den Parameter „Recurse“ verwenden, um Elemente in allen untergeordneten Containern abzurufen, und mit dem Parameter „Depth“ die Anzahl der zu durchsuchenden Ebenen begrenzen.

Get-ChildItem zeigt keine leeren Verzeichnisse an. Wenn ein Get-ChildItem-Befehl die ParameterDepth oder Recurse enthält, werden leere Verzeichnisse nicht in die Ausgabe aufgenommen.

Speicherorte werden von PowerShell-Anbietern für Get-ChildItem bereitgestellt. Ein Speicherort kann ein Dateisystemverzeichnis, ein Registrierungshive oder ein Zertifikatspeicher sein. Weitere Informationen finden Sie unter about_Providers.

Beispiele

Beispiel 1: Abrufen untergeordneter Elemente aus einem Dateisystemverzeichnis

Dieses Beispiel ruft die untergeordneten Elemente aus einem Dateisystemverzeichnis ab. Es werden die Dateinamen und die Namen der Unterverzeichnisse angezeigt. Bei leeren Speicherorten gibt der Befehl keine Ausgabe zurück und kehrt zur PowerShell-Eingabeaufforderung zurück.

Das Cmdlet Get-ChildItem gibt mit dem Path-Parameter das Verzeichnis C:\Test an.Get-ChildItem zeigt die Dateien und Verzeichnisse in der PowerShell-Konsole an.

Get-ChildItem -Path C:\TestDirectory: C:\TestMode LastWriteTime Length Name---- ------------- ------ ----d----- 2/15/2019 08:29 Logs-a---- 2/13/2019 08:55 26 anotherfile.txt-a---- 2/12/2019 15:40 118014 Command.txt-a---- 2/1/2019 08:43 183 CreateTestFile.ps1-ar--- 2/12/2019 14:31 27 ReadOnlyFile.txt

Standardmäßig listet Get-ChildItem den Modus (Attribute), die LastWriteTime, die Dateigröße (Länge) und den Namen des Elements auf. Die Buchstaben in der Eigenschaft Modus können wie folgt interpretiert werden:

• l (Link)
• d (Verzeichnis)
• a (Archiv)
• r (schreibgeschützt)
• h (versteckt)
• s (System).

Weitere Informationen zu den Modusflags finden Sie unterabout_Filesystem_Provider.

Beispiel 2: Abrufen von Namen untergeordneter Elemente in einem Verzeichnis

In diesem Beispiel werden nur die Namen von Elementen in einem Verzeichnis aufgelistet.

Das Cmdlet Get-ChildItem gibt mit dem Path-Parameter das Verzeichnis C:\Test an. DerName -Parameter gibt nur die Datei- oder Verzeichnisnamen aus dem angegebenen Pfad zurück.

Get-ChildItem -Path C:\Test -NameLogsanotherfile.txtCommand.txtCreateTestFile.ps1ReadOnlyFile.txt

Beispiel 3: Abrufen untergeordneter Elemente im aktuellen Verzeichnis und in Unterverzeichnissen

In diesem Beispiel werden .txt-Dateien angezeigt, die sich im aktuellen Verzeichnis und in dessen Unterverzeichnissen befinden.

Get-ChildItem -Path C:\Test\*.txt -Recurse -ForceDirectory: C:\Test\Logs\AdirectoryMode LastWriteTime Length Name---- ------------- ------ -----a---- 2/12/2019 16:16 20 Afile4.txt-a-h-- 2/12/2019 15:52 22 hiddenfile.txt-a---- 2/13/2019 13:26 20 LogFile4.txt Directory: C:\Test\Logs\BackupMode LastWriteTime Length Name---- ------------- ------ -----a---- 2/12/2019 16:16 20 ATextFile.txt-a---- 2/12/2019 15:50 20 LogFile3.txt Directory: C:\Test\LogsMode LastWriteTime Length Name---- ------------- ------ -----a---- 2/12/2019 16:16 20 Afile.txt-a-h-- 2/12/2019 15:52 22 hiddenfile.txt-a---- 2/13/2019 13:26 20 LogFile1.txt Directory: C:\TestMode LastWriteTime Length Name---- ------------- ------ -----a---- 2/13/2019 08:55 26 anotherfile.txt-a---- 2/12/2019 15:40 118014 Command.txt-a-h-- 2/12/2019 15:52 22 hiddenfile.txt-ar--- 2/12/2019 14:31 27 ReadOnlyFile.txt

Das Cmdlet Get-ChildItem gibt mit dem Path-Parameter C:\Test\*.txt an. Path verwendet den Platzhalterasterisk (*), um alle Dateien mit der Dateinamenerweiterung .txt anzugeben. Der Recurse-Parameter durchsucht das Verzeichnis Path und seine Unterverzeichnisse, wie in den Überschriften Directory:angegeben. Mit dem Force-Parameter werden ausgeblendete Dateien wie hiddenfile.txt mit einem Modus von h angezeigt.

Beispiel 4: Abrufen von untergeordneten Elementen mit dem Include-Parameter

In diesem Beispiel verwendet Get-ChildItem den Include-Parameter, um bestimmte Elemente aus dem durch den Path-Parameter angegebenen Verzeichnis zu suchen.

# When using the -Include parameter, if you don't include an asterisk in the path# the command returns no output.Get-ChildItem -Path C:\Test\ -Include *.txtGet-ChildItem -Path C:\Test\* -Include *.txtDirectory: C:\TestMode LastWriteTime Length Name---- ------------- ------ -----a---- 2/13/2019 08:55 26 anotherfile.txt-a---- 2/12/2019 15:40 118014 Command.txt-ar--- 2/12/2019 14:31 27 ReadOnlyFile.txt

Das Cmdlet Get-ChildItem verwendet den Path-Parameter, um das Verzeichnis C:\Test anzugeben. DerPath -Parameter enthält einen nachgestellten Sternchenplatzhalter (*), um den Inhalt des Verzeichnisses anzugeben.Der Include -Parameter verwendet einen Sternchenplatzhalter (*), um alle Dateien mit der Dateinamenerweiterung .txt anzugeben.

Wenn der Include -Parameter verwendet wird, benötigt der Path -Parameter einen nachgestellten Sternchenplatzhalter (*), um den Inhalt des Verzeichnisses anzugeben. Beispiel: -Path C:\Test\*.

• Wenn der Recurse-Parameter zum Befehl hinzugefügt wird, ist das nachgestellte Sternchen (*) im Path-Parameter optional. Der Recurse-Parameter ruft Elemente aus dem Verzeichnis Path und seinen Unterverzeichnissen ab. Beispiel: -Path C:\Test\ -Recurse -Include *.txt
• Wenn im Path-Parameter kein Sternchen am Ende (*) enthalten ist, gibt der Befehl keine Ausgabe zurück und kehrt zur PowerShell-Eingabeaufforderung zurück. Beispiel: -Path C:\Test\.

Beispiel 5: Abrufen untergeordneter Elemente mit dem Exclude-Parameter

Die Ausgabe des Beispiels zeigt den Inhalt des Verzeichnisses C:\Test\Logs. Die Ausgabe dient als Referenz für die anderen Befehle, die die Parameter „Exclude“ und „Recurse“ verwenden.

Get-ChildItem -Path C:\Test\LogsDirectory: C:\Test\LogsMode LastWriteTime Length Name---- ------------- ------ ----d----- 2/15/2019 13:21 Adirectoryd----- 2/15/2019 08:28 AnEmptyDirectoryd----- 2/15/2019 13:21 Backup-a---- 2/12/2019 16:16 20 Afile.txt-a---- 2/13/2019 13:26 20 LogFile1.txt-a---- 2/12/2019 16:24 23 systemlog1.logGet-ChildItem -Path C:\Test\Logs\* -Exclude A*Directory: C:\Test\LogsMode LastWriteTime Length Name---- ------------- ------ ----d----- 2/15/2019 13:21 Backup-a---- 2/13/2019 13:26 20 LogFile1.txt-a---- 2/12/2019 16:24 23 systemlog1.log

Das Cmdlet Get-ChildItem gibt mit dem Path-Parameter das Verzeichnis C:\Test\Logs an.

Der Exclude-Parameter verwendet den Platzhalter Sternchen (*), um anzugeben, dass alle Dateien oder Verzeichnisse, die mit A oder a beginnen, von der Ausgabe ausgeschlossen werden.

Wenn der Exclude-Parameter verwendet wird, ist ein Sternchen am Ende (*) im Path-Parameter optional. Beispiel: -Path C:\Test\Logs oder -Path C:\Test\Logs\*.

• Wenn kein Sternchen (*) im Path-Parameter enthalten ist, wird der Inhalt des Path-Parameters angezeigt. Die Ausnahmen sind Dateinamen oder Unterverzeichnisnamen, die mit dem Wert desExclude -Parameters übereinstimmen.
• Wenn ein nachgestellter Stern (*) im Path -Parameter enthalten ist, wird der Befehl in die Unterverzeichnisse desPath -Parameters zurückverfolgt. Die Ausnahmen sind Dateinamen oder Unterverzeichnisnamen, die mit dem Wert des Parameters Exclude übereinstimmen.
• Wenn der Recurse-Parameter zum Befehl hinzugefügt wird, ist die Rekursionsausgabe dieselbe, unabhängig davon, ob der Path-Parameter ein nachgestelltes Sternchen (*) enthält oder nicht.

Beispiel 6: Abrufen der Registrierungsschlüssel aus einem Registrierungshive

In diesem Beispiel werden alle Registrierungsschlüssel aus HKEY_LOCAL_MACHINE\HARDWARE abgerufen.

Get-ChildItemverwendet den Path-Parameter, um den Registrierungsschlüssel HKLM:\HARDWARE anzugeben. Der Pfad des Hive und die oberste Ebene der Registrierungsschlüssel werden in der PowerShell-Konsole angezeigt.

Weitere Informationen finden Sie unter about_Registry_Provider.

Get-ChildItem -Path HKLM:\HARDWAREHive: HKEY_LOCAL_MACHINE\HARDWAREName Property---- --------ACPIDESCRIPTIONDEVICEMAPRESOURCEMAPUEFIGet-ChildItem -Path HKLM:\HARDWARE -Exclude D*Hive: HKEY_LOCAL_MACHINE\HARDWAREName Property---- --------ACPIRESOURCEMAP

Der erste Befehl zeigt den Inhalt des Registrierungsschlüssels HKLM:\HARDWARE an. Der Exclude-Parameter besagt, dass Get-ChildItem keine Unterschlüssel zurückgeben soll, die mit D* beginnen. Derzeit funktioniert der Exclude-Parameter nur für Unterschlüssel, nicht für Elementeigenschaften.

Beispiel 7: Abrufen aller Zertifikate mit Codesignaturberechtigung

In diesem Beispiel werden alle Zertifikate im PowerShell-Laufwerk „Cert:“ abgerufen, die über eine Codesignaturberechtigung verfügen.

Das Cmdlet Get-ChildItem verwendet den Path-Parameter, um den Cert:-Anbieter anzugeben. DerRecurse -Parameter durchsucht das durch Path angegebene Verzeichnis und seine Unterverzeichnisse. Mit dem ParameterCodeSigningCert werden nur Zertifikate abgerufen, die über eine Codesignaturberechtigung verfügen.

Get-ChildItem -Path Cert:\* -Recurse -CodeSigningCert

Weitere Informationen über den Zertifikatsanbieter und das Laufwerk Cert: finden Sie unter about_Certificate_Provider.

Beispiel 8: Abrufen von Elementen mit dem Depth-Parameter

In diesem Beispiel werden die Elemente in einem Verzeichnis und dessen Unterverzeichnissen angezeigt. Der Depth-Parameter legt die Anzahl der Unterverzeichnisebenen fest, die in die Rekursion einbezogen werden sollen. Leere Verzeichnisse werden von der Ausgabe ausgeschlossen.

Get-ChildItem -Path C:\Parent -Depth 2Directory: C:\ParentMode LastWriteTime Length Name---- ------------- ------ ----d----- 2/14/2019 10:24 SubDir_Level1-a---- 2/13/2019 08:55 26 file.txt Directory: C:\Parent\SubDir_Level1Mode LastWriteTime Length Name---- ------------- ------ ----d----- 2/14/2019 10:24 SubDir_Level2-a---- 2/13/2019 08:55 26 file.txt Directory: C:\Parent\SubDir_Level1\SubDir_Level2Mode LastWriteTime Length Name---- ------------- ------ ----d----- 2/14/2019 10:22 SubDir_Level3-a---- 2/13/2019 08:55 26 file.txt

Das Cmdlet Get-ChildItem verwendet den Path-Parameter, um C:\Parent anzugeben. Der Depth-Parameter gibt zwei Rekursionsebenen an. Get-ChildItem zeigt den Inhalt des durch den Path-Parameter angegebenen Verzeichnisses und der zwei Ebenen von Unterverzeichnissen an.

Beispiel 9: Abrufen von Hardlink-Informationen

In PowerShell 6.2 wurde eine alternative Ansicht hinzugefügt, um Hardlink-Informationen abzurufen.

Get-ChildItem -Path C:\PathContainingHardLink | Format-Table -View childrenWithHardLink

Beispiel 10: Ausgabe für Nicht-Windows-Betriebssysteme

In PowerShell 7.1 auf Unix-Systemen bietet die Get-ChildItem eine Unix-ähnliche Ausgabe:

PS> Get-ChildItem /etc/r*Directory: /etcUnixMode User Group LastWriteTime Size Name-------- ---- ----- ------------- ---- ----drwxr-xr-x root wheel 9/30/2019 19:19 128 racoon-rw-r--r-- root wheel 9/26/2019 18:20 1560 rc.common-rw-r--r-- root wheel 7/31/2017 17:30 1560 rc.common~previous-rw-r--r-- root wheel 9/27/2019 20:34 5264 rc.netbootlrwxr-xr-x root wheel 11/8/2019 15:35 22 resolv.conf -> /private/var/run/resolv.conf-rw-r--r-- root wheel 10/23/2019 17:41 0 rmtab-rw-r--r-- root wheel 10/23/2019 17:41 1735 rpc-rw-r--r-- root wheel 7/25/2017 18:37 1735 rpc~previous-rw-r--r-- root wheel 10/23/2019 18:42 891 rtadvd.conf-rw-r--r-- root wheel 8/24/2017 21:54 891 rtadvd.conf~previous

Die neuen Eigenschaften, die jetzt Teil der Ausgabe sind, sind:

• UnixMode ist die Dateiberechtigung, wie sie auf einem Unix-System dargestellt wird
• User ist der Dateibesitzer
• Group ist der Gruppeneigentümer
• Size ist die Größe der Datei oder des Verzeichnisses, wie sie auf einem Unix-System dargestellt wird

Parameter

Inputs

String

Sie können einen String über die Pipeline leiten, der einen Pfad zu Get-ChildItem enthält.

Ausgaben

Objekt

Der Typ des Objekts, das Get-ChildItem zurückgibt, wird durch die Objekte im Anbieter-Laufwerkspfad bestimmt.

String

Wenn Sie den Parameter Name verwenden, gibt Get-ChildItem die Objektnamen als Zeichenketten zurück.

Hinweise

• Get-ChildItem kann mit einem der integrierten Aliase ls, dir und gci ausgeführt werden. Weitere Informationen finden Sie unter about_Aliases.
• Get-ChildItem erhält standardmäßig keine versteckten Elemente. Um ausgeblendete Elemente abzurufen, verwenden Sie den Forceparameter.
• Das Cmdlet Get-ChildItem ist so konzipiert, dass es mit den von jedem Anbieter bereitgestellten Daten arbeitet. Geben Sie Get-PSProvider ein, um die in Ihrer Sitzung verfügbaren Anbieter aufzulisten. Weitere Informationen finden Sie unter about_Providers.

• über_Zertifikat_Provider
• über_Provider
• über_Quoting_Rules
• über_Registry_Provider
• FürJedes-Objekt
• Get-Alias
• Get-Item
• Get-Location
• Get-Process
• Get-PSProvider
• Split-Path