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 denParameter "Recurse" verwenden, um Elemente in allen untergeordneten Containern abzurufen und den Tiefenparameter zu verwenden, um die Anzahl der Ebenen auf rekursieren zu beschränken.
Get-ChildItem
zeigt keine leeren Verzeichnisse an. Wenn ein Get-ChildItem
Befehl die Parameter " Tiefe " oder " Recurse " enthält, werden leere Verzeichnisse nicht in der Ausgabe enthalten.
Speicherorte werden von PowerShell-Anbietern verfügbar Get-ChildItem
gemacht. 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. Für leere Speicherorte gibt der Befehl keine Ausgabe zurück und gibt an die PowerShell-Eingabeaufforderung zurück.
Das Get-ChildItem
Cmdlet verwendet den Pfadparameter , 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
Enthält standardmäßig Get-ChildItem
den Modus (Attribute), LastWriteTime, Dateigröße (Länge) und den Namen des Elements. 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 Modus-Flags finden Sie unter about_Filesystem_Provider.
Beispiel 2: Abrufen von untergeordneten Elementnamen in einem Verzeichnis
In diesem Beispiel werden nur die Namen von Elementen in einem Verzeichnis aufgelistet.
Das Get-ChildItem
Cmdlet verwendet den Pfadparameter , um das Verzeichnis C:\Test
anzugeben. Der Parameter "Name " gibt nur die Dateinamen 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 ihren 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 (*
)-Wildcard, um alle Dateien mit der Dateinamenerweiterung .txt
anzugeben. Der Recurse-Parameter durchsucht das Pfadverzeichnis seine Unterverzeichnisse, wie im Verzeichnis dargestellt: Überschriften. Der Parameter "Force" zeigt ausgeblendete Dateien an, z hiddenfile.txt
. B. mit einem Modus von h.
Beispiel 4: Abrufen untergeordneter Elemente mithilfe des Include-Parameters
In diesem Beispiel Get-ChildItem
wird der Parameter "Include " verwendet, um bestimmte Elemente aus dem vom Pfadparameter angegebenen Verzeichnis zu finden.
# 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 Pfadparameter , um das Verzeichnis C:\Test anzugeben. Der Parameter "Pfad " enthält ein nachgestelltes Sternchen (*
) zum Angeben des Inhalts des Verzeichnisses.
Der Parameter "Include " verwendet ein Sternchen (*
) zum Angeben aller Dateien mit der Dateinamenerweiterung .txt.
Wenn der Parameter "Include " verwendet wird, benötigt der Path-Parameter einen nachgestellten Stern (*
) zum Angeben des Inhalts des Verzeichnisses. Beispiel: -Path C:\Test\*
.
- Wenn der Parameter "Recurse " dem Befehl hinzugefügt wird, ist das nachgestellte Sternchen (
*
) im Pfadparameter optional. Der Parameter Recurse ruft Elemente aus dem Pfadverzeichnis und seinen Unterverzeichnissen ab. Zum Beispiel,-Path C:\Test\ -Recurse -Include *.txt
- Wenn ein nachgestelltes Sternchen (
*
) nicht im Path-Parameter enthalten ist, gibt der Befehl keine Ausgabe zurück und gibt an die PowerShell-Eingabeaufforderung zurück. Beispiel:-Path C:\Test\
.
Beispiel 5: Abrufen untergeordneter Elemente mithilfe des Parameters "Ausschließen"
Die Ausgabe des Beispiels zeigt den Inhalt des Verzeichnisses C:\Test\Logs. Die Ausgabe ist ein Verweis auf die anderen Befehle, die die Parameter "Ausschließen " 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 Pfadparameter , um das Verzeichnis C:\Test\Logs
anzugeben.
Der Parameter "Ausschließen " verwendet das Sternchen (*
) zum Angeben von Dateien oder Verzeichnissen, die mit A beginnen oder eine aus der Ausgabe ausgeschlossen werden.
Wenn der Parameter "Ausschließen " verwendet wird, ist ein nachgestelltes Sternchen (*
) im Pfadparameter optional. Zum Beispiel: -Path C:\Test\Logs
oder -Path C:\Test\Logs\*
.
- Wenn ein nachgestelltes Sternchen (
*
) nicht im Pfadparameter enthalten ist, werden die Inhalte des Pfadparameters angezeigt. Die Ausnahmen sind Dateinamen oder Unterverzeichnisnamen, die dem Wert des Exclude-Parameters entsprechen. - Wenn ein nachgestelltes Sternchen (
*
) im Path-Parameter enthalten ist, wird der Befehl in die Unterverzeichnisse des Pfadparameters rekursiert. Die Ausnahmen sind Dateinamen oder Unterverzeichnisnamen, die dem Wert des Exclude-Parameters entsprechen. - Wenn der Parameter "Recurse " dem Befehl hinzugefügt wird, ist die Rekursionsausgabe identisch, ob der Parameter "Pfad " ein nachgestelltes Sternchen (
*
) enthält.
Beispiel 6: Abrufen der Registrierungsschlüssel aus einer Registrierungsstruktur
In diesem Beispiel werden alle Registrierungsschlüssel von HKEY_LOCAL_MACHINE\HARDWARE
.
Get-ChildItem
verwendet den Path-Parameter , um den Registrierungsschlüssel HKLM:\HARDWARE
anzugeben. Der Pfad 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 Parameter "Ausschließen " teilt Get-ChildItem
nicht mit D*
, dass Unterschlüssel zurückgegeben werden, die mit . Derzeit funktioniert der Parameter "Ausschließen " nur für Unterschlüssel, nicht für Elementeigenschaften.
Beispiel 7: Abrufen aller Zertifikate mit Codesignaturbehörde
In diesem Beispiel wird jedes Zertifikat im PowerShell-Cert: Laufwerk mit Codesignaturbehörde abrufen.
Das Get-ChildItem
Cmdlet verwendet den Path-Parameter , um den Cert: Provider anzugeben. Der Recurse-Parameter sucht das verzeichnis, das von Pfad und seinen Unterverzeichnissen angegeben wird. Der CodeSigningCert-Parameter ruft nur Zertifikate ab, die über eine Codesignaturbehörde verfügen.
Get-ChildItem -Path Cert:\* -Recurse -CodeSigningCert
Weitere Informationen zum Zertifikatanbieter und dem Cert:-Laufwerk finden Sie unter about_Certificate_Provider.
Beispiel 8: Abrufen von Elementen mithilfe des Tiefenparameters
In diesem Beispiel werden die Elemente in einem Verzeichnis und seinen Unterverzeichnissen angezeigt. Der Tiefenparameter bestimmt die Anzahl der Unterverzeichnisebenen, die in das Rekursion einbezogen werden sollen. Leere Verzeichnisse werden aus 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 Pfadparameter , um C:\Parent anzugeben. Der Tiefenparameter gibt zwei Ebenen der Rekursion an. Get-ChildItem
zeigt den Inhalt des durch den Pfadparameter angegebenen Verzeichnisses und die beiden Unterverzeichnisseebenen an.
Beispiel 9: Abrufen von Linksinformationen
In PowerShell 6.2 wurde eine alternative Ansicht hinzugefügt, um Hartlinkinformationen 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:
- UnixMode ist die Dateiberechtigungen, wie in einem Unix-System dargestellt
- Benutzer ist der Dateibesitzer
- Gruppe ist der Gruppenbesitzer
- Größe ist die Größe der Datei oder des Verzeichnisses, wie in einem Unix-System dargestellt
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 Dateisystemknotens an. In PowerShell ist diese Information aus der LinkTarget-Eigenschaft des von dem Dateisystem zurückgegebenen Get-ChildItem
Dateisystemobjekts verfügbar 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
Verwenden Sie den Parameter Attributes , um Dateien und Ordner mit häufig verwendeten Attributen zu finden. Oder die Parameter Directory, File, Hidden, ReadOnly und System.
Der Parameter Attributes 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 in der FileAttributes-Enumeration.
Verwenden Sie zum Kombinieren von Attributen die folgenden Operatoren:
!
(NICHT)+
(AND),
(OR)
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. Zeigt standardmäßig Get-ChildItem
den Inhalt des übergeordneten Verzeichnisses an. Der Depth-Parameter bestimmt die Anzahl der Unterverzeichnisebenen, die in der Rekursion enthalten sind, und zeigt den Inhalt an.
Enthält beispielsweise Depth 2
das Verzeichnis des Pfadparameters , 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 von PowerShell oder cmd.exekönnen Sie eine grafische Ansicht einer Verzeichnisstruktur mit dem befehl tree.com anzeigen.
Type: | UInt32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Directory
Um eine Liste von Verzeichnissen abzurufen, verwenden Sie den Verzeichnisparameter oder den Attribute-Parameter mit der Directory-Eigenschaft. Sie können den Parameter Recurse 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 eines oder mehrerer Zeichenfolgenmuster an, das abgeglichen werden soll, da das Cmdlet untergeordnete Elemente abruft. Jedes übereinstimmende Element wird von der Ausgabe ausgeschlossen. Geben Sie ein Pfadelement oder -muster ein, z *.txt
. B. oder A*
.
Platzhalterzeichen werden akzeptiert.
Ein nachgestelltes Sternchen (*
) im Path-Parameter ist optional. Zum Beispiel: -Path C:\Test\Logs
oder -Path C:\Test\Logs\*
. Wenn ein nachgestelltes Sternchen (*
) enthalten ist, wird der Befehl in den Unterverzeichnissen des Pfadparameters rekursiert. Ohne sternchen (*
), werden die Inhalte des Path-Parameters angezeigt. Weitere Details sind in Beispiel 5 und im Abschnitt "Notizen" enthalten.
Die Parameter "Einschließen " und "Ausschließen " können zusammen verwendet werden. Die Ausschlüsse werden jedoch nach den Einschlüssen angewendet, die sich auf die endgültige Ausgabe auswirken können.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-File
Verwenden Sie den Parameter "File ", um eine Liste der 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, der den Path-Parameter qualifizieren soll. 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 PowerShell nach dem Abrufen der Objekte zu filtern. Die Filterzeichenfolge wird an die .NET-API übergeben, um Dateien aufzählen zu können. 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 Verknüpfungen zu Verzeichnissen an, die während der Rekursion gefunden werden, aber nicht wieder in sie aufgenommen werden. Verwenden Sie den FollowSymlink-Parameter , um die Verzeichnisse zu durchsuchen, die auf diese symbolischen Links abzielen. Der 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 andernfalls vom Benutzer nicht zugegriffen werden kann, z. B. ausgeblendete oder Systemdateien. Der Parameter Force überschreiben 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 Parameter Hidden oder den Attribute-Parameter mit der Hidden-Eigenschaft. Standardmäßig Get-ChildItem
werden ausgeblendete Elemente nicht angezeigt. Verwenden Sie den Parameter Force , 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 eines oder mehrerer Zeichenfolgenmuster an, das abgeglichen werden soll, da das Cmdlet untergeordnete Elemente abruft. Jedes übereinstimmende Element ist in der Ausgabe enthalten. Geben Sie ein Pfadelement 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 "Einschließen " und "Ausschließen " können zusammen verwendet werden. Die Ausschlüsse werden jedoch nach den Einschlüssen angewendet, die sich auf die endgültige Ausgabe auswirken können.
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 wie eingegeben verwendet. Es werden keine Zeichen als Platzhalter interpretiert. Wenn der Pfad Escapezeichen enthält, müssen Sie ihn in einfache Anführungszeichen einschließen. Einzelne Anführungszeichen weisen PowerShell darauf hin, 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 an der Position ab. Die Ausgabe ist ein Zeichenfolgenobjekt, das 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
Verwenden Sie zum Abrufen nur schreibgeschützter Elemente den ReadOnly-Parameter oder den Attribute-ParameterReadOnly-Eigenschaft .
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 Systemparameter - oder Attribute-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 ausführen, die einen Pfad enthält Get-ChildItem
.
Ausgaben
Der Typ des zurückzugebenden Objekts Get-ChildItem
wird durch die Objekte im Anbieterlaufwerkpfad bestimmt.
Wenn Sie den Parameter Name verwenden, Get-ChildItem
werden die Objektnamen als Zeichenfolgen zurückgegeben.
Hinweise
Get-ChildItem
kann mit einem der integrierten Aliase,ls
,dir
, undgci
. 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 so konzipiert, dass sie mit den daten verwendet wird, die von jedem Anbieter verfügbar gemacht werden. Zum Auflisten der in Ihrer Sitzung verfügbaren Anbieter geben SieGet-PSProvider
. Weitere Informationen finden Sie unter about_Providers.