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:\Testanzugeben. 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:\Testanzugeben. 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 .txtanzugeben. 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\Logsanzugeben. 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:\HARDWAREanzugeben. 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

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

String

Sie können eine Zeichenfolge ausführen, die einen Pfad enthält Get-ChildItem.

Ausgaben

Object

Der Typ des zurückzugebenden Objekts Get-ChildItem wird durch die Objekte im Anbieterlaufwerkpfad bestimmt.

String

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, und gci. 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 Sie Get-PSProvider. Weitere Informationen finden Sie unter about_Providers.