Get-ChildItem

Syntax

Items (Standard)

Get-ChildItem
    [[-Path] <string[]>]
    [[-Filter] <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Recurse]
    [-Depth <uint32>]
    [-Force]
    [-Name]
    [-UseTransaction]
    [-Attributes <FlagsExpression[FileAttributes]>]
    [-Directory]
    [-File]
    [-Hidden]
    [-ReadOnly]
    [-System]
    [<CommonParameters>]

LiteralItems

Get-ChildItem
    [[-Filter] <string>]
    -LiteralPath <string[]>
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Recurse]
    [-Depth <uint32>]
    [-Force]
    [-Name]
    [-UseTransaction]
    [-Attributes <FlagsExpression[FileAttributes]>]
    [-Directory]
    [-File]
    [-Hidden]
    [-ReadOnly]
    [-System]
    [<CommonParameters>]

Beschreibung

Parameter

-Attributes

Ruft Dateien und Ordner mit den angegebenen Attributen ab. Dieser Parameter unterstützt alle Attribute und ermöglicht es Ihnen, komplexe Kombinationen von Attributen anzugeben.

Wenn Sie z. B. nicht systemfremde Dateien (nicht Verzeichnisse) abrufen möchten, die verschlüsselt oder komprimiert sind, geben Sie Folgendes ein:

Get-ChildItem -Attributes !Directory+!System+Encrypted, !Directory+!System+Compressed

Um Dateien und Ordner mit häufig verwendeten Attributen zu suchen, verwenden Sie den parameter Attributes. Oder die Parameter Directory, File, Hidden, ReadOnlyund System.

Der parameter Attributes unterstützt die folgenden Eigenschaften:

• Archive
• Compressed
• Gerät
• Directory
• Verschlüsselt
• Versteckt
• IntegrityStream
• Normal
• NoScrubData
• NotContentIndexed
• Offline
• ReadOnly
• ReparsePoint
• SparseFile
• System
• Temporary

Eine Beschreibung dieser Attribute finden Sie in der FileAttributes-Enumeration.

Verwenden Sie zum Kombinieren von Attributen die folgenden Operatoren:

• ! (NICHT)
• + (UND)
• , (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)

Parametereigenschaften

Parametersätze

-Depth

Dieser Parameter wurde in PowerShell 5.0 hinzugefügt und ermöglicht es Ihnen, die Tiefe der Rekursion zu steuern. Standardmäßig zeigt Get-ChildItem den Inhalt des übergeordneten Verzeichnisses an. Der parameter Depth bestimmt die Anzahl der Unterverzeichnisebenen, die in der Rekursion enthalten sind, und zeigt den Inhalt an.

Beispielsweise enthält 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.

Parametereigenschaften

Parametersätze

-Directory

Verwenden Sie zum Abrufen einer Liste von Verzeichnissen den Parameter Directory oder den Parameter Attributes mit der eigenschaft Directory. Sie können den Parameter Recurse mit Directory verwenden.

Parametereigenschaften

Parametersätze

-Exclude

Gibt als Zeichenfolgenarray eine Eigenschaft oder Eigenschaft an, die dieses Cmdlet vom Vorgang ausschließt. Der Wert dieses Parameters qualifiziert den parameter Path. Geben Sie ein Pfadelement oder Einmuster ein, z. B. *.txt 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 Sternchen am Ende (*) enthalten ist, sucht der Befehl in den Unterverzeichnissen des Parameters Path weiter. Ohne das Sternchen (*) werden die Inhalte des Path-Parameters angezeigt. Weitere Details sind in Beispiel 5 und im Abschnitt "Notizen" enthalten.

Parametereigenschaften

Parametersätze

-File

Verwenden Sie zum Abrufen einer Liste von Dateien den Parameter File. Sie können den Parameter Recurse mit File verwenden.

Parametereigenschaften

Parametersätze

-Filter

Gibt einen Filter an, der den parameter Path qualifizieren soll. Der FileSystem--Anbieter ist der einzige installierte PowerShell-Anbieter, der die Verwendung von Filtern unterstützt. Filter sind effizienter als andere Parameter, da der Anbieter sie anwendet, wenn das Cmdlet die Objekte abruft, anstatt dass PowerShell die Objekte nach dem Abrufen filtert. Die Filterzeichenfolge wird an die .NET-API übergeben, um Dateien aufzählen zu können. Diese API unterstützt nur * und ?-Wildcards.

Parametereigenschaften

Parametersätze

-Force

Ermöglicht dem Cmdlet das Abrufen von Elementen, auf die nicht anderweitig nicht vom Benutzer zugegriffen werden kann, z. B. ausgeblendete oder Systemdateien. Der Parameter Force setzt keine Sicherheitseinschränkungen außer Kraft. Die Implementierung variiert je nach Anbieter. Weitere Informationen finden Sie unter über_Anbieter.

Parametereigenschaften

Parametersätze

-Hidden

Um nur ausgeblendete Elemente abzurufen, verwenden Sie den Parameter Hidden oder den Parameter Attributes mit der Eigenschaft Hidden. Standardmäßig werden ausgeblendete Elemente von Get-ChildItem nicht angezeigt. Verwenden Sie den parameter Force, um ausgeblendete Elemente abzurufen.

Parametereigenschaften

Parametersätze

-Include

Gibt als Zeichenfolgenarray ein oder mehrere Elemente an, die dieses Cmdlet in den Vorgang einbezieht. Der Wert dieses Parameters qualifiziert den parameter Path. Geben Sie ein Pfadelement oder Muster ein, z. B. "*.txt". Platzhalterzeichen sind zulässig. Der Include Parameter ist nur wirksam, wenn der Befehl den Inhalt eines Elements einbezieht, wie zum Beispiel C:\Windows\*, wobei das Wildcard-Zeichen den Inhalt des C:\Windows-Verzeichnisses angibt.

Parametereigenschaften

Parametersätze

-LiteralPath

Gibt einen Pfad zu einem oder mehreren Speicherorten an. Der Wert von LiteralPath wird genau so verwendet, wie es geschrieben ist. Es werden keine Zeichen als Wildcards interpretiert. Wenn der Pfad Escapezeichen enthält, müssen Sie ihn in einfache Anführungszeichen einschließen. Einfache Anführungszeichen signalisieren PowerShell, dass keine Zeichen als Escapesequenzen interpretiert werden sollen.

Weitere Informationen finden Sie unter über_Zitierregeln.

Parametereigenschaften

Parametersätze

-Name

Ruft nur die Namen der Elemente am Ort ab. Die Ausgabe ist ein Zeichenfolge-Objekt, das über die Pipeline an andere Befehle weitergegeben werden kann. Wildcards sind zulässig.

Parametereigenschaften

Parametersätze

-Path

Gibt einen Pfad zu einem oder mehreren Speicherorten an. Wildcards werden akzeptiert. Der Standardspeicherort ist das aktuelle Verzeichnis (.).

Parametereigenschaften

Parametersätze

-ReadOnly

Um nur schreibgeschützte Elemente zu erhalten, verwenden Sie den Parameter ReadOnly oder den Parameter AttributesReadOnly.

Parametereigenschaften

Parametersätze

-Recurse

Ruft die Elemente an den angegebenen Speicherorten und alle untergeordneten Elemente der Speicherorte ab.

Parametereigenschaften

Parametersätze

-System

Ruft nur Systemdateien und Verzeichnisse ab. Um nur Systemdateien und Ordner abzurufen, verwenden Sie den parameter System oder Attributes Parameter System-Eigenschaft.

Parametereigenschaften

Parametersätze

-UseTransaction

Enthält den Befehl in der aktiven Transaktion. Dieser Parameter ist nur gültig, wenn eine Transaktion ausgeführt wird. Weitere Informationen finden Sie unter about_Transactions.

Parametereigenschaften

Parametersätze

CommonParameters

Eingaben

String

Ausgaben

Object

String

Hinweise

Ähnliche Themen

• about_Certificate_Provider
• Über_Anbieter
• über_Zitatregeln
• Informationen zum Registry Provider
• ForEach-Object
• Get-Alias
• Get-Item
• Get-Location
• Get-Process
• Get-PSProvider
• Split-Path