Freigeben über

Get-ChildItem

  • Referenz
Modul:
Microsoft.PowerShell.Management

Ruft die Elemente und untergeordneten Elemente an mindestens einem angegebenen Speicherort ab.

Syntax

Get-ChildItem
   [[-Path] <string[]>]
   [[-Filter] <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Recurse]
   [-Depth <uint>]
   [-Force]
   [-Name]
   [<CommonParameters>]
Get-ChildItem
   [[-Filter] <string>]
   -LiteralPath <string[]>
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Recurse]
   [-Depth <uint>]
   [-Force]
   [-Name]
   [<CommonParameters>]
Get-ChildItem
   [[-Path] <string[]>]
   [[-Filter] <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Recurse]
   [-Depth <uint>]
   [-Force]
   [-Name]
   [-CodeSigningCert]
   [-DocumentEncryptionCert]
   [-SSLServerAuthentication]
   [-DnsName <string>]
   [-Eku <string[]>]
   [-ExpiringInDays <int>]
   [<CommonParameters>]
Get-ChildItem
   [[-Filter] <string>]
   -LiteralPath <string[]>
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Recurse]
   [-Depth <uint>]
   [-Force]
   [-Name]
   [-CodeSigningCert]
   [-DocumentEncryptionCert]
   [-SSLServerAuthentication]
   [-DnsName <string>]
   [-Eku <string[]>]
   [-ExpiringInDays <int>]
   [<CommonParameters>]
Get-ChildItem
   [[-Path] <string[]>]
   [[-Filter] <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Recurse]
   [-Depth <uint>]
   [-Force]
   [-Name]
   [-Attributes <FlagsExpression[FileAttributes]>]
   [-FollowSymlink]
   [-Directory]
   [-File]
   [-Hidden]
   [-ReadOnly]
   [-System]
   [<CommonParameters>]
Get-ChildItem
   [[-Filter] <string>]
   -LiteralPath <string[]>
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Recurse]
   [-Depth <uint>]
   [-Force]
   [-Name]
   [-Attributes <FlagsExpression[FileAttributes]>]
   [-FollowSymlink]
   [-Directory]
   [-File]
   [-Hidden]
   [-ReadOnly]
   [-System]
   [<CommonParameters>]

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, ruft es die Elemente im Container ab, die als untergeordnete Elemente bezeichnet werden. Sie können den parameter Recurse verwenden, um Elemente in allen untergeordneten Containern abzurufen und den Parameter Depth zu verwenden, um die Anzahl der ebenen auf rekursieren zu beschränken.

Get-ChildItem werden keine leeren Verzeichnisse angezeigt. 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 für Get-ChildItem verfügbar gemacht. Ein Speicherort kann ein Dateisystemverzeichnis, eine Registrierungsstruktur oder ein Zertifikatspeicher sein. Einige Parameter sind nur für einen bestimmten Anbieter verfügbar. Weitere Informationen finden Sie unter über_Anbieter.

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 kehrt zur PowerShell-Eingabeaufforderung zurück.

Das Cmdlet Get-ChildItem verwendet den Parameter Path, 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

Standardmäßig listet Get-ChildItem den Modus (Attributes), LastWriteTime-, dateigröße (Length) und den Name des Elements auf. Die Buchstaben in der eigenschaft Mode können wie folgt interpretiert werden:

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

Weitere Informationen zu den Moduskennzeichnungen finden Sie unter about_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 verwendet den Parameter Path, um das Verzeichnis C:\Testanzugeben. Der parameter Name gibt nur die Datei- oder Verzeichnisnamen aus dem angegebenen Pfad zurück. Die zurückgegebenen Namen sind relativ zum Wert des Path-Parameters.

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 seinen Unterverzeichnissen befinden.

Get-ChildItem -Path .\*.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 Cmdlet Get-ChildItem verwendet den Parameter Path, um C:\Test\*.txtanzugeben. Path verwendet das Sternchen (*) zum Angeben aller Dateien mit der Dateinamenerweiterung .txt. Der parameter Recurse durchsucht das verzeichnis Path verzeichnis und seine Unterverzeichnisse, wie im Verzeichnis dargestellt: Überschriften. Der parameter Force zeigt ausgeblendete Dateien an, z. B. hiddenfile.txt mit einem Modus von h.

Beispiel 4: Abrufen untergeordneter Elemente mithilfe des Include-Parameters

In diesem Beispiel verwendet Get-ChildItem den Parameter Include, um bestimmte Elemente aus dem verzeichnis zu suchen, das durch den Parameter Path angegeben wurde.

# 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 Cmdlet Get-ChildItem verwendet den Parameter Path, um das Verzeichnis C:\Testanzugeben. Der Path-Parameter enthält ein nachfolgendes Sternchen (*) zum Angeben des Verzeichnisinhalts. Der Include Parameter verwendet ein Sternchen (*) zum Angeben aller Dateien mit der Dateinamenerweiterung .txt.

Wenn der parameter Include verwendet wird, benötigt der Path Parameter ein nachgestelltes Sternchen (*), um den Inhalt des Verzeichnisses anzugeben. Beispiel: -Path C:\Test\*.

  • Wenn der parameter Recurse dem Befehl hinzugefügt wird, ist das nachfolgende Sternchen (*) im parameter Path optional. Der parameter Recurse ruft Elemente aus dem verzeichnis Path und seinen Unterverzeichnissen ab. Beispiel: -Path C:\Test\ -Recurse -Include *.txt
  • Wenn ein nachfolgendes Sternchen (*) nicht im parameter Path 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. Bei der Ausgabe handelt es sich um einen Verweis auf die anderen Befehle, die das Exclude und Recurse Parameter 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 Cmdlet Get-ChildItem verwendet den Parameter Path, um das Verzeichnis C:\Test\Logsanzugeben. Der Exclude Parameter verwendet das Sternchen (*) zum Angeben von Dateien oder Verzeichnissen, die mit A oder a beginnen, werden von der Ausgabe ausgeschlossen.

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

  • Wenn ein nachfolgendes Sternchen (*) nicht im parameter Path enthalten ist, werden die Inhalte des Path-Parameters angezeigt. Die Ausnahmen sind Dateinamen oder Unterverzeichnisnamen, die mit dem Wert Exclude Parameterwerts übereinstimmen.
  • Wenn ein nachfolgendes Sternchen (*) im Path-Parameter enthalten ist, rekursiert der Befehl in die Unterverzeichnisse des Path Parameters. Die Ausnahmen sind Dateinamen oder Unterverzeichnisnamen, die mit dem Wert Exclude Parameterwerts übereinstimmen.
  • Wenn der parameter Recurse dem Befehl hinzugefügt wird, ist die Rekursionsausgabe identisch, unabhängig davon, ob der Path Parameter ein nachgestelltes Sternchen (*) enthält.

Beispiel 6: Abrufen der Registrierungsschlüssel aus einer Registrierungsstruktur

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

Get-ChildItem verwendet den Parameter Path, 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 Exclude weist Get-ChildItem an, 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-Cert: Laufwerk mit Codesignaturautorität abrufen.

Das Cmdlet Get-ChildItem verwendet den Parameter Path, um den Zertifikatanbieter mit dem laufwerk Cert: anzugeben. Der Recurse Parameter durchsucht das durch Path und seine Unterverzeichnisse angegebene Verzeichnis. Der CodeSigningCert Parameter ruft nur Zertifikate ab, die über eine Codesignaturzertifizierungsstelle verfügen.

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

Weitere Informationen zum Zertifikatanbieter und zum Cert: Laufwerk 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 seinen Unterverzeichnissen angezeigt. Der parameter Depth bestimmt die Anzahl der Teilverzeichnisebenen, die in die Rekursion aufgenommen 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 Cmdlet Get-ChildItem verwendet den Parameter Path, um C:\Parentanzugeben. Der parameter Depth gibt zwei Rekursionsebenen an. Get-ChildItem zeigt den Inhalt des Verzeichnisses an, das durch den Parameter Path und die beiden Ebenen von Unterverzeichnissen angegeben wird.

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 bietet die Get-ChildItem unixähnliche Ausgabe:

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 Dateiberechtigungen, wie auf einem Unix-System dargestellt
  • Benutzer- ist der Dateibesitzer
  • Gruppen- ist der Gruppenbesitzer
  • Size ist die Größe der Datei oder des Verzeichnisses, wie auf einem Unix-System dargestellt

Anmerkung

Dieses Feature wurde von experimentell in PowerShell 7.1 in den Mainstream verschoben.

Beispiel 11: Abrufen des Linkziels für einen Verbindungspunkt

Der Befehl dir in der Windows-Befehlsshell zeigt den Zielspeicherort eines Dateisystem-Verbindungspunkts an. In PowerShell stehen diese Informationen aus der LinkTarget- Eigenschaft des von Get-ChildItem zurückgegebenen Dateisystemobjekts zur Verfügung und wird in der Standardausgabe angezeigt.

PS D:\> New-Item -ItemType Junction -Name tmp -Target $env:TEMP
PS D:\> Get-ChildItem | Select-Object 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

Beispiel 12: Abrufen des Linkziels für einen AppX-Analysepunkt

In diesem Beispiel wird versucht, die Zielinformationen für einen AppX-Analysepunkt abzurufen. Microsoft Store-Anwendungen erstellen AppX-Analysepunkte im AppData-Verzeichnis des Benutzers.

Get-ChildItem ~\AppData\Local\Microsoft\WindowsApps\MicrosoftEdge.exe |
    Select-Object Mode, LinkTarget, LinkType, Name

Mode  LinkTarget LinkType Name
----  ---------- -------- ----
la---                     MicrosoftEdge.exe

Derzeit bietet Windows keine Möglichkeit, die Zielinformationen für einen AppX-Analysepunkt abzurufen. Die LinkTarget- und LinkType- Eigenschaften des Dateisystemobjekts sind leer.

Parameter

-Attributes

Anmerkung

Dieser Parameter ist nur im FileSystem--Anbieter verfügbar.

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:

  • Archiv-
  • komprimierte
  • Gerät
  • Verzeichnis-
  • Verschlüsselte
  • Ausgeblendete
  • IntegrityStream-
  • Normal
  • NoScrubData-
  • NotContentIndexed-
  • Offline-
  • ReadOnly-
  • ReparsePoint-
  • SparseFile-
  • System
  • temporäre

Eine Beschreibung dieser Attribute finden Sie in der FileAttributes-Aufzählung .

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)
Typ:FlagsExpression<T>[FileAttributes]
Zulässige Werte:Archive, Compressed, Device, Directory, Encrypted, Hidden, IntegrityStream, Normal, NoScrubData, NotContentIndexed, Offline, ReadOnly, ReparsePoint, SparseFile, System, Temporary
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-CodeSigningCert

Anmerkung

Dieser Parameter ist nur im Zertifikat Anbieters verfügbar.

Verwenden Sie den Code Signing-Parameter, um eine Liste von Zertifikaten abzurufen, die in ihrem EnhancedKeyUsageList Eigenschaftswert haben.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-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.

Anmerkung

Auf einem Windows-Computer über PowerShell oder cmd.exekönnen Sie eine grafische Ansicht einer Verzeichnisstruktur mit dem Befehl tree.com anzeigen.

Typ:UInt32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Directory

Anmerkung

Dieser Parameter ist nur im FileSystem--Anbieter verfügbar.

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 Directoryverwenden.

Typ:SwitchParameter
Aliase:ad
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DnsName

Anmerkung

Dieser Parameter ist nur im Zertifikat Anbieters verfügbar.

Gibt einen Domänennamen oder ein Namensmuster an, das mit der DNSNameList Eigenschaft von Zertifikaten übereinstimmt, die das Cmdlet abruft. Der Wert dieses Parameters kann entweder sein Unicode oder ASCII. Punycode-Werte werden in Unicode konvertiert. Wildcardzeichen (*) sind zulässig.

Dieser Parameter wurde in PowerShell 7.1 erneut eingeführt.

Typ:DnsNameRepresentation
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

-DocumentEncryptionCert

Anmerkung

Dieser Parameter ist nur im Zertifikat Anbieters verfügbar.

Um eine Liste von Zertifikaten abzurufen, die in ihrem Document Encryption Eigenschaftswert haben, verwenden Sie den parameter DocumentEncryptionCert.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Eku

Anmerkung

Dieser Parameter ist nur im Zertifikat Anbieters verfügbar.

Gibt Text oder ein Textmuster an, das mit der EnhancedKeyUsageList Eigenschaft von Zertifikaten übereinstimmt, die das Cmdlet abruft. Wildcardzeichen (*) sind zulässig. Die EnhancedKeyUsageList-Eigenschaft enthält den Anzeigenamen und die OID-Felder der EKU.

Dieser Parameter wurde in PowerShell 7.1 erneut eingeführt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

-Exclude

Gibt ein Array mit 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 Pfadelement oder Einmuster ein, z. B. *.txt oder A*. Wildcardzeichen werden akzeptiert.

Ein nachfolgendes Sternchen (*) im Path Parameter ist optional. Beispiel: -Path C:\Test\Logs oder -Path C:\Test\Logs\*. Wenn ein nachfolgendes Sternchen (*) enthalten ist, rekursiert der Befehl in den Unterverzeichnissen des Path Parameters. Ohne das Sternchen (*) werden die Inhalte des Path-Parameters angezeigt. Weitere Details sind in Beispiel 5 und im Abschnitt "Notizen" enthalten.

Die Include und Exclude Parameter zusammen verwenden können. Die Ausschlüsse werden jedoch nach den Einschlüssen angewendet, die sich auf die endgültige Ausgabe auswirken können.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

-ExpiringInDays

Anmerkung

Dieser Parameter ist nur im Zertifikat Anbieters verfügbar.

Gibt an, dass das Cmdlet nur Zertifikate zurückgeben soll, die innerhalb oder vor der angegebenen Anzahl von Tagen ablaufen. Ein Wert von Null (0) ruft Zertifikate ab, die abgelaufen sind.

Dieser Parameter wurde in PowerShell 7.1 erneut eingeführt.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-File

Anmerkung

Dieser Parameter ist nur im FileSystem--Anbieter verfügbar.

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

Typ:SwitchParameter
Aliase:af
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Filter

Gibt einen Filter an, der den parameter Path 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.

Typ:String
Position:1
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

-FollowSymlink

Anmerkung

Dieser Parameter ist nur im FileSystem--Anbieter verfügbar.

Standardmäßig zeigt das cmdlet Get-ChildItem symbolische Verknüpfungen zu Verzeichnissen an, die während der Rekursion gefunden wurden, aber nicht rekursiert werden. Verwenden Sie den FollowSymlink Parameter, um die Verzeichnisse zu durchsuchen, die auf diese symbolischen Verknüpfungen abzielen. Die FollowSymlink- ist ein dynamischer Parameter und wird nur im FileSystem--Anbieter unterstützt.

Dieser Parameter wurde in PowerShell 6.0 eingeführt.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Force

Ermöglicht dem Cmdlet, Elemente abzurufen, auf die andernfalls nicht vom Benutzer zugegriffen werden kann, z. B. ausgeblendete oder Systemdateien. Der Parameter Force überschreibt keine Sicherheitseinschränkungen. Die Implementierung variiert je nach Anbieter. Weitere Informationen finden Sie unter über_Anbieter.

Typ:SwitchParameter
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Hidden

Anmerkung

Dieser Parameter ist nur im FileSystem--Anbieter verfügbar.

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.

Typ:SwitchParameter
Aliase:ah, h
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Include

Gibt ein Array mit 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 Pfadelement oder Muster ein, z. B. "*.txt". Platzhalterzeichen sind zulässig. Die Include-Parameter ist nur wirksam, wenn der Befehl den Inhalt eines Elements enthält, z. B. C:\Windows\*, wobei das Wildcardzeichen den Inhalt des C:\Windows Verzeichnisses angibt.

Die Include und Exclude Parameter zusammen verwenden können. Die Ausschlüsse werden jedoch nach den Einschlüssen angewendet, die sich auf die endgültige Ausgabe auswirken können.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

-LiteralPath

Gibt einen Pfad zu einem oder mehreren Speicherorten an. Der Wert LiteralPath- wird genau so verwendet, wie er eingegeben wird. Es werden keine Zeichen als Wildcards interpretiert. Wenn der Pfad Escapezeichen enthält, schließen Sie ihn in einfache Anführungszeichen ein. Einfache Anführungszeichen weisen PowerShell an, keine Zeichen als Escapesequenzen zu interpretieren.

Weitere Informationen finden Sie unter über_Zitierregeln.

Typ:String[]
Aliase:PSPath, LP
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

Ruft nur die Namen der Elemente an der Position ab. Die Ausgabe ist ein Zeichenfolgenobjekt, das an andere Befehle gesendet werden kann. Die zurückgegebenen Namen sind relativ zum Wert des Path-Parameters.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Path

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

Typ:String[]
Position:0
Standardwert:Current directory
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:True

-ReadOnly

Anmerkung

Dieser Parameter ist nur im FileSystem--Anbieter verfügbar.

Um nur schreibgeschützte Elemente abzurufen, verwenden Sie den parameter ReadOnly oder den parameter Attributes parameter ReadOnly-Eigenschaft.

Typ:SwitchParameter
Aliase:ar
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Recurse

Ruft die Elemente an den angegebenen Speicherorten und in allen untergeordneten Elementen der Speicherorte ab.

Typ:SwitchParameter
Aliase:s, r
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SSLServerAuthentication

Anmerkung

Dieser Parameter ist nur im Zertifikat Anbieters verfügbar.

Verwenden Sie zum Abrufen einer Liste von Zertifikaten, die in ihrem Server Authentication Eigenschaftswert haben, den parameter SSLServerAuthentication.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-System

Anmerkung

Dieser Parameter ist nur im FileSystem--Anbieter verfügbar.

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

Typ:SwitchParameter
Aliase:as
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

String

Sie können eine Zeichenfolge weiterleiten, die einen Pfad zu diesem Cmdlet enthält.

Ausgaben

AliasInfo

Das Cmdlet gibt diesen Typ aus, wenn auf das Alias: Laufwerk zugegriffen wird.

X509StoreLocation

X509Store

X509Certificate2

Das Cmdlet gibt diese Typen aus, wenn sie auf das Cert: Laufwerk zugreifen.

DictionaryEntry

Das Cmdlet gibt diesen Typ aus, wenn auf das Env: Laufwerk zugegriffen wird.

DirectoryInfo

FileInfo

Das Cmdlet gibt diese Typen aus, wenn sie auf die Dateisystemlaufwerke zugreifen.

FunctionInfo

FilterInfo

Das Cmdlet gibt diese Typen aus, wenn sie auf die Function: Laufwerke zugreifen.

RegistryKey

Das Cmdlet gibt diesen Typ beim Zugriff auf die Registrierungslaufwerke aus.

PSVariable

Das Cmdlet gibt diesen Typ aus, wenn auf die Variable: Laufwerke zugegriffen wird.

WSManConfigContainerElement

WSManConfigLeafElement

Das Cmdlet gibt diese Typen aus, wenn sie auf die WSMan: Laufwerke zugreifen.

String

Wenn Sie den parameter Name verwenden, gibt dieses Cmdlet die Objektnamen als Zeichenfolgen zurück.

Hinweise

PowerShell enthält die folgenden Aliase für Get-ChildItem:

  • Alle Plattformen:
    • dir, gci
  • Fenster:
    • ls

Get-ChildItem werden standardmäßig keine ausgeblendeten Elemente abgerufen. Um ausgeblendete Elemente abzurufen, verwenden Sie den Parameter Force.

Das Cmdlet Get-ChildItem ist für die Arbeit mit den Daten konzipiert, die von einem beliebigen Anbieter verfügbar gemacht werden. Geben Sie Get-PSProviderein, um die in Ihrer Sitzung verfügbaren Anbieter auflisten zu können. Weitere Informationen finden Sie unter über_Anbieter.