Get-ChildItem

Referentie

Module:: Microsoft.PowerShell.Management

Hiermee worden de items en onderliggende items op een of meer opgegeven locaties opgeslagen.

Syntax

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

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

Description

Met Get-ChildItem de cmdlet worden de items op een of meer opgegeven locaties opgeslagen. 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 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 door Get-ChildItem PowerShell-providers. Een locatie kan een bestandssysteemmap, register-hive of een certificaatarchief zijn. 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 deze terug naar de PowerShell-prompt.

De Get-ChildItem cmdlet maakt gebruik van 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 wordt de modus (Attributes), LastWriteTime, de bestandsgrootte (Lengte) en de naam van het item weergegeven. De letters in de eigenschap Modus kunnen als volgt worden geïnterpreteerd:

l (koppeling)
d (directory)
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 maakt gebruik van de padparameter om de map C:\Testop te geven. De parameter Name retourneert alleen de bestands- of mapnamen van het opgegeven pad.

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 C:\Test\*.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 jokerteken sterretje (*) om alle bestanden met de bestandsnaamextensie .txtop te geven. De parameter Recurse doorzoekt de map Path de submappen, zoals wordt weergegeven in de map Directory: 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 Opnemen 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 parameter Path om de map C:\Test op te geven. De parameter Path bevat een volgsterretje (*) jokerteken om de inhoud van de map op te geven. De parameter Opnemen maakt gebruik van een sterretje (*) jokerteken om alle bestanden met de bestandsnaamextensie op te geven .txt.

Wanneer de parameter Opnemen 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 recurse-parameter wordt toegevoegd aan de opdracht, is het volgsterretje (*) in de parameter Path 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 achterliggend sterretje (*) niet is opgenomen in de parameter Path , retourneert de opdracht geen uitvoer en keert 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 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 maakt gebruik van de padparameter om de map C:\Test\Logsop te geven. De parameter Uitsluiten gebruikt het jokerteken sterretje (*) om bestanden of mappen op te geven die beginnen met A of een die 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 submappen die overeenkomen met de waarde van de parameter Uitsluiten .
Als een achterliggend sterretje (*) is opgenomen in de parameter Path , wordt de opdracht teruggezet naar de submappen van de path-parameter . De uitzonderingen zijn bestandsnamen of submappen die overeenkomen met de waarde van de parameter Uitsluiten .
Als de recurse-parameter wordt toegevoegd aan de opdracht, is de uitvoer van de recursie hetzelfde, ongeacht of de parameter Path een sterretje (*) 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. Met de parameter Uitsluiten wordt Get-ChildItem aangegeven 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 code

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

De Get-ChildItem cmdlet gebruikt de parameter Path om het certificaat op te geven: provider. De parameter Recurse doorzoekt de map die is opgegeven door Path en de bijbehorende submappen. De parameter CodeSigningCert krijgt alleen certificaten met een instantie voor ondertekening van code.

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

Zie about_Certificate_Provider voor meer informatie over de certificaatprovider en het certificaat: 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 C:\Parent op te geven. 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: 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 Doel van het bestandssysteemobject dat wordt geretourneerd door Get-ChildItem.

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

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

Parameters

-Attributes

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

Als u bijvoorbeeld niet-systeembestanden (niet 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
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 operatoren om kenmerken te combineren:

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

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

Gebruik voor algemene kenmerken de volgende afkortingen:

D (Directory)
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
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 vanuit PowerShell of cmd.exekunt u een grafische weergave van een mapstructuur weergeven met de opdracht tree.com .

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

-Directory

Als u een lijst met mappen 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
Aliases:	ad, d
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-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 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 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 insluitingen, wat van invloed kan zijn op de uiteindelijke uitvoer.

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

-File

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

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

-Filter

Hiermee geeft u een filter om de path-parameter te kwalificeren. De bestandssysteemprovider 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 laten 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
Accept pipeline input:	False
Accept wildcard characters:	True

-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 verschilt per provider. Zie about_Providers voor meer informatie.

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

-Hidden

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
Aliases:	ah, h
Position:	Named
Default value:	None
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 include-parameter is alleen van kracht wanneer de opdracht de inhoud van een item bevat, zoalsC:\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
Accept pipeline input:	False
Accept wildcard characters:	True

-LiteralPath

Hiermee geeft u een pad naar een of meer locaties. De waarde van LiteralPath wordt precies gebruikt terwijl deze wordt getypt. Er worden geen tekens geïnterpreteerd als jokertekens. Als het pad escapetekens bevat, plaatst u het tussen enkele aanhalingstekens. Enkele aanhalingstekens stellen PowerShell in staat om geen tekens als escapereeksen te interpreteren.

Zie about_Quoting_Rules voor meer informatie.

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

-Name

Hiermee worden alleen de namen van de items op de locatie opgeslagen. De uitvoer is een tekenreeksobject dat kan worden verzonden naar de pijplijn naar andere opdrachten. Jokertekens zijn toegestaan.

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

-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
Accept pipeline input:	True
Accept wildcard characters:	True

-ReadOnly

Gebruik de parameter ReadOnlyof de eigenschapReadOnly om alleen-lezenitems op te halen.

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

-Recurse

Hiermee worden de items op de opgegeven locaties en in alle onderliggende items van de locaties opgeslagen.

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

-System

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

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

-UseTransaction

Hiermee wordt de opdracht opgenomen in de actieve transactie. Deze parameter is alleen geldig wanneer een transactie wordt uitgevoerd. Zie about_Transactions voor meer informatie.

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

Invoerwaarden

String

U kunt een tekenreeks met een pad naar Get-ChildItem.

Uitvoerwaarden

Object

Het type object dat Get-ChildItem wordt geretourneerd, wordt bepaald door de objecten in het pad naar het station van de provider.