Get-ChildItem

Referentie

Module:: Microsoft.PowerShell.Management

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

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 Depth gebruiken om het aantal niveaus voor het recurseren te beperken.

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

Locaties worden blootgesteld aan 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_Providersvoor meer informatie.

Voorbeelden

Voorbeeld 1: Subitems ophalen uit een map in het bestandssysteem

In dit voorbeeld worden de subitems 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 parameter Path om de map C:\Testop te geven. Get-ChildItem worden de bestanden en mappen weergegeven 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

In de standaardinstelling toont Get-ChildItem de modus (Kenmerken), LastWriteTime, bestandsgrootte (Lengte), en de Naam van het item. 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_Providervoor meer informatie over de modusvlagmen.

Voorbeeld 2: Subitemnamen verkrijgen in een map

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

De Get-ChildItem-cmdlet gebruikt de parameter Path 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 .txt bestanden weergegeven 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 C:\Test\*.txtop te geven. Pad gebruikt het jokerteken sterretje (*) om alle bestanden met de bestandsnaamextensie op te geven .txt. De parameter Recurse doorzoekt de directory Path en de bijbehorende subdirectory's, zoals weergegeven in de Directory: koppen. Met de parameter Force worden verborgen bestanden weergegeven, zoals hiddenfile.txt met modus h.

Voorbeeld 4: Subitems ophalen met de parameter Opnemen

In dit voorbeeld gebruikt Get-ChildItem de parameter Include om specifieke items te vinden 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 parameter Path 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 Opnemen maakt gebruik van een asterisk (*) als wildcard om alle bestanden met de bestandsnaamextensie .txtop te geven.

Wanneer de parameter Include wordt gebruikt, heeft de parameter Path een volgsterretje (*) 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 sterretje achteraan (*) in de parameter Pad optioneel. Met de parameter Recurse worden items opgehaald uit de map Path en de bijbehorende submappen. Bijvoorbeeld -Path C:\Test\ -Recurse -Include *.txt
Als een sterretje (*) niet is opgenomen in de parameter Path, geeft de opdracht geen uitvoer en keert deze terug naar de PowerShell-prompt. Bijvoorbeeld -Path C:\Test\.

Voorbeeld 5: Sub-items ophalen met de Exclude-parameter

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 Uitsluiten 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 parameter Path 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 volgsterretje (*) 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 Path parameter. 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 uitvoer van recursie hetzelfde, ongeacht of de parameter Pad een volgsterretje (*) bevat.

Voorbeeld 6: Registersleutels ophalen uit een registerbijenkorf

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

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

Zie about_Registry_Providervoor 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 registersleutel HKLM:\HARDWARE weergegeven. De parameter Uitsluiten geeft Get-ChildItem de opdracht geen subsleutels die beginnen met D*te retourneren. Op dit moment werkt de parameter Uitsluiten alleen op subsleutels, niet op itemeigenschappen.

Voorbeeld 7: Haal alle certificaten op met code-ondertekeningsbevoegdheid

In dit voorbeeld wordt elk certificaat met code-ondertekening in het PowerShell-Cert:-station opgehaald.

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

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

Voor meer informatie over de certificaatprovider en de Cert:-schijf, zie about_Certificate_Provider.

Voorbeeld 8: Items ophalen met de parameter Diepte

In dit voorbeeld worden de items in een map en de bijbehorende submappen weergegeven. De parameter Depth bepaalt het aantal subniveau's dat wordt 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 C:\Parentop te geven. De parameter Depth geeft twee niveaus van recursie aan. 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- zijn de bestandsmachtigingen zoals weergegeven op een Unix-systeem
gebruiker de eigenaar van het bestand is
groep is de groepseigenaar
Grootte de grootte is 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 FileSystem provider.

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, ReadOnlyen System.

De parameter Kenmerken ondersteunt de volgende eigenschappen:

archiveren
gecomprimeerde
Apparaat
Directory-
Versleutelde
verborgen
IntegrityStream
Normale
NoScrubData
NietContentGeïndexeerd
offline
Alleen-lezen
ReparsePoint
Schaars bestand
System
tijdelijke

Zie de FileAttributes opsomming voor een beschrijving van deze kenmerken.

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

! (NIET)
+ (AND)
, (OR)

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

Gebruik de parameter Code Signing om een lijst op te halen van certificaten die in hun EnhancedKeyUsageList eigenschapswaarde hebben.

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. Standaard geeft Get-ChildItem de inhoud van de bovenliggende map weer. De parameter Depth bepaalt het aantal submapniveaus die bij de recursie zijn inbegrepen en geeft de inhoud weer.

-Depth 2 bevat bijvoorbeeld de map Path parameter, 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.exekunt 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 FileSystem provider.

Als u een lijst met mappen wilt ophalen, gebruikt u de parameter Directory of de parameter Attributes 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 Certificate-provider.

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 Unicode of ASCIIzijn. 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 Certificate-provider.

Als u een lijst met certificaten met Document Encryption in hun EnhancedKeyUsageList eigenschapswaarde wilt ophalen, gebruikt u de parameter DocumentEncryptionCert.

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

-Eku

Notitie

Deze parameter is alleen beschikbaar in de Certificate-provider.

Hiermee geeft u tekst of een tekstpatroon op dat overeenkomt met de eigenschap EnhancedKeyUsageList van certificaten die de cmdlet ophaalt. Jokertekens (*) zijn toegestaan. De eigenschap EnhancedKeyUsageList bevat de gebruiksvriendelijke 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 lijst op van een of meer tekenreekspatronen die moeten worden vergeleken wanneer de cmdlet subitems 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 parameter Path is optioneel. Bijvoorbeeld -Path C:\Test\Logs of -Path C:\Test\Logs\*. Als een volgsterretje (*) is opgenomen, wordt de opdracht teruggeleid naar de submappen van de Path parameter. Zonder het sterretje (*), wordt de inhoud van de parameter Path weergegeven. Meer informatie vindt u in voorbeeld 5 en de sectie Notities.

De Include en Exclude parameters kunnen samen worden gebruikt. De uitsluitingen worden echter toegepast na de opnamen, wat van invloed kan zijn op het uiteindelijke resultaat.

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

-ExpiringInDays

Notitie

Deze parameter is alleen beschikbaar in de Certificate-provider.

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

Gebruik de parameter File 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 parameter Path 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 ondersteunt alleen * 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 FileSystem provider.

Standaard worden in de Get-ChildItem-cmdlet symbolische koppelingen naar mappen weergegeven die tijdens recursie zijn gevonden, maar er wordt niet in deze mappen gereciteerd. 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 het bestandssysteem provider.

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 overschrijdt geen beveiligingsbeperkingen. De implementatie varieert per provider. Zie about_Providersvoor 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 FileSystem provider.

Als u alleen verborgen items wilt ophalen, gebruikt u de parameter Verborgen of de parameter Kenmerken met de eigenschap Verborgen. Standaard worden verborgen items niet weergegeven Get-ChildItem. 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 lijst op van een of meer tekenreekspatronen die moeten worden vergeleken wanneer de cmdlet subitems 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 Include en Exclude parameters kunnen samen worden gebruikt. De uitsluitingen worden echter toegepast na de opnamen, wat van invloed kan zijn op het uiteindelijke resultaat.

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

-LiteralPath

Hiermee specificeert u een pad naar een of meer locaties. De waarde van LiteralPath- wordt precies gebruikt zoals deze is getypt. Er worden geen tekens geïnterpreteerd als jokertekens. Als het pad escape-tekens bevat, zet het dan tussen enkele aanhalingstekens. Enkele aanhalingstekens geven aan PowerShell door dat geen tekens als escape-sequenties worden geïnterpreteerd.

Zie about_Quoting_Rulesvoor 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 tekenreeks die naar de pijplijn kan worden verzonden voor andere commando's. 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 specificeert u een pad naar een of meer locaties. Wildcards 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 FileSystem provider.

Als u alleen-lezenitems wilt ophalen, gebruikt u de parameter ReadOnly of de parameter Attributes met de eigenschap 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, r
Position:	Named
Default value:	False
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-SSLServerAuthentication

Notitie

Deze parameter is alleen beschikbaar in de Certificate-provider.

Als u een lijst met certificaten wilt ophalen met Server Authentication in de eigenschapswaarde EnhancedKeyUsageList, gebruikt u de parameter SSLServerAuthentication.

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

-System

Notitie

Deze parameter is alleen beschikbaar in de FileSystem provider.

Haalt alleen systeembestanden en mappen op. Als u alleen systeembestanden en mappen wilt ophalen, gebruikt u de parameter System of Attributes parameter System eigenschap.

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

Invoerwaarden

String

U kunt een tekenreeks die een pad naar deze cmdlet bevat, doorgeven.

Uitvoerwaarden

AliasInfo

De cmdlet geeft dit type als uitvoer bij toegang tot station Alias:.

X509StoreLocation

X509Store

X509Certificate2

De cmdlet geeft deze typen weer bij het benaderen van het Cert:-station.

DictionaryEntry

De cmdlet geeft dit type als uitvoer bij toegang tot station Env:.

DirectoryInfo

FileInfo

De cmdlet geeft deze typen weer wanneer toegang wordt verkregen tot de bestandssysteemstations.

FunctionInfo

FilterInfo

De cmdlet geeft deze typen weer bij toegang tot de Function: stations.

RegistryKey

De cmdlet voert dit type uit bij het benaderen van de registerdrives.

PSVariable

De cmdlet geeft dit type weer bij toegang tot de Variable: stations.

WSManConfigContainerElement

WSManConfigLeafElement

De cmdlet geeft deze typen weer bij toegang tot 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
Ramen:
- ls

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

De cmdlet Get-ChildItem 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 u Get-PSProvider. Zie about_Providersvoor meer informatie.

Delen via

Get-ChildItem

Syntaxis

Description

Voorbeelden

Voorbeeld 1: Subitems ophalen uit een map in het bestandssysteem

Voorbeeld 2: Subitemnamen verkrijgen in een map

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

Voorbeeld 4: Subitems ophalen met de parameter Opnemen

Voorbeeld 5: Sub-items ophalen met de Exclude-parameter

Voorbeeld 6: Registersleutels ophalen uit een registerbijenkorf

Voorbeeld 7: Haal alle certificaten op met code-ondertekeningsbevoegdheid

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