Get-ChildItem
Ruft die Elemente und untergeordneten Elemente an angegebenen Speicherorten ab.
Syntax
Get-ChildItem
[[-Path] <string[]>]
[[-Filter] <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Recurse]
[-Depth <uint32>]
[-Force]
[-Name]
[-Attributes <FlagsExpression[FileAttributes]>]
[-FollowSymlink]
[-Directory]
[-File]
[-Hidden]
[-ReadOnly]
[-System]
[<CommonParameters>]
Get-ChildItem
[[-Filter] <string>]
-LiteralPath <string[]>
[-Include <string[]>]
[-Exclude <string[]>]
[-Recurse]
[-Depth <uint32>]
[-Force]
[-Name]
[-Attributes <FlagsExpression[FileAttributes]>]
[-FollowSymlink]
[-Directory]
[-File]
[-Hidden]
[-ReadOnly]
[-System]
[<CommonParameters>]
Beschreibung
Das Get-ChildItem
Cmdlet ruft die Elemente an einem oder mehreren angegebenen Speicherorten ab. Wenn es sich bei dem Element um einen Container handelt, werden die darin enthaltenen (untergeordneten) Elemente abgerufen. Sie können den Recurse-Parameter verwenden, um Elemente in allen untergeordneten Containern abzurufen, und den Depth-Parameter verwenden, um die Anzahl der zu rekursierenden Ebenen zu begrenzen.
Get-ChildItem
zeigt keine leeren Verzeichnisse an. Wenn ein Get-ChildItem
Befehl die Parameter Depth oder Recurse enthält, sind leere Verzeichnisse nicht in der Ausgabe enthalten.
Speicherorte werden von PowerShell-Anbietern verfügbar gemacht Get-ChildItem
. Ein Speicherort kann ein Dateisystemverzeichnis, eine Registrierungsstruktur oder ein Zertifikatspeicher sein. Weitere Informationen finden Sie unter about_Providers.
Beispiele
Beispiel 1: Abrufen untergeordneter Elemente aus einem Dateisystemverzeichnis
In diesem Beispiel werden die untergeordneten Elemente aus einem Dateisystemverzeichnis abgerufen. Die Dateinamen und Unterverzeichnisnamen werden angezeigt. Bei leeren Speicherorten gibt der Befehl keine Ausgabe zurück und kehrt an die PowerShell-Eingabeaufforderung zurück.
Das Get-ChildItem
Cmdlet verwendet den Path-Parameter , um das Verzeichnis C:\Test
anzugeben.
Get-ChildItem
zeigt die Dateien und Verzeichnisse in der PowerShell-Konsole an.
Get-ChildItem -Path C:\Test
Directory: C:\Test
Mode 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 Get-ChildItem
werden der Modus (Attribute), LastWriteTime, die Dateigröße (Länge) und der Name des Elements aufgelistet. Die Buchstaben in der Mode-Eigenschaft können wie folgt interpretiert werden:
l
(Link)d
(Verzeichnis)a
(Archiv)r
(schreibgeschützt)h
(ausgeblendet)s
(System).
Weitere Informationen zu den Modusflags finden Sie unter about_Filesystem_Provider.
Beispiel 2: Abrufen untergeordneter Elementnamen in einem Verzeichnis
In diesem Beispiel werden nur die Namen von Elementen in einem Verzeichnis aufgelistet.
Das Get-ChildItem
Cmdlet verwendet den Path-Parameter , um das Verzeichnis C:\Test
anzugeben. Der Parameter Name gibt nur die Datei- oder Verzeichnisnamen aus dem angegebenen Pfad zurück.
Get-ChildItem -Path C:\Test -Name
Logs
anotherfile.txt
Command.txt
CreateTestFile.ps1
ReadOnlyFile.txt
Beispiel 3: Abrufen untergeordneter Elemente im aktuellen Verzeichnis und unterverzeichnissen
In diesem Beispiel werden .txt Dateien angezeigt, die sich im aktuellen Verzeichnis und den zugehörigen Unterverzeichnissen befinden.
Get-ChildItem -Path C:\Test\*.txt -Recurse -Force
Directory: C:\Test\Logs\Adirectory
Mode 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\Backup
Mode LastWriteTime Length Name
---- ------------- ------ ----
-a---- 2/12/2019 16:16 20 ATextFile.txt
-a---- 2/12/2019 15:50 20 LogFile3.txt
Directory: C:\Test\Logs
Mode 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:\Test
Mode 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 Get-ChildItem
Cmdlet verwendet den Path-Parameter , um anzugeben C:\Test\*.txt
. Path verwendet das Sternchen (*
) platzhalter, um alle Dateien mit der Dateinamenerweiterung .txt
anzugeben. Der Recurse-Parameter durchsucht das Path-Verzeichnis in seinen Unterverzeichnissen, wie in den Überschriften Verzeichnis: gezeigt. Der Force-Parameter zeigt ausgeblendete Dateien an, z hiddenfile.txt
. B. mit dem Modus h.
Beispiel 4: Abrufen untergeordneter Elemente mithilfe des Include-Parameters
In diesem Beispiel Get-ChildItem
wird der Include-Parameter verwendet, 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 *.txt
Get-ChildItem -Path C:\Test\* -Include *.txt
Directory: C:\Test
Mode 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 Get-ChildItem
Cmdlet verwendet den Path-Parameter , um das Verzeichnis C:\Test anzugeben. Der Path-Parameter enthält ein nachgestelltes Sternchen (*
) als Platzhalter, um den Inhalt des Verzeichnisses anzugeben.
Der Include-Parameter verwendet ein Sternchen (*
), um alle Dateien mit der Dateinamenerweiterung .txtanzugeben.
Wenn der Include-Parameter verwendet wird, benötigt der Path-Parameter ein nachgestelltes Sternchen (*
) als Platzhalter, um den Inhalt des Verzeichnisses anzugeben. Beispiel: -Path C:\Test\*
.
- Wenn der Recurse-Parameter dem Befehl hinzugefügt wird, ist das nachfolgende Sternchen (
*
) im Path-Parameter optional. Der Recurse-Parameter ruft Elemente aus dem Verzeichnis Path und seinen Unterverzeichnissen ab. Zum Beispiel,-Path C:\Test\ -Recurse -Include *.txt
- Wenn ein nachfolgendes Sternchen (
*
) nicht im Path-Parameter 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 mithilfe des Exclude-Parameters
Die Ausgabe des Beispiels zeigt den Inhalt des Verzeichnisses C:\Test\Logs. Die Ausgabe ist ein Verweis auf die anderen Befehle, die die Parameter Exclude und Recurse verwenden.
Get-ChildItem -Path C:\Test\Logs
Directory: C:\Test\Logs
Mode LastWriteTime Length Name
---- ------------- ------ ----
d----- 2/15/2019 13:21 Adirectory
d----- 2/15/2019 08:28 AnEmptyDirectory
d----- 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.log
Get-ChildItem -Path C:\Test\Logs\* -Exclude A*
Directory: C:\Test\Logs
Mode 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 Get-ChildItem
Cmdlet verwendet den Path-Parameter , um das Verzeichnis C:\Test\Logs
anzugeben.
Der Exclude-Parameter verwendet das Sternchen (*
), um alle Dateien oder Verzeichnisse anzugeben, die mit A beginnen oder von der Ausgabe ausgeschlossen werden.
Wenn der Exclude-Parameter verwendet wird, ist ein nachfolgendes Sternchen (*
) im Path-Parameter optional. Zum Beispiel: -Path C:\Test\Logs
oder -Path C:\Test\Logs\*
.
- Wenn ein nachfolgendes Sternchen (
*
) nicht im Path-Parameter enthalten ist, wird der Inhalt des Path-Parameters angezeigt. Die Ausnahmen sind Dateinamen oder Unterverzeichnisnamen, die dem Wert des Exclude-Parameters entsprechen. - Wenn ein nachfolgendes Sternchen (
*
) im Path-Parameter enthalten ist, wird der Befehl in die Unterverzeichnisse des Path-Parameters eingefügt. Die Ausnahmen sind Dateinamen oder Unterverzeichnisnamen, die dem Wert des Exclude-Parameters entsprechen. - Wenn der Recurse-Parameter dem Befehl hinzugefügt wird, ist die Rekursionsausgabe identisch, unabhängig davon, ob der Path-Parameter ein nachfolgendes Sternchen (
*
) enthält oder nicht.
Beispiel 6: Abrufen der Registrierungsschlüssel aus einer Registrierungsstruktur
In diesem Beispiel werden alle Registrierungsschlüssel von abgerufen HKEY_LOCAL_MACHINE\HARDWARE
.
Get-ChildItem
verwendet den Path-Parameter , um den Registrierungsschlüssel HKLM:\HARDWARE
anzugeben. Der Pfad der Struktur 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:\HARDWARE
Hive: HKEY_LOCAL_MACHINE\HARDWARE
Name Property
---- --------
ACPI
DESCRIPTION
DEVICEMAP
RESOURCEMAP
UEFI
Get-ChildItem -Path HKLM:\HARDWARE -Exclude D*
Hive: HKEY_LOCAL_MACHINE\HARDWARE
Name Property
---- --------
ACPI
RESOURCEMAP
Der erste Befehl zeigt den Inhalt des HKLM:\HARDWARE
Registrierungsschlüssels an. Der Exclude-Parameter weist an Get-ChildItem
, keine Unterschlüssel zurückzugeben, die mit D*
beginnen. Derzeit funktioniert der Exclude-Parameter nur für Unterschlüssel, nicht für Elementeigenschaften.
Beispiel 7: Abrufen aller Zertifikate mit Codesignaturautorität
In diesem Beispiel wird jedes Zertifikat im PowerShell-Laufwerk Cert: abgerufen, das über eine Codesignaturautorität verfügt.
Das Get-ChildItem
Cmdlet verwendet den Path-Parameter , um den Anbieter Cert: anzugeben. Der Recurse-Parameter durchsucht das durch Path angegebene Verzeichnis und die zugehörigen Unterverzeichnisse. Der CodeSigningCert-Parameter ruft nur Zertifikate ab, die über eine Codesignaturautorität verfügen.
Get-ChildItem -Path Cert:\* -Recurse -CodeSigningCert
Weitere Informationen zum Zertifikatanbieter und zum Laufwerk Cert: finden Sie unter about_Certificate_Provider.
Beispiel 8: Abrufen von Elementen mithilfe des Depth-Parameters
In diesem Beispiel werden die Elemente in einem Verzeichnis und die zugehörigen Unterverzeichnisse angezeigt. Der Depth-Parameter bestimmt die Anzahl der Unterverzeichnisebenen, die in die Rekursion eingeschlossen werden sollen. Leere Verzeichnisse werden von der Ausgabe ausgeschlossen.
Get-ChildItem -Path C:\Parent -Depth 2
Directory: C:\Parent
Mode LastWriteTime Length Name
---- ------------- ------ ----
d----- 2/14/2019 10:24 SubDir_Level1
-a---- 2/13/2019 08:55 26 file.txt
Directory: C:\Parent\SubDir_Level1
Mode 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_Level2
Mode LastWriteTime Length Name
---- ------------- ------ ----
d----- 2/14/2019 10:22 SubDir_Level3
-a---- 2/13/2019 08:55 26 file.txt
Das Get-ChildItem
Cmdlet verwendet den Path-Parameter , um C:\Parent anzugeben. Der Depth-Parameter gibt zwei Rekursionsstufen an. Get-ChildItem
zeigt den Inhalt des durch den Path-Parameter angegebenen Verzeichnisses und die beiden Unterverzeichnisseebenen 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 stellt die Get-ChildItem
Unix-ähnliche Ausgabe bereit:
PS> Get-ChildItem /etc/r*
Directory: /etc
UnixMode 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.netboot
lrwxr-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.
- Der Benutzer ist der Dateibesitzer.
- Group ist der Gruppenbesitzer.
- Größe ist die Größe der Datei oder des Verzeichnisses, wie sie auf einem Unix-System dargestellt wird.
Hinweis
Dieses Feature wurde von „Experimentell“ in „Mainstream“ in PowerShell 7.1 verschoben.
Beispiel 11: Abrufen des Linkziels für einen Verbindungspunkt
Der dir
Befehl in der Windows-Befehlsshell zeigt den Zielspeicherort eines Dateisystemverbindungspunkts an. In PowerShell sind diese Informationen über die LinkTarget-Eigenschaft des Dateisystemobjekts verfügbar, das von Get-ChildItem
zurückgegeben wird, und wird in der Standardausgabe angezeigt.
PS D:\> New-Item -ItemType Junction -Name tmp -Target $env:TEMP
PS D:\> Get-ChildItem | select name,LinkTarget
Name LinkTarget
---- ----------
tmp C:\Users\user1\AppData\Local\Temp
PS D:\> Get-ChildItem
Directory: D:\
Mode LastWriteTime Length Name
---- ------------- ------ ----
l---- 12/16/2021 9:29 AM tmp -> C:\Users\user1\AppData\Local\Temp
Parameter
-Attributes
Ruft Dateien und Ordner mit den angegebenen Attributen ab. Dieser Parameter unterstützt alle Attribute und Sie können komplexe Kombinationen von Attributen angeben.
Geben Sie z. B. Folgendes ein, um Nicht-Systemdateien (keine Verzeichnisse) zu erhalten, die verschlüsselt oder komprimiert sind:
Get-ChildItem -Attributes !Directory+!System+Encrypted, !Directory+!System+Compressed
Um Dateien und Ordner mit häufig verwendeten Attributen zu suchen, verwenden Sie den Attributes-Parameter . Oder die Parameter Directory, File, Hidden, ReadOnly und System.
Der Attributes-Parameter unterstützt die folgenden Eigenschaften:
- Archivieren
- Compressed
- Device
- Verzeichnis
- Verschlüsselt
- Hidden
- IntegrityStream
- Normal
- NoScrubData
- NotContentIndexed
- Offline
- ReadOnly
- ReparsePoint
- SparseFile
- System
- Temporär
Eine Beschreibung dieser Attribute finden Sie unter FileAttributes-Enumeration.
Verwenden Sie die folgenden Operatoren, um Attribute zu kombinieren:
!
(NICHT)+
(AND),
(ODER)
Verwenden Sie keine Leerzeichen zwischen einem Operator und seinem Attribut. Leerzeichen werden nach Kommas akzeptiert.
Verwenden Sie für allgemeine Attribute die folgenden Abkürzungen:
D
(Verzeichnis)H
(Ausgeblendet)R
(Schreibgeschützt)S
(System)
Type: | FlagsExpression<T>[FileAttributes] |
Accepted values: | Archive, Compressed, Device, Directory, Encrypted, Hidden, IntegrityStream, Normal, NoScrubData, NotContentIndexed, Offline, ReadOnly, ReparsePoint, SparseFile, System, Temporary |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Depth
Dieser Parameter wurde in PowerShell 5.0 hinzugefügt und ermöglicht es Ihnen, die Tiefe der Rekursion zu steuern. Standardmäßig Get-ChildItem
wird der Inhalt des übergeordneten Verzeichnisses angezeigt. Der Parameter Depth bestimmt die Anzahl von Unterverzeichnisebenen, die in der Rekursion enthalten sind, und zeigt den Inhalt an.
Enthält beispielsweise Depth 2
das Verzeichnis des Path-Parameters , die erste Ebene von Unterverzeichnissen und die zweite Ebene von Unterverzeichnissen. Standardmäßig sind Verzeichnisnamen und Dateinamen in der Ausgabe enthalten.
Hinweis
Auf einem Windows-Computer aus PowerShell oder cmd.exekönnen Sie mit dem Befehl tree.com eine grafische Ansicht einer Verzeichnisstruktur anzeigen.
Type: | UInt32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Directory
Verwenden Sie zum Abrufen einer Liste von Verzeichnissen den Directory-Parameter oder den Attributes-Parameter mit der Directory-Eigenschaft . Sie können den Recurse-Parameter mit Directory verwenden.
Type: | SwitchParameter |
Aliases: | ad, d |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Exclude
Gibt ein Array von mindestens einem Zeichenfolgenmuster an, das abgeglichen werden soll, wenn das Cmdlet untergeordnete Elemente abruft. Alle übereinstimmenden Elemente werden von der Ausgabe ausgeschlossen. Geben Sie ein Path-Element oder -Muster ein, z *.txt
. B. oder A*
.
Platzhalterzeichen werden akzeptiert.
Ein nachfolgendes Sternchen (*
) im Path-Parameter ist optional. Zum Beispiel: -Path C:\Test\Logs
oder -Path C:\Test\Logs\*
. Wenn ein nachfolgendes Sternchen (*
) enthalten ist, wird der Befehl in die Unterverzeichnisse des Path-Parameters eingefügt. Ohne das Sternchen (*
) werden die Inhalte des Path-Parameters angezeigt. Weitere Details finden Sie in Beispiel 5 und im Abschnitt Notizen.
Die Parameter Include und Exclude können zusammen verwendet werden. Die Ausschlüsse werden jedoch nach den Einschlüssen angewendet, was sich auf die endgültige Ausgabe auswirken kann.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-File
Verwenden Sie den File-Parameter , um eine Liste von Dateien abzurufen. Sie können den Recurse-Parameter mit File verwenden.
Type: | SwitchParameter |
Aliases: | af |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Filter
Gibt einen Filter an, um den Path-Parameter zu qualifizieren. Der FileSystem-Anbieter ist der einzige installierte PowerShell-Anbieter, der Filter unterstützt. Filter sind effizienter als andere Parameter. Der Anbieter wendet filter an, wenn das Cmdlet die Objekte abruft, anstatt die Objekte nach dem Abrufen von PowerShell filtern zu lassen. Die Filterzeichenfolge wird an die .NET-API übergeben, um Dateien aufzulisten. Die API unterstützt *
nur und ?
Wildcards.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-FollowSymlink
Standardmäßig zeigt das Get-ChildItem
Cmdlet symbolische Links zu Verzeichnissen an, die während der Rekursion gefunden wurden, aber nicht rekursiert. Verwenden Sie den Parameter FollowSymlink , um die Verzeichnisse zu durchsuchen, die auf diese symbolischen Links abzielen. FollowSymlink ist ein dynamischer Parameter und wird nur im FileSystem-Anbieter unterstützt.
Dieser Parameter wurde in PowerShell 6.0 eingeführt.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Ermöglicht dem Cmdlet das Abrufen von Elementen, auf die der Benutzer andernfalls nicht zugreifen kann, z. B. ausgeblendete Dateien oder Systemdateien. Der Force-Parameter überschreibt keine Sicherheitseinschränkungen. Die Implementierung unterscheidet sich bei den einzelnen Anbietern. Weitere Informationen finden Sie unter about_Providers.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Hidden
Um nur ausgeblendete Elemente abzurufen, verwenden Sie den Hidden-Parameter oder den Attributes-Parameter mit der Hidden-Eigenschaft . Standardmäßig Get-ChildItem
werden keine ausgeblendeten Elemente angezeigt. Verwenden Sie den Force-Parameter , um ausgeblendete Elemente abzurufen.
Type: | SwitchParameter |
Aliases: | ah, h |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Include
Gibt ein Array von mindestens einem Zeichenfolgenmuster an, das abgeglichen werden soll, wenn das Cmdlet untergeordnete Elemente abruft. Alle übereinstimmenden Elemente sind in der Ausgabe enthalten. Geben Sie ein Path-Element oder -Muster ein, z "*.txt"
. B. .
Platzhalterzeichen sind zulässig. Der Include-Parameter ist nur wirksam, wenn der Befehl den Inhalt eines Elements enthält, z C:\Windows\*
. B. , wobei das Wildcardzeichen den Inhalt des C:\Windows
Verzeichnisses angibt.
Die Parameter Include und Exclude können zusammen verwendet werden. Die Ausschlüsse werden jedoch nach den Einschlüssen angewendet, was sich auf die endgültige Ausgabe auswirken kann.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-LiteralPath
Gibt einen Pfad zu einem oder mehreren Speicherorten an. Der Wert von LiteralPath wird genau so verwendet, wie er eingegeben wird. Es werden keine Zeichen als Platzhalter interpretiert. Wenn der Pfad Escapezeichen enthält, müssen Sie ihn in einfache Anführungszeichen einschließen. Einfache Anführungszeichen weisen PowerShell an, keine Zeichen als Escapesequenzen zu interpretieren.
Weitere Informationen finden Sie unter about_Quoting_Rules.
Type: | String[] |
Aliases: | PSPath, LP |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Ruft nur die Namen der Elemente am Speicherort ab. Die Ausgabe ist ein Zeichenfolgenobjekt, das über die Pipeline an andere Befehle gesendet werden kann. Platzhalter sind zulässig.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Path
Gibt einen Pfad zu einem oder mehreren Speicherorten an. Wildcards werden akzeptiert. Der Standardspeicherort ist das aktuelle Verzeichnis (.
).
Type: | String[] |
Position: | 0 |
Default value: | Current directory |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-ReadOnly
Um nur schreibgeschützte Elemente abzurufen, verwenden Sie den ReadOnly-Parameter oder die Attribute-Parameter-Eigenschaft ReadOnly.
Type: | SwitchParameter |
Aliases: | ar |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Recurse
Ruft die Elemente an den angegebenen Speicherorten und alle untergeordneten Elemente der Speicherorte ab.
Type: | SwitchParameter |
Aliases: | s |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-System
Ruft nur Systemdateien und Verzeichnisse ab. Um nur Systemdateien und -ordner abzurufen, verwenden Sie die System-Parameter- oder Attributes-Parameter-Systemeigenschaft.
Type: | SwitchParameter |
Aliases: | as |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Eingaben
Sie können eine Zeichenfolge, die einen Pfad enthält, an übergeben Get-ChildItem
.
Ausgaben
Der Typ des zurückgegebenen Get-ChildItem
Objekts wird durch die Objekte im Anbieterlaufwerkpfad bestimmt.
Wenn Sie den Parameter Name verwenden, Get-ChildItem
gibt die Objektnamen als Zeichenfolgen zurück.
Hinweise
Get-ChildItem
kann mit einem der integrierten Aliase ,ls
dir
undgci
ausgeführt werden. Weitere Informationen finden Sie unter about_Aliases.Get-ChildItem
ruft standardmäßig keine ausgeblendeten Elemente ab. Wenn Sie ausgeblendete Elemente abrufen möchten, verwenden Sie den Force-Parameter.- Das
Get-ChildItem
Cmdlet ist für die Arbeit mit den Daten konzipiert, die von einem beliebigen Anbieter verfügbar gemacht werden. Um die in Ihrer Sitzung verfügbaren Anbieter aufzulisten, geben Sie einGet-PSProvider
. Weitere Informationen finden Sie unter about_Providers.