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 <uint32>]
   [-Force]
   [-Name]
   [-UseTransaction]
   [-Attributes <FlagsExpression[FileAttributes]>]
   [-Directory]
   [-File]
   [-Hidden]
   [-ReadOnly]
   [-System]
   [<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 Parameter Recurse verwenden, um Elemente in allen untergeordneten Containern abzurufen, und den Depth-Parameter verwenden, um die Anzahl der Ebenen auf rekursieren zu beschränken.

Get-ChildItem leere Verzeichnisse werden nicht 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 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. Für leere Speicherorte gibt der Befehl keine Ausgabe zurück und kehrt zur PowerShell-Eingabeaufforderung zurück.

Das Get-ChildItem Cmdlet 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 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 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 Get-ChildItem Cmdlet verwendet den Parameter "Path ", um das Verzeichnis C:\Testanzugeben. Der Name-Parameter 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 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 Get-ChildItem Cmdlet verwendet den Path-Parameter , um anzugeben C:\Test\*.txt. Der Pfad verwendet das Sternchen (*) zum Angeben aller Dateien mit der Dateinamenerweiterung .txt. Der Parameter Recurse durchsucht das Pfadverzeichnis und seine Unterverzeichnisse, wie in den Überschriften "Directory: " dargestellt. 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 Include-Parameter verwendet, um bestimmte Elemente aus dem verzeichnis zu suchen, das durch den Path-Parameter 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 Get-ChildItem Cmdlet verwendet den Parameter "Path ", um das Verzeichnis C:\Testanzugeben. Der Path-Parameter enthält einen nachgestellten Sternchen (*) zum Angeben des Verzeichnisinhalts. Der Include-Parameter verwendet einen Sternchen (*) zum Angeben aller Dateien mit der Dateinamenerweiterung .txt.

Wenn der Include-Parameter verwendet wird, benötigt der Path-Parameter einen nachgestellten Sternchen (*) zum Angeben des Verzeichnisinhalts. Beispiel: -Path C:\Test\*.

  • Wenn der Parameter Recurse dem Befehl hinzugefügt wird, ist das nachfolgende Sternchen (*) im Parameter Path optional. Der Recurse-Parameter ruft Elemente aus dem Pfadverzeichnis und seinen Unterverzeichnissen ab. 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\Logsan. 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 Parameter "Path ", um das Verzeichnis C:\Test\Logsanzugeben. Der Exclude-Parameter verwendet den Sternchen (*) zum Angeben von Dateien oder Verzeichnissen, die mit A der Ausgabe beginnen oder a ausgeschlossen werden.

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

  • Wenn ein nachfolgendes Sternchen (*) nicht im Path-Parameter enthalten ist, werden die Inhalte 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, rekursiert der Befehl in den Unterverzeichnissen des Path-Parameters . 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, unabhängig davon, ob der Path-Parameter ein nachfolgendes Sternchen (*) enthält.

Beispiel 6: Abrufen der Registrierungsschlüssel aus einer Registrierungsstruktur

In diesem Beispiel werden alle Registrierungsschlüssel abgerufen.HKEY_LOCAL_MACHINE\HARDWARE

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 Exclude-Parameter weist Get-ChildItem nicht an, keine Unterschlüssel zurückzugeben, die mit D*. Derzeit funktioniert der Parameter Exclude 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: mit Der Codesignaturzertifizierungsstelle angezeigt.

Das Get-ChildItem Cmdlet verwendet den Parameter "Path ", um den Zertifikatanbieter mit dem Cert: Laufwerk anzugeben. Der Recurse-Parameter durchsucht das durch Path und seine Unterverzeichnisse angegebene Verzeichnis. Der Parameter CodeSigningCert 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 Depth-Parameter bestimmt die Anzahl der Teilverzeichnisebenen, 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 Rekursionsebenen an. Get-ChildItem zeigt den Inhalt des durch den Path-Parameter angegebenen Verzeichnisses und die beiden Ebenen von Unterverzeichnissen an.

Beispiel 9: Abrufen des Linkziels für einen Verbindungspunkt

Der dir Befehl in der Windows-Befehlsshell zeigt den Zielspeicherort eines Dateisystem-Verbindungspunkts an. In PowerShell sind diese Informationen über die Target-Eigenschaft des dateisystemobjekts verfügbar, von Get-ChildItemdem zurückgegeben wird.

PS D:\> New-Item -ItemType Junction -Name tmp -Target $env:TEMP
PS D:\> Get-ChildItem | Select-Object name,*target

Name     Target
----     ------
tmp      {C:\Users\user1\AppData\Local\Temp}

Beispiel 10: 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.

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

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
  • Directory
  • Verschlüsselt
  • Hidden
  • IntegrityStream
  • Normal
  • NoScrubData
  • NotContentIndexed
  • Offline
  • ReadOnly
  • AnalysePoint
  • SparseFile
  • System
  • Temporär

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

Hinweis

Dieser Parameter ist nur im Zertifikatanbieter verfügbar.

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

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. Zeigt standardmäßig Get-ChildItem den Inhalt des übergeordneten Verzeichnisses an. Der Depth-Parameter bestimmt die Anzahl von Unterverzeichnisebenen, die in der Rekursion enthalten sind, und zeigt den Inhalt an.

Enthält z. B -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 über PowerShell oder cmd.exe kö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

Hinweis

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 Directory-Eigenschaft . Sie können den Recurse-Parameter mit Directory verwenden.

Typ:SwitchParameter
Aliase:ad, d
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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 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

Hinweis

Dieser Parameter ist nur im Zertifikatanbieter verfügbar.

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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 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 Muster ein, z *.txt . B. oder A*. Wildcardzeichen werden akzeptiert.

Ein nachfolgendes Sternchen (*) im Path-Parameter ist optional. Zum Beispiel: -Path C:\Test\Logs oder -Path C:\Test\Logs\*. Wenn ein nachgestelltes 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 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.

Hinweis

Die Parameter "Include" und "Exclude " haben keine Auswirkung, wenn sie mit dem LiteralPath-Parameter verwendet werden. Dies wurde in PowerShell 7 behoben.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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 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

Hinweis

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

Verwenden Sie den Parameter "File ", um eine Liste von Dateien abzurufen. Sie können den Recurse-Parameter mit File verwenden.

Typ:SwitchParameter
Aliase:af
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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 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

Hinweis

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

Standardmäßig zeigt das Get-ChildItem Cmdlet symbolische Verknüpfungen zu Verzeichnissen an, die während der Rekursion gefunden werden, aber nicht rekursiert werden. Verwenden Sie den FollowSymlink-Parameter , um die Verzeichnisse zu durchsuchen, die auf diese symbolischen Verknüpfungen abzielen. 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 unterscheidet sich bei den einzelnen Anbietern. Weitere Informationen finden Sie unter about_Providers.

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

-Hidden

Hinweis

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

Um nur ausgeblendete Elemente abzurufen, verwenden Sie den Parameter Hidden oder den Attributes-Parameter mit der Hidden-Eigenschaft . Get-ChildItem Standardmäßig werden ausgeblendete Elemente 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 Einmuster 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. wenn 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.

Hinweis

Die Parameter "Include" und "Exclude " haben keine Auswirkung, wenn sie mit dem LiteralPath-Parameter verwendet werden. Dies wurde in PowerShell 7 behoben.

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 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. Einfache Anführungszeichen weisen PowerShell an, keine Zeichen als Escapesequenzen zu interpretieren.

Weitere Informationen finden Sie unter about_Quoting_Rules.

Hinweis

Die Parameter "Include" und "Exclude " haben keine Auswirkung, wenn sie mit dem LiteralPath-Parameter verwendet werden. Dies wurde in PowerShell 7 behoben.

Typ:String[]
Aliase:PSPath
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

Hinweis

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

Verwenden Sie den ReadOnly-Parameter oder den Attributes-Parameter ReadOnly , um nur schreibgeschützte Elemente abzurufen.

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 alle untergeordneten Elemente der Speicherorte ab.

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

-SSLServerAuthentication

Hinweis

Dieser Parameter ist nur im Zertifikatanbieter verfügbar.

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

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

-System

Hinweis

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

Ruft nur Systemdateien und Verzeichnisse ab. Wenn Sie nur Systemdateien und Ordner abrufen möchten, verwenden Sie den Systemparameter oder den Attributes-Parameter System.To get only system files and folders, use the System parameter or Attributes parameter System property.

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

-UseTransaction

Schließt den Befehl in die aktive Transaktion ein. Dieser Parameter ist nur gültig, wenn gerade eine Transaktion ausgeführt wird. Weitere Informationen finden Sie unter about_Transactions.

Typ:SwitchParameter
Aliase:usetx
Position:Named
Standardwert:False
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 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 aus, wenn sie auf die Dateisystemlaufwerke zugreifen.

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

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

  • ls
  • dir
  • gci

Get-ChildItem ruft standardmäßig keine ausgeblendeten Elemente ab. Verwenden Sie den Parameter Force , um ausgeblendete Elemente abzurufen.

Das Get-ChildItem Cmdlet wurde entwickelt, um mit den Daten zu arbeiten, die von einem beliebigen Anbieter verfügbar gemacht werden. Geben Sie ein, um die in Ihrer Sitzung verfügbaren Anbieter auflisten zu können Get-PSProvider. Weitere Informationen finden Sie unter about_Providers.