Freigeben über

Get-ChildItem

  • Referenz
Modul:
Microsoft.PowerShell.Management

Ruft die Elemente und untergeordneten Elemente an angegebenen Speicherorten 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 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. Einige Parameter sind nur für einen bestimmten Anbieter verfügbar. 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:\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 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:\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 Dateien angezeigt .txt , die sich im aktuellen Verzeichnis und den zugehörigen 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 Get-ChildItem Cmdlet verwendet den Path-Parameter , um anzugeben C:\Test\*.txt. Path verwendet das Sternchen (*) platzhalter, um alle Dateien mit der Dateinamenerweiterung .txtanzugeben. 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:\Testanzugeben. Der Path-Parameter enthält ein nachgestelltes Sternchen (*) als Platzhalter, um den Inhalt des Verzeichnisses anzugeben. Der Include-Parameter verwendet ein Sternchen (*) platzhalter, 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\Logsanzugeben. Der Exclude-Parameter verwendet das Sternchen (*) zum Angeben aller Dateien oder Verzeichnisse, die mit A der Ausgabe beginnen oder a aus 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:\HARDWAREanzugeben. 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 auf dem PowerShell-Laufwerk Cert: abgerufen, das über eine Codesignaturzertifizierungsstelle verfügt.

Das Get-ChildItem Cmdlet verwendet den Path-Parameter , um den Zertifikatanbieter mit dem Cert: Laufwerk 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 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 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 anzugeben C:\Parent. Der Depth-Parameter gibt zwei Rekursionsstufen an. Get-ChildItem zeigt den Inhalt des durch den Path-Parameter angegebenen Verzeichnisses und die beiden Unterverzeichnisseebenen an.

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-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 Eigenschaften LinkTarget und LinkType des Dateisystemobjekts sind leer.

Parameter

-Attributes

Hinweis

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

-CodeSigningCert

Hinweis

Dieser Parameter ist nur im Zertifikatanbieter verfügbar.

Verwenden Sie den CodeSigningCert-Parameter, um eine Liste von Zertifikaten abzurufen, die im EnhancedKeyUsageList-Eigenschaftswert enthalten Code Signing sind.

Type:SwitchParameter
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

Hinweis

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

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
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DnsName

Hinweis

Dieser Parameter ist nur im Zertifikatanbieter 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 oder ASCIIseinUnicode. Punycode-Werte werden in Unicode konvertiert. Wildcardzeichen (*) sind zulässig.

Dieser Parameter wurde in PowerShell 7.1 wieder eingeführt.

Type:DnsNameRepresentation
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-DocumentEncryptionCert

Hinweis

Dieser Parameter ist nur im Zertifikatanbieter verfügbar.

Verwenden Sie den DocumentEncryptionCert-Parameter, um eine Liste von Zertifikaten abzurufen, die im EnhancedKeyUsageList-Eigenschaftswert enthalten Document Encryption sind.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Eku

Hinweis

Dieser Parameter ist nur im Zertifikatanbieter 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 wieder eingeführt.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

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

-ExpiringInDays

Hinweis

Dieser Parameter ist nur im Zertifikatanbieter 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 abgelaufene Zertifikate ab.

Dieser Parameter wurde in PowerShell 7.1 wieder eingeführt.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-File

Hinweis

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

Verwenden Sie den File-Parameter , um eine Liste von Dateien abzurufen. Sie können den Parameter Recurse 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 ? -Feldhalter.

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-FollowSymlink

Hinweis

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

Standardmäßig zeigt das Cmdlet symbolische Links zu Verzeichnissen an, die Get-ChildItem während der Rekursion gefunden wurden, aber nicht wieder in diese. Verwenden Sie den Parameter FollowSymlink , um die Verzeichnisse zu durchsuchen, die auf diese symbolischen Links abzielen. FollowSymlink ist ein dynamischer Parameter und wird nur vom 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

Hinweis

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

Um nur ausgeblendete Elemente abzurufen, verwenden Sie den Hidden-Parameter oder den Attribute-Parameter mit der Hidden-Eigenschaft . Standardmäßig werden keine ausgeblendeten Get-ChildItem 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 aus 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. Der Include-Parameter ist nur wirksam, wenn der Befehl den Inhalt eines Elements enthält, z C:\Windows\*. B. , wobei das Feldhalterzeichen 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. Einzelne 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 an andere Befehle gesendet werden kann. Die zurückgegebenen Namen sind relativ zum Wert des Path-Parameters .

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

Gibt einen Pfad zu einem oder mehreren Speicherorten an. Feldhalter 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

Hinweis

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

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

-SSLServerAuthentication

Hinweis

Dieser Parameter ist nur im Zertifikatanbieter verfügbar.

Verwenden Sie den SSLServerAuthentication-Parameter, um eine Liste der Zertifikate abzurufen, die in ihrem EnhancedKeyUsageList-Eigenschaftswert enthalten Server Authentication sind.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-System

Hinweis

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

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, die einen Pfad enthält, an dieses Cmdlet übergeben.

Ausgaben

AliasInfo

Das Cmdlet gibt diesen Typ beim Zugriff auf das Alias: Laufwerk aus.

X509StoreLocation

X509Store

X509Certificate2

Das Cmdlet gibt diese Typen beim Zugriff auf das Cert: Laufwerk aus.

DictionaryEntry

Das Cmdlet gibt diesen Typ beim Zugriff auf das Env: Laufwerk aus.

DirectoryInfo

FileInfo

Das Cmdlet gibt diese Typen beim Zugriff auf die Dateisystemlaufwerke aus.

FunctionInfo

FilterInfo

Das Cmdlet gibt diese Typen beim Zugriff auf die Function: Laufwerke aus.

RegistryKey

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

PSVariable

Das Cmdlet gibt diesen Typ beim Zugriff auf die Variable: Laufwerke aus.

WSManConfigContainerElement

WSManConfigLeafElement

Das Cmdlet gibt diese Typen beim Zugriff auf die WSMan: Laufwerke aus.

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
  • Windows:
    • ls

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