Get-ChildItem

Referentie

Module:: Microsoft.PowerShell.Management

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

Syntax

Get-ChildItem
   [[-Path] <string[]>]
   [[-Filter] <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Recurse]
   [-Depth <uint>]
   [-Force]
   [-Name]
   [<CommonParameters>]

Get-ChildItem
   [[-Filter] <string>]
   -LiteralPath <string[]>
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Recurse]
   [-Depth <uint>]
   [-Force]
   [-Name]
   [<CommonParameters>]

Get-ChildItem
   [[-Path] <string[]>]
   [[-Filter] <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Recurse]
   [-Depth <uint>]
   [-Force]
   [-Name]
   [-CodeSigningCert]
   [-DocumentEncryptionCert]
   [-SSLServerAuthentication]
   [-DnsName <string>]
   [-Eku <string[]>]
   [-ExpiringInDays <int>]
   [<CommonParameters>]

Get-ChildItem
   [[-Filter] <string>]
   -LiteralPath <string[]>
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Recurse]
   [-Depth <uint>]
   [-Force]
   [-Name]
   [-CodeSigningCert]
   [-DocumentEncryptionCert]
   [-SSLServerAuthentication]
   [-DnsName <string>]
   [-Eku <string[]>]
   [-ExpiringInDays <int>]
   [<CommonParameters>]

Get-ChildItem
   [[-Path] <string[]>]
   [[-Filter] <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Recurse]
   [-Depth <uint>]
   [-Force]
   [-Name]
   [-Attributes <FlagsExpression[FileAttributes]>]
   [-FollowSymlink]
   [-Directory]
   [-File]
   [-Hidden]
   [-ReadOnly]
   [-System]
   [<CommonParameters>]

Get-ChildItem
   [[-Filter] <string>]
   -LiteralPath <string[]>
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Recurse]
   [-Depth <uint>]
   [-Force]
   [-Name]
   [-Attributes <FlagsExpression[FileAttributes]>]
   [-FollowSymlink]
   [-Directory]
   [-File]
   [-Hidden]
   [-ReadOnly]
   [-System]
   [<CommonParameters>]

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, ook wel onderliggende items genoemd, opgevraagd. U kunt de parameter Recurse gebruiken om items op te halen in alle onderliggende containers en de parameter Depth gebruiken om het aantal niveaus te beperken dat moet worden recurse.

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

Locaties worden weergegeven Get-ChildItem door PowerShell-providers. Een locatie kan een bestandssysteemmap, registercomponent 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 submappen worden weergegeven. Voor lege locaties retourneert de opdracht geen uitvoer en keert terug naar de PowerShell-prompt.

De Get-ChildItem cmdlet gebruikt de parameter Path 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

Standaard worden Get-ChildItem de modus (kenmerken), LastWriteTime, bestandsgrootte (lengte) en de naam van het item weergegeven. De letters in de eigenschap Mode 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 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 path-parameter .

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. Pad gebruikt het jokerteken sterretje (*) om alle bestanden met de bestandsnaamextensie .txtop te geven. De parameter Recurse doorzoekt de padmap de submappen, zoals wordt weergegeven in de koppen Directory: . De parameter Force geeft verborgen bestanden weer, zoals hiddenfile.txt die de modus h hebben.

Voorbeeld 4: onderliggende items ophalen met behulp van de parameter Include

In dit voorbeeld Get-ChildItem wordt de parameter Include gebruikt om specifieke items te zoeken in 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 path parameter bevat een afsluitend sterretje (*) jokerteken om de inhoud van de map op te geven. De include parameter gebruikt een sterretje (*) jokerteken om alle bestanden met de bestandsnaamextensie .txtop te geven.

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

Voorbeeld 5: Onderliggende items ophalen met behulp van de parameter Exclude

De uitvoer van het voorbeeld toont de inhoud van de map C:\Test\Logs. De uitvoer is een verwijzing naar 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 parameter Path om de map C:\Test\Logsop te geven. De parameter Exclude gebruikt het jokerteken sterretje (*) om bestanden of mappen op te geven die beginnen met A of a zijn uitgesloten van de uitvoer.

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

Als er geen afsluitend sterretje (*) is opgenomen in de path-parameter , wordt de inhoud van de path-parameter weergegeven. De uitzonderingen zijn bestandsnamen of namen van submappen die overeenkomen met de waarde van de parameter Exclude .
Als een afsluitend sterretje (*) is opgenomen in de path-parameter , wordt de opdracht opnieuw in de submappen van de padparameter . De uitzonderingen zijn bestandsnamen of namen van submappen die overeenkomen met de waarde van de parameter Exclude .
Als de parameter Recurse wordt toegevoegd aan de opdracht, is de recursie-uitvoer hetzelfde, ongeacht of de path-parameter een afsluitend sterretje (*) bevat.

Voorbeeld 6: De registersleutels ophalen uit een registercomponent

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

Get-ChildItem gebruikt de parameter Path om de registersleutel HKLM:\HARDWAREop te geven. Het pad van de Hive en het hoogste niveau van registersleutels 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 Exclude geeft aan Get-ChildItem dat er geen subsleutels moeten worden geretourneerd die beginnen met D*. Op dit moment werkt de parameter Exclude alleen op subsleutels, niet op itemeigenschappen.

Voorbeeld 7: Alle certificaten ophalen met de instantie voor ondertekening van code

In dit voorbeeld wordt elk certificaat in het PowerShell-station Cert: met de machtiging voor het ondertekenen van code opgeslagen.

De Get-ChildItem cmdlet gebruikt de path parameter om de certificaatprovider met het Cert: station op te geven. De parameter Recurse doorzoekt de map die is opgegeven door Pad en de bijbehorende submappen. De parameter CodeSigningCert haalt alleen certificaten op met een machtiging voor het ondertekenen van code.

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 behulp van de parameter Diepte

In dit voorbeeld worden de items in een map en de bijbehorende submappen weergegeven. De parameter Depth 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. De parameter Diepte geeft twee recursieniveaus op. Get-ChildItem geeft de inhoud weer van de map die is opgegeven door de path parameter en de twee niveaus van submappen.

Voorbeeld 9: Harde koppelingsgegevens ophalen

In PowerShell 6.2 is een alternatieve weergave toegevoegd om informatie over vaste 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 uitvoer die lijkt op Unix:

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 die worden 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-opdrachtshell 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 ophalen voor een AppX-reparsepunt

In dit voorbeeld wordt geprobeerd de doelgegevens voor een AppX-reparsepunt op te halen. Microsoft Store-toepassingen maken AppX-reparsepunten in de AppData-map 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 doelinformatie 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 met de opgegeven kenmerken opgehaald. 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 Attributes ondersteunt de volgende eigenschappen:

Archiveren
Gecomprimeerd
Apparaat
Directory
Versleuteld
Verborgen
IntegrityStream
Normaal
NoScrubData
NotContentIndexed
Offline
Readonly
ReparsePoint
SparseFile
Systeem
Tijdelijk

Zie de opsomming FileAttributes voor een beschrijving van deze kenmerken.

Gebruik de volgende operators om kenmerken te combineren:

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

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

Gebruik de volgende afkortingen voor algemene kenmerken:

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

Type:	FlagsExpression<T>[FileAttributes]
Accepted values:	Archive, Compressed, Device, Directory, Encrypted, Hidden, IntegrityStream, Normal, NoScrubData, NotContentIndexed, Offline, ReadOnly, ReparsePoint, SparseFile, System, Temporary
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CodeSigningCert

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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.exekunt u een grafische weergave van een mapstructuur weergeven met de opdracht tree.com .

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

-Directory

Notitie

Deze parameter is alleen beschikbaar in de bestandssysteemprovider .

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

-DnsName

Notitie

Deze parameter is alleen beschikbaar in de certificaatprovider .

Hiermee geeft u een domeinnaam of naampatroon op dat overeenkomt met de eigenschap DNSNameList van certificaten die de cmdlet ophaalt. De waarde van deze parameter kan of ASCIIzijnUnicode. 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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	True

-DocumentEncryptionCert

Notitie

Deze parameter is alleen beschikbaar in de certificaatprovider .

Als u een lijst met certificaten wilt ophalen die de eigenschapswaarde EnhancedKeyUsageList hebbenDocument Encryption, gebruikt u de parameter DocumentEncryptionCert.

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

-Eku

Notitie

Deze parameter is alleen beschikbaar in de certificaatprovider .

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 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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 afsluitend sterretje (*) in de path-parameter is optioneel. Bijvoorbeeld -Path C:\Test\Logs of -Path C:\Test\Logs\*. Als een afsluitend sterretje (*) is opgenomen, wordt de opdracht teruggezet 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 parameters Opnemen en Uitsluiten kunnen samen worden gebruikt. De uitsluitingen worden echter toegepast na de insluitingen, wat van invloed kan zijn op de uiteindelijke uitvoer.

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

-ExpiringInDays

Notitie

Deze parameter is alleen beschikbaar in de certificaatprovider .

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

Deze parameter is opnieuw geïntroduceerd in PowerShell 7.1

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

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

-Filter

Hiermee geeft u een filter 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 dat PowerShell de objecten filtert nadat ze 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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	True

-FollowSymlink

Notitie

Deze parameter is alleen beschikbaar in de bestandssysteemprovider .

Standaard geeft de Get-ChildItem cmdlet symbolische koppelingen weer naar mappen die zijn gevonden tijdens recursie, maar wordt er niet in herhaald. Gebruik de parameter FollowSymlink om te zoeken in de mappen die gericht zijn op deze symbolische koppelingen. 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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

Hiermee kan de cmdlet items ophalen waartoe de gebruiker anders geen toegang heeft, zoals verborgen bestanden of systeembestanden. De parameter Force overschrijft de beveiligingsbeperkingen niet. De implementatie verschilt per provider. Zie about_Providers voor meer informatie.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 . Standaard worden Get-ChildItem verborgen items niet weergegeven. Gebruik de parameter Forceren om verborgen items op te halen.

Type:	SwitchParameter
Aliases:	ah, h
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 Include 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 insluitingen, wat van invloed kan zijn op de uiteindelijke uitvoer.

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

-LiteralPath

Hiermee geeft u een pad naar een of meer locaties. De waarde van LiteralPath wordt exact gebruikt zoals deze wordt 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 geen tekens worden geïnterpreteerd als escape-reeksen.

Zie about_Quoting_Rules voor meer informatie.

Type:	String[]
Aliases:	PSPath, LP
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

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

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

-ReadOnly

Notitie

Deze parameter is alleen beschikbaar in de bestandssysteemprovider .

Als u alleen-lezenitems wilt ophalen, gebruikt u de parameter ReadOnly of de eigenschap ReadOnly van de parameter Attributes.

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

-Recurse

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

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

-SSLServerAuthentication

Notitie

Deze parameter is alleen beschikbaar in de certificaatprovider .

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

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

-System

Notitie

Deze parameter is alleen beschikbaar in de bestandssysteemprovider .

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

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

Invoerwaarden

String

U kunt een tekenreeks doorsnijden die een pad naar deze cmdlet bevat.

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 platformen:
- 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 een provider worden weergegeven. Als u de providers wilt weergeven die beschikbaar zijn in uw sessie, typt u Get-PSProvider. Zie about_Providers voor meer informatie.

Delen via

Get-ChildItem

Syntax

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 behulp van de parameter Include

Voorbeeld 5: Onderliggende items ophalen met behulp van de parameter Exclude

Voorbeeld 6: De registersleutels ophalen uit een registercomponent

Voorbeeld 7: Alle certificaten ophalen met de instantie voor ondertekening van code

Voorbeeld 8: Items ophalen met behulp van de parameter Diepte

Voorbeeld 9: Harde koppelingsgegevens ophalen

Voorbeeld 10: Uitvoer voor niet-Windows-besturingssystemen

Voorbeeld 11: Het koppelingsdoel voor een verbindingspunt ophalen

Voorbeeld 12: Het koppelingsdoel ophalen voor een AppX-reparsepunt

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