Get-ChildItem

Module:
Microsoft.PowerShell.Management Module

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

Syntax

Items (Standaard) 

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

LiteralItems 

Get-ChildItem
    [[-Filter] <string>]
    -LiteralPath <string[]>
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Recurse]
    [-Depth <uint32>]
    [-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. 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.

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 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 map Pad de submappen, zoals wordt 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 Include gebruikt een sterretje (*) 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 gebruikt het jokerteken sterretje (*) om bestanden of mappen op te geven die beginnen met A of een worden uitgesloten van de uitvoer.

Wanneer de parameter Uitsluiten wordt gebruikt, is een volgsterretje (*) in de parameter Path optioneel. Een voorbeeld hiervan is -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 opgehaald in het PowerShell-certificaat: station met een codeondertekeningsbevoegdheid.

De cmdlet Get-ChildItem 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 haalt alleen certificaten op die code-ondertekeningsbevoegdheid hebben.

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

Zie about_Certificate_Providervoor 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 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 is de eigenaar van het bestand
  • groep is de groepseigenaar
  • Grootte de grootte is van het bestand of de map, zoals weergegeven op een Unix-systeem

Opmerking

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

Parameters

-Attributes

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
  • Directorie
  • Versleutelde
  • verborgen
  • IntegrityStream
  • Normaal
  • NoScrubData
  • NietInhoudGeïndexeerd-
  • Offline
  • Alleen-lezen
  • ReparsePoint
  • Schaars bestand
  • Systeem
  • tijdelijke

Zie de FileAttributes Enumerationvoor 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)

Parametereigenschappen

Type:

FlagsExpression<T>[FileAttributes]

Default value:None
Geaccepteerde waarden:Archive, Compressed, Device, Directory, Encrypted, Hidden, IntegrityStream, Normal, NoScrubData, NotContentIndexed, Offline, ReadOnly, ReparsePoint, SparseFile, System, Temporary
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Opmerking

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

Parametereigenschappen

Type:UInt32
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Directory

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.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:advertentie, d

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-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. Een voorbeeld hiervan is -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.

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:True
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-File

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

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:af

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:True
DontShow:False

Parametersets

(All)
Position:1
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-FollowSymlink

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
Default value:None
Ondersteunt jokertekens:False
DontShow:False
(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Hidden

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.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:ah, h

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:True
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-LiteralPath

Specificeert 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.

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:PSPath, LP

Parametersets

LiteralItems
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten: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. Wildcards zijn toegestaan.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:True
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Path

Specificeert een pad naar een of meer locaties. Wildcards worden geaccepteerd. De standaardlocatie is de huidige map (.).

Parametereigenschappen

Type:

String[]

Default value:Current directory
Ondersteunt jokertekens:True
DontShow:False

Parametersets

Items
Position:0
Verplicht:False
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-ReadOnly

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

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Ar

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Recurse

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

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:s

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-System

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

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:als

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

String

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

Uitvoerwaarden

Object

Het type object dat Get-ChildItem retourneert, wordt bepaald door de objecten in het stationspad van de provider.

String

Als u de parameter Name gebruikt, retourneert Get-ChildItem de objectnamen als tekenreeksen.

Notities

  • Get-ChildItem kan worden uitgevoerd met een van de ingebouwde aliassen, ls, dir, en gci. Zie about_Aliasesvoor meer informatie.
  • 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.