Get-ChildItem

Syntax

Get-ChildItem <string>] <string>] >] >] >] 

Get-ChildItem <string>] -LiteralPath <string> >] >] >] 

Description

A Get-ChildItem cmdlet egy vagy több megadott helyen lévő elemeket kér le. Ha az elem egy konténer, akkor a konténerben lévő elemeket, az úgynevezett gyermekelemeket szerzi meg. A Recurseparaméterrel az összes gyermek konténerben lévő elemet megkaphatja, a Depth paraméterrel pedig korlátozhatja a visszanézendő szintek számát.

Get-ChildItem Nem jeleníti meg az üres könyvtárakat. Ha egy Get-ChildItem parancs tartalmazza aDepth vagy a Recurse paramétereket, az üres könyvtárak nem szerepelnek a kimeneten.

A PowerShell szolgáltatók a Get-ChildItem számára a helyeket teszik közzé. A hely lehet fájlrendszerkönyvtár, registry hive vagy tanúsítványtároló. További információért lásd: about_Providers.

Példák

1. példa: Gyermekelemek lekérése egy fájlrendszer könyvtárából

Ez a példa lekérdezi a gyermekelemeket egy fájlrendszer könyvtárából. Megjelennek a fájlnevek és az alkönyvtárnevek. Üres helyek esetén a parancs nem ad vissza kimenetet, és visszatér aPowerShell prompthoz.

A Get-ChildItem cmdlet a Path paramétert használja a C:\Test könyvtár megadásához.Get-ChildItemmegjeleníti a fájlokat és könyvtárakat a PowerShell konzolon.

Get-ChildItem -Path C:\TestDirectory: C:\TestMode 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

A Get-ChildItem alapértelmezés szerint a Get-ChildItem az elem módját (Attributes), LastWriteTime, fájlméretet (Length),és a nevét sorolja fel. A Mode tulajdonság betűi a következőképpen értelmezhetők:

• l (link)
• d (könyvtár)
• a (archívum)
• r (csak olvasható)
• h (rejtett)
• s (rendszer).

Az üzemmódjelzőkkel kapcsolatos további információkért lásd:about_Filesystem_Provider.

Példa 2: Gyermekelemek neveinek lekérdezése egy könyvtárban

Ez a példa csak egy könyvtárban lévő elemek neveit sorolja fel.

A Get-ChildItem cmdlet a Path paramétert használja a C:\Test könyvtár megadásához. AName paraméter csak a megadott elérési útvonalból származó fájl- vagy könyvtárneveket adja vissza.

Get-ChildItem -Path C:\Test -NameLogsanotherfile.txtCommand.txtCreateTestFile.ps1ReadOnlyFile.txt

3. példa: Az aktuális könyvtárban és alkönyvtárakban található gyermekelemek lekérdezése

Ez a példa az aktuális könyvtárban és annak alkönyvtáraiban található .txt fájlokat jeleníti meg.

Get-ChildItem -Path C:\Test\*.txt -Recurse -ForceDirectory: C:\Test\Logs\AdirectoryMode 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\BackupMode LastWriteTime Length Name---- ------------- ------ -----a---- 2/12/2019 16:16 20 ATextFile.txt-a---- 2/12/2019 15:50 20 LogFile3.txt Directory: C:\Test\LogsMode 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:\TestMode 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

A Get-ChildItem cmdlet a Path paramétert használja a C:\Test\*.txt megadásához. A Path a .txt fájlnévkiterjesztéssel rendelkező összes fájl megadásához a Masterisk (*) helyettesítő karaktert használja. A Recurseparaméter a Path könyvtárban keresi annak alkönyvtárait, ahogyan az a Directory:címsorokban látható. A Force paraméter megjeleníti az olyan rejtett fájlokat, mint például a hiddenfile.txt, amelyek h móddal rendelkeznek.

4. példa: Gyermek elemek keresése az Include paraméter használatával

Ebben a példában a Get-ChildItem az Include paramétert használja a Path paraméter által megadott könyvtár meghatározott elemeinek keresésére.

# 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 *.txtGet-ChildItem -Path C:\Test\* -Include *.txtDirectory: C:\TestMode 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

A Get-ChildItem cmdlet a Path paraméterrel a C:\Test könyvtárat adja meg. AzPath paraméter egy csillag (*)-jelet tartalmaz a könyvtár tartalmának megadásához.Az Include paraméter egy csillag (*)-jelet használ a .txt kiterjesztésű fájlnévvel rendelkező összes fájl megadásához.

Az Include paraméter használata esetén a Path paraméternek egy csillag (*)-jelre van szüksége a könyvtár tartalmának megadásához. Például: -Path C:\Test\*.

• Ha a parancs a Recurse paraméterrel egészül ki, a Pathparaméterben lévő utolsó csillag (*) opcionális. A Recurse paraméter a Path könyvtárból és annak alkönyvtáraiból kapja az elemeket. Például: -Path C:\Test\ -Recurse -Include *.txt
• Ha a Path paraméterben nem szerepel az utolsó csillag (*), a parancs nem ad vissza semmilyen kimenetet, és visszatér a PowerShell prompthoz. Például: -Path C:\Test\.

5. példa: Gyermekelemek lekérése az Exclude paraméter használatával

A példa kimenete a C:\Test\Logs könyvtár tartalmát mutatja. A kimenet referenciaként szolgál az Exclude és Recurse paramétereket használó többi parancshoz.

Get-ChildItem -Path C:\Test\LogsDirectory: C:\Test\LogsMode LastWriteTime Length Name---- ------------- ------ ----d----- 2/15/2019 13:21 Adirectoryd----- 2/15/2019 08:28 AnEmptyDirectoryd----- 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.logGet-ChildItem -Path C:\Test\Logs\* -Exclude A*Directory: C:\Test\LogsMode 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

A Get-ChildItem cmdlet a Path paramétert használja a C:\Test\Logs könyvtár megadásához.Az Exclude paraméter a csillag (*) helyettesítő karaktert használja a kimenetből kizárt fájlok vagy könyvtárak megadásához, amelyek A vagy a kezdőbetűvel kezdődnek.

Az Exclude paraméter használatakor a Path paraméterben az utolsó csillag (*) opcionális. Például: -Path C:\Test\Logs vagy -Path C:\Test\Logs\*.

• Ha a Path paraméterben nem szerepel az utolsó csillag (*), akkor a Path paraméter tartalma jelenik meg. Kivételt képeznek azok a fájlnevek vagy alkönyvtárak nevei, amelyek megfelelnek azExclude paraméter értékének.
• Ha a Path paraméterben szerepel egy záró csillag (*), a parancs aPath paraméter alkönyvtáraiban keres. Kivételt képeznek az olyan fájlnevek vagy alkönyvtárak nevei, amelyek megfelelnek az Exclude paraméter értékének.
• Ha a parancshoz hozzáadjuk a Recurse paramétert, a rekurzió kimenete ugyanaz lesz, függetlenül attól, hogy a Path paraméter tartalmaz-e egy záró csillagot (*) vagy sem.

6. példa: A beállításkulcsok lekérdezése egy beállítási állományból

Ez a példa az összes beállításkulcsot lekérdezi a HKEY_LOCAL_MACHINE\HARDWARE-ről.

Get-ChildItem A Path paramétert a HKLM:\HARDWARE beállításkulcs megadására használja. A Thehive elérési útvonala és a beállításkulcsok legfelső szintje megjelenik a PowerShell konzolon.

Bővebb információért lásd: about_Registry_Provider.

Get-ChildItem -Path HKLM:\HARDWAREHive: HKEY_LOCAL_MACHINE\HARDWAREName Property---- --------ACPIDESCRIPTIONDEVICEMAPRESOURCEMAPUEFIGet-ChildItem -Path HKLM:\HARDWARE -Exclude D*Hive: HKEY_LOCAL_MACHINE\HARDWAREName Property---- --------ACPIRESOURCEMAP

Az első parancs a HKLM:\HARDWARE beállításkulcs tartalmát mutatja. Az Exclude paraméter megadja, hogy a Get-ChildItem ne adja vissza a D* kezdetű alkulcsokat. Jelenleg az Excludeparaméter csak az alkulcsokra működik, az elemtulajdonságokra nem.

7. példa: Minden kódaláírási jogosultsággal rendelkező tanúsítvány lekérése

Ez a példa a PowerShell Cert: meghajtójában található minden olyan tanúsítványt lekérdez, amely kódaláírási jogosultsággal rendelkezik.

A Get-ChildItem cmdlet a Path paramétert használja a Cert: szolgáltató megadásához. ARecurse paraméter a Path által megadott könyvtárban és annak alkönyvtáraiban keres. ACodeSigningCert paraméter csak a kódaláírási jogosultsággal rendelkező tanúsítványokat szerzi be.

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

A tanúsítványszolgáltatóval és a Cert: meghajtóval kapcsolatos további információkért lásd: about_Certificate_Provider.

8. példa: Elemek lekérése a Depth paraméter használatával

Ez a példa egy könyvtárban és annak alkönyvtáraiban lévő elemeket jeleníti meg. A Depth paramétermeghatározza a rekurzióba bevonni kívánt alkönyvtárszintek számát. Az üres könyvtárak kizárásra kerülnek a kimenetből.

Get-ChildItem -Path C:\Parent -Depth 2Directory: C:\ParentMode LastWriteTime Length Name---- ------------- ------ ----d----- 2/14/2019 10:24 SubDir_Level1-a---- 2/13/2019 08:55 26 file.txt Directory: C:\Parent\SubDir_Level1Mode 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_Level2Mode LastWriteTime Length Name---- ------------- ------ ----d----- 2/14/2019 10:22 SubDir_Level3-a---- 2/13/2019 08:55 26 file.txt

A Get-ChildItem cmdlet a Path paramétert használja a C:\Parent megadásához. A Depthparaméter a rekurzió két szintjét határozza meg. A Get-ChildItemmegjeleníti a Path paraméter által meghatározott könyvtár tartalmát és az alkönyvtárak két szintjét.

9. példa: Keménykapcsolati információk lekérdezése

A PowerShell 6.2-ben egy alternatív nézet került hozzá a keménykapcsolati információk lekérdezéséhez.

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

10. példa: Kimenet nem Windows operációs rendszerekhez

A PowerShell 7-ben.1 Unix rendszereken a Get-ChildItem Unix-szerű kimenetet biztosít:

PS> Get-ChildItem /etc/r*Directory: /etcUnixMode 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.netbootlrwxr-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

A kimenet részét képező új tulajdonságok a következők:

• UnixMode a Unix rendszeren ábrázolt fájlengedélyek
• User a fájl tulajdonosa
• Group a csoport tulajdonosa
• Size a fájl vagy könyvtár mérete a Unix rendszeren ábrázolt méret

Paraméterek

Inputs

String

Az Get-ChildItem-hoz egy útvonalat tartalmazó karakterláncot pipálhat.

Kimenetek

Objekt

Az Get-ChildItem által visszaadott objektum típusát a szolgáltató meghajtóútjában lévő objektumok határozzák meg.

String

A Name paraméter használata esetén a Get-ChildItem az objektumok nevét karakterláncként adja vissza.

Jegyzetek

• A Get-ChildItem a beépített aliasok bármelyikével, ls, dir és gci futtatható. További információért lásd: about_Aliases.
• Get-ChildItem alapértelmezés szerint nem kap rejtett elemeket. A rejtett elemek lekérdezéséhez használja a Forceparamétert.
• A Get-ChildItem cmdletet úgy tervezték, hogy bármely szolgáltató által közzétett adatokkal dolgozhasson. A munkamenetben elérhető szolgáltatók listájához írja be a Get-PSProvider parancsot.További információért lásd: about_Providers.

• about_Certificate_Provider
• about_Providers
• about_Quoting_Rules
• about_Registry_Provider
• ForEach…Object
• Get-Alias
• Get-Item
• Get-Location
• Get-Process
• Get-PSProvider
• Split-Path