Get-ChildItem

Referentie

Module:: Microsoft.PowerShell.Management

Hiermee haalt u de items en onderliggende items op een of meer opgegeven locaties op.

Syntaxis

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

Description

De Get-ChildItem cmdlet haalt de items op een of meer opgegeven locaties op. Als het item een container is, worden de items in de container opgevraagd, ook wel onderliggende items genoemd. U kunt de parameter Recurse gebruiken om items in alle onderliggende containers op te halen en de parameter Diepte te gebruiken om het aantal niveaus te beperken tot recurse.

Get-ChildItem er worden geen lege mappen weergegeven. Wanneer een Get-ChildItem opdracht de parameters Diepte of Recurse bevat, worden lege mappen niet opgenomen in de uitvoer.

Locaties worden beschikbaar gesteld Get-ChildItem door PowerShell-providers. Een locatie kan een bestandssysteemmap, register hive of een certificaatarchief zijn. Sommige parameters zijn alleen beschikbaar voor een specifieke provider. Zie about_Providers voor meer informatie.

Voorbeelden

Voorbeeld 1: Onderliggende items ophalen uit een bestandssysteemmap

In dit voorbeeld worden de onderliggende items opgehaald uit een bestandssysteemmap. De bestandsnamen en submapnamen worden weergegeven. Voor lege locaties retourneert de opdracht geen uitvoer en keert deze terug naar de PowerShell-prompt.

De Get-ChildItem cmdlet gebruikt de padparameter om de map C:\Testop te geven. Get-ChildItem geeft de bestanden en mappen weer in de PowerShell-console.

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

Get-ChildItem Standaard worden de modus (kenmerken), LastWriteTime, bestandsgrootte (lengte) en de naam van het item weergegeven. De letters in de eigenschap Modus kunnen als volgt worden geïnterpreteerd:

l (koppeling)
d (map)
a (archief)
r (alleen-lezen)
h (verborgen)
s (systeem)

Zie about_Filesystem_Provider voor meer informatie over de modusvlagmen.

Voorbeeld 2: Namen van onderliggende items ophalen in een map

In dit voorbeeld worden alleen de namen van items in een map weergegeven.

De Get-ChildItem cmdlet gebruikt de padparameter om de map C:\Testop te geven. De parameter Name retourneert alleen de bestands- of mapnamen van het opgegeven pad. De geretourneerde namen zijn relatief ten opzichte van de waarde van de parameter Path .

Get-ChildItem -Path C:\Test -Name

Logs
anotherfile.txt
Command.txt
CreateTestFile.ps1
ReadOnlyFile.txt

Voorbeeld 3: Onderliggende items ophalen in de huidige map en submappen

In dit voorbeeld worden bestanden weergegeven .txt die zich in de huidige map en de bijbehorende submappen bevinden.

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

De Get-ChildItem cmdlet gebruikt de parameter Path om op te geven C:\Test\*.txt. Het pad gebruikt het sterretje (*) om alle bestanden met de bestandsnaamextensie .txtop te geven. De parameter Recurse doorzoekt de padmap en de bijbehorende submappen, zoals wordt weergegeven in de map: koppen. Met de parameter Force worden verborgen bestanden weergegeven, zoals hiddenfile.txt die een modus h hebben.

Voorbeeld 4: Onderliggende items ophalen met de parameter Opnemen

In dit voorbeeld Get-ChildItem wordt de parameter Include gebruikt om specifieke items te zoeken uit de map die is opgegeven door de parameter Path .

# 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

De Get-ChildItem cmdlet gebruikt de padparameter om de map C:\Testop te geven. De parameter Path bevat een achtervolgend sterretje (*) om de inhoud van de map op te geven. De parameter Include maakt gebruik van een sterretje (*) jokerteken om alle bestanden met de bestandsnaamextensie .txtop te geven.

Wanneer de parameter Include wordt gebruikt, heeft de parameter Path een volgsterretje (*) jokerteken nodig om de inhoud van de map op te geven. Bijvoorbeeld: -Path C:\Test\*.

Als de parameter Recurse wordt toegevoegd aan de opdracht, is het afsluitende sterretje (*) in de parameter Path optioneel. De parameter Recurse haalt items op uit de padmap en de bijbehorende submappen. Bijvoorbeeld -Path C:\Test\ -Recurse -Include *.txt
Als een volgsterretje (*) niet is opgenomen in de parameter Path , retourneert de opdracht geen uitvoer en keert deze terug naar de PowerShell-prompt. Bijvoorbeeld: -Path C:\Test\.

Voorbeeld 5: Onderliggende items ophalen met de parameter Uitsluiten

In de uitvoer van het voorbeeld ziet u de inhoud van de map C:\Test\Logs. De uitvoer is een verwijzing voor de andere opdrachten die gebruikmaken van de parameters Exclude en Recurse .

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

De Get-ChildItem cmdlet gebruikt de padparameter om de map C:\Test\Logsop te geven. De parameter Uitsluiten maakt gebruik van het jokerteken sterretje (*) om bestanden of mappen op te geven die beginnen met A of a worden uitgesloten van de uitvoer.

Wanneer de parameter Uitsluiten wordt gebruikt, is een afsluitend sterretje (*) in de parameter Path optioneel. Bijvoorbeeld -Path C:\Test\Logs of -Path C:\Test\Logs\*.

Als een volgsterretje (*) niet is opgenomen in de parameter Path , wordt de inhoud van de parameter Path weergegeven. De uitzonderingen zijn bestandsnamen of submapnamen die overeenkomen met de waarde van de parameter Uitsluiten .
Als een volgsterretje (*) is opgenomen in de parameter Path , wordt de opdracht teruggeleid naar de submappen van de parameter Path . De uitzonderingen zijn bestandsnamen of submapnamen die overeenkomen met de waarde van de parameter Uitsluiten .
Als de parameter Recurse wordt toegevoegd aan de opdracht, is de recursie-uitvoer hetzelfde, ongeacht of de parameter Path een volgsterretje (*) bevat.

Voorbeeld 6: De registersleutels ophalen uit een register hive

In dit voorbeeld worden alle registersleutels opgehaald van HKEY_LOCAL_MACHINE\HARDWARE.

Get-ChildItem gebruikt de parameter Path om de registersleutel HKLM:\HARDWAREop te geven. Het pad en het hoogste niveau van registersleutels van Hive worden weergegeven in de PowerShell-console.

Zie about_Registry_Provider voor meer informatie.

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

Met de eerste opdracht wordt de inhoud van de HKLM:\HARDWARE registersleutel weergegeven. De parameter Uitsluiten geeft aan Get-ChildItem dat er geen subsleutels moeten worden geretourneerd die beginnen met D*. Op dit moment werkt de parameter Uitsluiten alleen op subsleutels, niet op itemeigenschappen.

Voorbeeld 7: Alle certificaten ophalen met een instantie voor ondertekening van programmacode

In dit voorbeeld wordt elk certificaat in het PowerShell-station Cert: met een instantie voor ondertekening van programmacode opgeslagen.

De Get-ChildItem cmdlet gebruikt de parameter Path om de certificaatprovider met het Cert: station op te geven. De parameter Recurse doorzoekt de map die is opgegeven door Path en de bijbehorende submappen. De parameter CodeSigningCert haalt alleen certificaten op die een instantie voor ondertekening van programmacode hebben.

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

Zie about_Certificate_Provider voor meer informatie over de certificaatprovider en het Cert: station.

Voorbeeld 8: Items ophalen met de parameter Diepte

In dit voorbeeld worden de items in een map en de bijbehorende submappen weergegeven. De parameter Diepte bepaalt het aantal submapniveaus dat moet worden opgenomen in de recursie. Lege mappen worden uitgesloten van de uitvoer.

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

De Get-ChildItem cmdlet gebruikt de parameter Path om op te geven C:\Parent. Met de parameter Diepte worden twee niveaus van recursie opgegeven. Get-ChildItem geeft de inhoud weer van de map die is opgegeven door de parameter Path en de twee niveaus van submappen.

Voorbeeld 9: Informatie over harde koppelingen ophalen

In PowerShell 6.2 is een alternatieve weergave toegevoegd om informatie over harde koppelingen op te halen.

Get-ChildItem -Path C:\PathContainingHardLink | Format-Table -View childrenWithHardLink

Voorbeeld 10: Uitvoer voor niet-Windows-besturingssystemen

In PowerShell 7.1 op Unix-systemen biedt de Get-ChildItem unix-achtige uitvoer:

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

De nieuwe eigenschappen die nu deel uitmaken van de uitvoer zijn:

UnixMode is de bestandsmachtigingen zoals weergegeven op een Unix-systeem
Gebruiker is de eigenaar van het bestand
Groep is de groepseigenaar
Grootte is de grootte van het bestand of de map zoals weergegeven op een Unix-systeem

Notitie

Deze functie is verplaatst van experimenteel naar basis in PowerShell 7.1.

Voorbeeld 11: Het koppelingsdoel voor een verbindingspunt ophalen

De dir opdracht in de Windows Command Shell toont de doellocatie van een bestandssysteemverbindingspunt. In PowerShell is deze informatie beschikbaar via de eigenschap LinkTarget van het bestandssysteemobject dat wordt geretourneerd door Get-ChildItem en wordt weergegeven in de standaarduitvoer.

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

Voorbeeld 12: Het koppelingsdoel voor een AppX-reparsepunt ophalen

In dit voorbeeld wordt geprobeerd de doelgegevens voor een AppX-reparsepunt op te halen. Microsoft Store-toepassingen maken AppX-reparsepunten in de map AppData van de gebruiker.

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

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

Op dit moment biedt Windows geen manier om de doelgegevens voor een AppX-reparsepunt op te halen. De eigenschappen LinkTarget en LinkType van het bestandssysteemobject zijn leeg.

Parameters

-Attributes

Notitie

Deze parameter is alleen beschikbaar in de bestandssysteemprovider .

Hiermee worden bestanden en mappen opgehaald met de opgegeven kenmerken. Deze parameter ondersteunt alle kenmerken en kunt u complexe combinaties van kenmerken opgeven.

Als u bijvoorbeeld niet-systeembestanden (geen mappen) wilt ophalen die zijn versleuteld of gecomprimeerd, typt u:

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

Als u bestanden en mappen met veelgebruikte kenmerken wilt zoeken, gebruikt u de parameter Kenmerken . Of de parameters Directory, File, Hidden, ReadOnly en System.

De parameter Kenmerken ondersteunt de volgende eigenschappen:

Archiveren
Samengedrukt
Apparaat
Map
Gecodeerde
Verborgen
IntegrityStream
Normaal
NoScrubData
NotContentIndexed
Offline
ReadOnly
ReparsePoint
SparseFile
Systeem
Tijdelijk

Zie de Opsomming FileAttributes voor een beschrijving van deze kenmerken.

Als u kenmerken wilt combineren, gebruikt u de volgende operators:

! (NIET)
+ (EN)
, (OF)

Gebruik geen spaties tussen een operator en het bijbehorende kenmerk. Spaties worden geaccepteerd na komma's.

Gebruik de volgende afkortingen voor algemene kenmerken:

D (Directory)
H (Verborgen)
R (Alleen-lezen)
S (Systeem)

Type:	FlagsExpression<T>[FileAttributes]
Geaccepteerde waarden:	Archive, Compressed, Device, Directory, Encrypted, Hidden, IntegrityStream, Normal, NoScrubData, NotContentIndexed, Offline, ReadOnly, ReparsePoint, SparseFile, System, Temporary
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-CodeSigningCert

Notitie

Deze parameter is alleen beschikbaar in de certificaatprovider .

Als u een lijst met certificaten wilt ophalen die de eigenschapswaarde EnhancedKeyUsageList hebbenCode Signing, gebruikt u de parameter CodeSigningCert.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Depth

Deze parameter is toegevoegd in PowerShell 5.0 en stelt u in staat om de diepte van recursie te beheren. Get-ChildItem Standaard wordt de inhoud van de bovenliggende map weergegeven. De parameter Diepte bepaalt het aantal submapniveaus dat is opgenomen in de recursie en geeft de inhoud weer.

Bevat bijvoorbeeld -Depth 2 de map van de padparameter , het eerste niveau van submappen en het tweede niveau van submappen. Standaard worden mapnamen en bestandsnamen opgenomen in de uitvoer.

Notitie

Op een Windows-computer van PowerShell of cmd.exe kunt u een grafische weergave van een mapstructuur weergeven met de opdracht tree.com .

Type:	UInt32
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Directory

Notitie

Deze parameter is alleen beschikbaar in de bestandssysteemprovider .

Als u een lijst met directory's wilt ophalen, gebruikt u de parameter Directory of de parameter Kenmerken met de eigenschap Directory. U kunt de parameter Recurse gebruiken met Directory.

Type:	SwitchParameter
Aliassen:	ad
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-DnsName

Notitie

Deze parameter is alleen beschikbaar in de certificaatprovider .

Hiermee geeft u een domeinnaam of naampatroon dat overeenkomt met de eigenschap DNSNameList van certificaten die de cmdlet ophaalt. De waarde van deze parameter kan of Unicode ASCII. Punycode-waarden worden geconverteerd naar Unicode. Jokertekens (*) zijn toegestaan.

Deze parameter is opnieuw geïntroduceerd in PowerShell 7.1

Type:	DnsNameRepresentation
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	True

-DocumentEncryptionCert

Notitie

Deze parameter is alleen beschikbaar in de certificaatprovider .

Gebruik de parameter DocumentEncryptionCert om een lijst op te halen met certificaten met Document Encryption de eigenschapswaarde EnhancedKeyUsageList.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Eku

Notitie

Deze parameter is alleen beschikbaar in de certificaatprovider .

Hiermee geeft u tekst of een tekstpatroon dat overeenkomt met de eigenschap EnhancedKeyUsageList van certificaten die de cmdlet ophaalt. Jokertekens (*) zijn toegestaan. De eigenschap EnhancedKeyUsageList bevat de beschrijvende naam en de OID-velden van de EKU.

Deze parameter is opnieuw geïntroduceerd in PowerShell 7.1

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	True

-Exclude

Hiermee geeft u een matrix op van een of meer tekenreekspatronen die moeten worden vergeleken wanneer de cmdlet onderliggende items ophaalt. Elk overeenkomend item wordt uitgesloten van de uitvoer. Voer een padelement of -patroon in, zoals *.txt of A*. Jokertekens worden geaccepteerd.

Een volgsterretje (*) in de padparameter is optioneel. Bijvoorbeeld -Path C:\Test\Logs of -Path C:\Test\Logs\*. Als er een volgsterretje (*) is opgenomen, wordt de opdracht teruggeleid naar de submappen van de parameter Path . Zonder het sterretje (*) wordt de inhoud van de parameter Path weergegeven. Meer informatie vindt u in voorbeeld 5 en de sectie Notities.

De parameters Opnemen en Uitsluiten kunnen samen worden gebruikt. De uitsluitingen worden echter toegepast na de opname, die van invloed kunnen zijn op de uiteindelijke uitvoer.

Type:	String[]
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	True

-ExpiringInDays

Notitie

Deze parameter is alleen beschikbaar in de certificaatprovider .

Hiermee geeft u op dat de cmdlet alleen certificaten moet retourneren die binnen of vóór het opgegeven aantal dagen verlopen. Een waarde van nul (0) haalt certificaten op die zijn verlopen.

Deze parameter is opnieuw geïntroduceerd in PowerShell 7.1

Type:	Int32
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-File

Notitie

Deze parameter is alleen beschikbaar in de bestandssysteemprovider .

Gebruik de parameter Bestand om een lijst met bestanden op te halen. U kunt de parameter Recurse gebruiken met File.

Type:	SwitchParameter
Aliassen:	af
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Filter

Hiermee geeft u een filter op om de path-parameter te kwalificeren. De FileSystem-provider is de enige geïnstalleerde PowerShell-provider die filters ondersteunt. Filters zijn efficiënter dan andere parameters. De provider past een filter toe wanneer de cmdlet de objecten ophaalt in plaats van PowerShell de objecten te filteren nadat deze zijn opgehaald. De filtertekenreeks wordt doorgegeven aan de .NET-API om bestanden op te sommen. De API biedt alleen ondersteuning * voor jokertekens en ? jokertekens.

Type:	String
Position:	1
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	True

-FollowSymlink

Notitie

Deze parameter is alleen beschikbaar in de bestandssysteemprovider .

Standaard worden in de Get-ChildItem cmdlet symbolische koppelingen weergegeven naar mappen die tijdens recursie zijn gevonden, maar worden er geen recurse in weergegeven. Gebruik de parameter FollowSymlink om te zoeken in de mappen waarop deze symbolische koppelingen zijn gericht. De FollowSymlink is een dynamische parameter en wordt alleen ondersteund in de bestandssysteemprovider .

Deze parameter is geïntroduceerd in PowerShell 6.0.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Force

Hiermee kan de cmdlet items ophalen die anders niet kunnen worden geopend door de gebruiker, zoals verborgen bestanden of systeembestanden. De parameter Force overschrijft geen beveiligingsbeperkingen. De implementatie varieert per provider. Zie about_Providers voor meer informatie.

Type:	SwitchParameter
Position:	Named
Default value:	False
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Hidden

Notitie

Deze parameter is alleen beschikbaar in de bestandssysteemprovider .

Als u alleen verborgen items wilt ophalen, gebruikt u de parameter Verborgen of de parameter Kenmerken met de eigenschap Verborgen. Get-ChildItem Verborgen items worden standaard niet weergegeven. Gebruik de parameter Force om verborgen items op te halen.

Type:	SwitchParameter
Aliassen:	ah, h
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Include

Hiermee geeft u een matrix op van een of meer tekenreekspatronen die moeten worden vergeleken wanneer de cmdlet onderliggende items ophaalt. Elk overeenkomend item wordt opgenomen in de uitvoer. Voer een padelement of patroon in, zoals "*.txt". Jokertekens zijn toegestaan. De parameter Opnemen is alleen van kracht wanneer de opdracht de inhoud van een item bevat, zoals C:\Windows\*, waarbij het jokerteken de inhoud van de C:\Windows map aangeeft.

De parameters Opnemen en Uitsluiten kunnen samen worden gebruikt. De uitsluitingen worden echter toegepast na de opname, die van invloed kunnen zijn op de uiteindelijke uitvoer.

Type:	String[]
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	True

-LiteralPath

Hiermee geeft u een pad naar een of meer locaties. De waarde van LiteralPath wordt exact gebruikt zoals deze is getypt. Er worden geen tekens geïnterpreteerd als jokertekens. Als het pad escapetekens bevat, plaatst u het tussen enkele aanhalingstekens. Enkele aanhalingstekens geven PowerShell aan dat er geen tekens als escapereeksen worden geïnterpreteerd.

Zie about_Quoting_Rules voor meer informatie.

Type:	String[]
Aliassen:	PSPath, LP
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Name

Hiermee haalt u alleen de namen van de items op de locatie op. De uitvoer is een tekenreeksobject dat naar de pijplijn kan worden verzonden naar andere opdrachten. De geretourneerde namen zijn relatief ten opzichte van de waarde van de parameter Path .

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Path

Hiermee geeft u een pad naar een of meer locaties. Jokertekens worden geaccepteerd. De standaardlocatie is de huidige map (.).

Type:	String[]
Position:	0
Default value:	Current directory
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	True

-ReadOnly

Notitie

Deze parameter is alleen beschikbaar in de bestandssysteemprovider .

Als u alleen-lezenitems wilt ophalen, gebruikt u de readOnly-parameter of de eigenschap Kenmerkparameter ReadOnly.

Type:	SwitchParameter
Aliassen:	ar
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Recurse

Hiermee haalt u de items op de opgegeven locaties en in alle onderliggende items van de locaties op.

Type:	SwitchParameter
Aliassen:	s
Position:	Named
Default value:	False
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-SSLServerAuthentication

Notitie

Deze parameter is alleen beschikbaar in de certificaatprovider .

Gebruik de parameter SSLServerAuthentication om een lijst op te halen met certificaten die de eigenschapswaarde EnhancedKeyUsageList hebbenServer Authentication.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-System

Notitie

Deze parameter is alleen beschikbaar in de bestandssysteemprovider .

Haalt alleen systeembestanden en mappen op. Als u alleen systeembestanden en mappen wilt ophalen, gebruikt u de systeemparameter of de parameter Systeemeigenschap Kenmerken.

Type:	SwitchParameter
Aliassen:	as
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

Invoerwaarden

String

U kunt een tekenreeks met een pad naar deze cmdlet doorsluisen.

Uitvoerwaarden

AliasInfo

De cmdlet voert dit type uit bij het openen van het Alias: station.

X509StoreLocation

X509Store

X509Certificate2

De cmdlet voert deze typen uit bij het openen van het Cert: station.

DictionaryEntry

De cmdlet voert dit type uit bij het openen van het Env: station.

DirectoryInfo

FileInfo

De cmdlet voert deze typen uit bij het openen van de bestandssysteemstations.

FunctionInfo

FilterInfo

De cmdlet voert deze typen uit bij het openen van de Function: stations.

RegistryKey

De cmdlet voert dit type uit bij het openen van de registerstations.

PSVariable

De cmdlet voert dit type uit bij het openen van de Variable: stations.

WSManConfigContainerElement

WSManConfigLeafElement

De cmdlet voert deze typen uit bij het openen van de WSMan: stations.

String

Wanneer u de parameter Name gebruikt, retourneert deze cmdlet de objectnamen als tekenreeksen.

Notities

PowerShell bevat de volgende aliassen voor Get-ChildItem:

Alle platforms:
- dir, gci
Windows:
- ls

Get-ChildItem krijgt standaard geen verborgen items. Gebruik de parameter Force om verborgen items op te halen.

De Get-ChildItem cmdlet is ontworpen om te werken met de gegevens die door elke provider worden weergegeven. Als u de providers wilt weergeven die beschikbaar zijn in uw sessie, typt Get-PSProvideru . Zie about_Providers voor meer informatie.

Delen via

Get-ChildItem

Syntaxis

Description

Voorbeelden

Voorbeeld 1: Onderliggende items ophalen uit een bestandssysteemmap

Voorbeeld 2: Namen van onderliggende items ophalen in een map

Voorbeeld 3: Onderliggende items ophalen in de huidige map en submappen

Voorbeeld 4: Onderliggende items ophalen met de parameter Opnemen

Voorbeeld 5: Onderliggende items ophalen met de parameter Uitsluiten

Voorbeeld 6: De registersleutels ophalen uit een register hive

Voorbeeld 7: Alle certificaten ophalen met een instantie voor ondertekening van programmacode

Voorbeeld 8: Items ophalen met de parameter Diepte

Voorbeeld 9: Informatie over harde koppelingen ophalen

Voorbeeld 10: Uitvoer voor niet-Windows-besturingssystemen

Voorbeeld 11: Het koppelingsdoel voor een verbindingspunt ophalen

Voorbeeld 12: Het koppelingsdoel voor een AppX-reparsepunt ophalen

Parameters

-Attributes

-CodeSigningCert

-Depth

-Directory

-DnsName

-DocumentEncryptionCert

-Eku

-Exclude

-ExpiringInDays

-File

-Filter

-FollowSymlink

-Force

-Hidden

-Include

-LiteralPath

-Name

-Path

-ReadOnly

-Recurse

-SSLServerAuthentication

-System

Invoerwaarden

Uitvoerwaarden

Notities

Verwante koppelingen

Aanvullende resources