Get-ChildItem

Modul:

Microsoft.PowerShell.Management Module

Lekéri az elemeket és a gyermekelemeket egy vagy több megadott helyen.

Syntax

Items (Alapértelmezett)

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

A Get-ChildItem parancsmag lekéri az elemeket egy vagy több megadott helyen. Ha az elem egy tároló, a tárolóban lévő elemeket, más néven gyermekelemeket kapja meg. A Recurse paraméter használatával lekérheti az elemeket az összes gyermektárolóban, és a Mélység paraméter használatával korlátozhatja a rekurzívan bejárandó szintek számát.

Get-ChildItem nem jelenít meg üres könyvtárakat. Ha egy Get-ChildItem parancs tartalmazza a Mélységi vagy Recurse paramétereket, a kimenet nem tartalmaz üres könyvtárakat.

A helyszínek a PowerShell-szolgáltatók által a Get-ChildItem-nek vannak kitéve. A hely lehet fájlrendszerkönyvtár, beállításjegyzék-hive vagy tanúsítványtároló. További információért lásd a about_Providerscímű részt.

Példák

1. példa: Gyermekelemek lekérése fájlrendszerkönyvtárból

Ez a példa lekéri az alárendelt elemeket egy fájlrendszer könyvtárból. Ekkor megjelennek a fájlnevek és az alkönyvtárnevek. Üres helyek esetén a parancs nem ad vissza kimenetet, és visszakerül a PowerShell-parancssorba.

A Get-ChildItem parancsmag a Path paramétert használja a címtár C:\Testmegadásához. Get-ChildItem megjeleníti a fájlokat és könyvtárakat a PowerShell-konzolon.

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

Alapértelmezés szerint Get-ChildItem felsorolja a módot (Attribútumok), LastWriteTime, a fájlméretet (Hossz), valamint az elem név. A Mód tulajdonság betűi a következőképpen értelmezhetők:

• l (hivatkozás)
• d (könyvtár)
• a (archívum)
• r (írásvédett)
• h (rejtett)
• s (rendszer).

A módjelzőkkel kapcsolatos további információkért lásd: about_Filesystem_Provider.

2. példa: Gyermekelemnevek lekérése egy könyvtárban

Ez a példa csak a címtárban lévő elemek nevét sorolja fel.

A Get-ChildItem parancsmag a Path paramétert használja a címtár C:\Testmegadásához. A Név paraméter csak a megadott elérési út fájl- vagy könyvtárneveit adja vissza.

Get-ChildItem -Path C:\Test -Name

Logs
anotherfile.txt
Command.txt
CreateTestFile.ps1
ReadOnlyFile.txt

3. példa: Gyermekelemek lekérése az aktuális könyvtárban és alkönyvtárakban

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

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

A Get-ChildItem parancsmag a Path paramétert használja a C:\Test\*.txtmegadásához. Elérési út a csillag (*) helyettesítő karakterrel adja meg a .txtfájlnévkiterjesztéssel rendelkező összes fájlt. A Recurse paraméter a Elérési út könyvtár alkönyvtáraiban keres, ahogyan az a könyvtárban: címsorokban látható. A Force paraméter olyan rejtett fájlokat jelenít meg, mint például a hiddenfile.txt, amelyek h.

4. példa: Gyermekelemek lekérése az Include paraméterrel

Ebben a példában Get-ChildItem a Belefoglalás paramétert használja a Elérési út paraméter által megadott könyvtár egyes elemeinek megkereséséhez.

# 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

A parancsmag a Path paramétert használja a C:\Testkönyvtár megadásához. A Elérési út paraméter tartalmaz egy záró csillag (*) helyettesítő karaktert a könyvtár tartalmának megadásához. Az Include paraméter csillag (*) helyettesítő karaktert használ a .txtfájlnévkiterjesztéssel rendelkező összes fájl megadásához.

A Include paraméter használatakor a Path paraméternek egy záró csillag (*) helyettesítő karakterre van szüksége a könyvtár tartalmának megadásához. Például: -Path C:\Test\*.

• Ha a parancshoz hozzáadja a Recurse paramétert, a * paraméter végén lévő csillag () opcionális. A Recurse paraméter a Elérési út könyvtárból és annak alkönyvtáraiból szerzi be az elemeket. Például: -Path C:\Test\ -Recurse -Include *.txt
• Ha egy záró csillag (*) nem szerepel a Elérési út paraméterben, a parancs nem ad vissza kimenetet, és visszakerül a PowerShell-parancssorba. Például: -Path C:\Test\.

5. példa: Gyermekelemek lekérése a Kizárás paraméterrel

A példa kimenete a C:\Test\Logskönyvtár tartalmát mutatja . A kimenet hivatkozás a többi parancshoz, amelyek a Kizár és Rekurzió paramétereket használják.

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

A Get-ChildItem parancsmag a Path paramétert használja a címtár C:\Test\Logsmegadásához. A Kizárás paraméter a csillag () helyettesítő karakterrel adja meg azokat a fájlokat vagy könyvtárakat, amelyek egy vagy egy kezdődnek, ki lesznek zárva a kimenetből.

Ha a Kizárás paramétert használja, a * paraméterben a záró csillag () opcionális. Például, -Path C:\Test\Logs vagy -Path C:\Test\Logs\*.

• Ha a * paraméter nem tartalmaz záró csillagot (), megjelenik a Elérési út paraméter tartalma. A kivételek azok a fájlnevek vagy alkönyvtárnevek, amelyek megfelelnek a paraméter értékével való kizárás feltételének.
• Ha egy záró csillag (*) szerepel a Path paraméterben, a parancs újra megjelenik a Path paraméter alkönyvtáraiban. A kivételek azok a fájlnevek vagy alkönyvtárnevek, amelyek megfelelnek a paraméter értékével való kizárás feltételének.
• Ha a parancshoz hozzáadja a Recurse paramétert, a rekurzió kimenete megegyezik attól, hogy az Elérési út paraméter tartalmaz-e záró csillagot (*).

6. példa: A beállításkulcsok lekérése egy beállításjegyzék-hive-ből

Ez a példa lekéri az összes beállításkulcsot HKEY_LOCAL_MACHINE\HARDWARE-ból.

Get-ChildItem a Path paramétert használja a beállításkulcs HKLM:\HARDWAREmegadásához. A hive elérési útja és a beállításkulcsok legfelső szintje megjelenik a PowerShell-konzolon.

Az about_Registry_Providerdokumentumban további információ található.

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

Az első parancs megjeleníti a HKLM:\HARDWARE beállításkulcs tartalmát. A Kizárás paraméter arra utasítja Get-ChildItem, hogy ne adja vissza a D*kezdetű alkulcsokat. A Kizárás paraméter jelenleg csak alkulcsokon működik, elemtulajdonságokon nem.

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

Ez a példa lekéri a kódaláíró jogosultsággal rendelkező PowerShell-tanúsítvány: meghajtó összes tanúsítványát.

A Get-ChildItem parancsmag a Path paraméter használatával adja meg a Tanúsítvány: szolgáltatót. A Recurse paraméter a Elérési út által megadott könyvtárat és annak alkönyvtárait keresi. A CodeSigningCert paraméter csak olyan tanúsítványokat tartalmaz, amelyek kódaláíró jogosultsággal bírnak.

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

További információ a tanúsítványszolgáltatóról és a Tanúsítvány: meghajtóról: about_Certificate_Provider.

8. példa: Elemek lekérése a Mélység paraméterrel

Ez a példa egy könyvtár elemeit és alkönyvtárait jeleníti meg. A Depth paraméter határozza meg a rekurzió során figyelembe veendő alkönyvtárszintek szintjét. Az üres könyvtárak ki vannak zárva a kimenetből.

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

A Get-ChildItem parancsmag a Elérési út paramétert használja C:\Parentmegadásához. A Depth paraméter két rekurziós szintet határoz meg. Get-ChildItem megjeleníti a Path paraméter és az alkönyvtárak két szintje által megadott könyvtár tartalmát.

9. példa: A kemény hivatkozás adatainak lekérése

A PowerShell 6.2-ben alternatív nézet került hozzáadásra a kemény hivatkozás adatainak lekéréséhez.

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

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

A Unix-rendszereken futó PowerShell 7.1-ben a Get-ChildItem Unix-szerű kimenetet biztosít:

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

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

• UnixMode a Unix-rendszeren ábrázolt fájlengedélyek
• felhasználói a fájl tulajdonosa
• csoport a csoport tulajdonosa
• mérete a Unix-rendszeren ábrázolt fájl vagy könyvtár mérete

Megjegyzés:

Ezt a funkciót a PowerShell 7.1-ben a kísérleti verzióról a mainstreamre helyezték át.

11. példa – Csomópont hivatkozási céljának lekérése

A Windows command Shell dir parancsa megjeleníti a fájlrendszer csatlakozási pontjának célhelyét. A PowerShellben ez az információ a által visszaadott fájlrendszerobjektum Get-ChildItem tulajdonságából érhető el, és az alapértelmezett kimenetben jelenik meg.

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

Paraméterek

-Attributes

Lekéri a megadott attribútumokkal rendelkező fájlokat és mappákat. Ez a paraméter támogatja az összes attribútumot, és lehetővé teszi az attribútumok összetett kombinációjának megadását.

Ha például titkosított vagy tömörített rendszer nélküli fájlokat (nem könyvtárakat) szeretne lekérni, írja be a következőt:

Get-ChildItem -Attributes !Directory+!System+Encrypted, !Directory+!System+Compressed

A gyakran használt attribútumokkal rendelkező fájlok és mappák kereséséhez használja az Attribútumok paramétert. Vagy a címtár , fájl, Rejtett, ReadOnlyés Rendszerparamétereket.

Az attribútumok paraméter a következő tulajdonságokat támogatja:

• Archívum
• tömörített
• Eszköz
• Címtár
• Titkosított
• rejtett
• IntegrityStream
• Normális
• NoScrubData
• Nem tartalomindexelt
• Offline
• Csak olvasható
• ReparsePoint
• SparseFile
• Rendszer
• ideiglenes

Ezeknek az attribútumoknak a leírását a FileAttributes Enumerationcímű cikkben talál.

Az attribútumok kombinálásához használja a következő operátorokat:

• ! (NEM)
• + (ÉS)
• , (VAGY)

Ne használjon szóközöket egy operátor és attribútuma között. A vesszők után szóközök elfogadhatók.

Gyakori attribútumok esetén használja a következő rövidítéseket:

• D (címtár)
• H (rejtett)
• R (írásvédett)
• S (rendszer)

Paramétertulajdonságok

Típus:	FlagsExpression<T>[FileAttributes]
Alapértelmezett érték:	None
Elfogadott értékek:	Archive, Compressed, Device, Directory, Encrypted, Hidden, IntegrityStream, Normal, NoScrubData, NotContentIndexed, Offline, ReadOnly, ReparsePoint, SparseFile, System, Temporary
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Depth

Ez a paraméter a PowerShell 5.0-s verziójában lett hozzáadva, és lehetővé teszi a rekurzió mélységének szabályozását. Alapértelmezés szerint Get-ChildItem megjeleníti a szülőkönyvtár tartalmát. A Depth paraméter határozza meg a rekurzióban szereplő alkönyvtárszintek számát, és megjeleníti a tartalmat.

A Depth 2 például tartalmazza a Elérési út paraméter könyvtárát, az alkönyvtárak első szintjét és az alkönyvtárak második szintjét. A kimenet alapértelmezés szerint könyvtárneveket és fájlneveket tartalmaz.

Megjegyzés:

A PowerShell-ből vagy cmd.exewindowsos számítógépen megjelenítheti a könyvtárszerkezet grafikus nézetét a tree.com paranccsal.

Paramétertulajdonságok

Típus:	UInt32
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Directory

A címtárak listájának lekéréséhez használja a Címtár paramétert vagy a Attribútumok paramétert a Directory tulajdonsággal. A Recurse paramétert használhatja Directory.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	hirdetés, d

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Exclude

Egy vagy több karakterlánc mintát tartalmazó tömböt ad meg, amely(ek) a cmdlet-parancsmag gyermekelemek beolvasása során egyeztetendők. Az egyező elemek ki vannak zárva a kimenetből. Adjon meg egy elérési út elemet vagy mintát, például *.txt vagy A*. A helyettesítő karaktereket a rendszer elfogadja.

A * paraméter végén lévő csillag () megadása nem kötelező. Például, -Path C:\Test\Logs vagy -Path C:\Test\Logs\*. Ha egy záró csillagot (*) tartalmaz, a parancs rekurzívan belép a elérési út paraméterének alkönyvtáraiba. A csillag (*) nélkül a Elérési út paraméter tartalma jelenik meg. További részletek az 5. példában és a Megjegyzések szakaszban találhatók.

A Beillesztés és Kizárás paraméterek együtt használhatók. A kizárások azonban a belefoglalások után lesznek alkalmazva, ami befolyásolhatja a végső kimenetet.

Paramétertulajdonságok

Típus:	String[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	True
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-File

A fájlok listájának lekéréséhez használja a Fájl paramétert. A Recurse paramétert használhatja Fájl.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	af

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Filter

Szűrőt ad meg a útvonal paraméter minősítéséhez. A Fájlrendszer szolgáltató az egyetlen telepített PowerShell-szolgáltató, amely támogatja a szűrőket. A szűrők hatékonyabbak, mint a többi paraméter. A szolgáltató akkor alkalmazza a szűrőt, ha a parancsmag lekéri az objektumokat ahelyett, hogy a PowerShell a lekérés után szűri az objektumokat. A szűrőkarakterláncot a fájlok felsorolásához továbbítják a .NET API-nak. Az API csak * és ? helyettesítő karaktereket támogat.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	True
DontShow:	False

Paraméterkészletek

(All)

Position:	1
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-FollowSymlink

Alapértelmezés szerint a Get-ChildItem parancsmag a rekurzió során talált könyvtárakra mutató szimbolikus hivatkozásokat jelenít meg, de nem ismétlődik bennük. A FollowSymlink paraméter használatával keresse meg azokat a könyvtárakat, amelyek ezeket a szimbolikus hivatkozásokat célják. A FollowSymlink egy dinamikus paraméter, és csak a FileSystem szolgáltató támogatja.

Ezt a paramétert a PowerShell 6.0-ban vezettük be.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Force

Lehetővé teszi, hogy a parancsmag olyan elemeket szerezzen be, amelyeket egyébként nem tud elérni a felhasználó, például rejtett vagy rendszerfájlokat. A Force paraméter nem bírálja felül a biztonsági korlátozásokat. A megvalósítás a szolgáltatók között eltérő. További információért lásd a about_Providerscímű részt.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Hidden

Ha csak rejtett elemeket szeretne lekérni, használja a Rejtett paramétert vagy az Attribútumok paramétert a Rejtett tulajdonsággal. Alapértelmezés szerint a Get-ChildItem nem jeleníti meg a rejtett elemeket. A rejtett elemek lekéréséhez használja a Force paramétert.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	ah, h

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Include

Egy vagy több karakterlánc mintát tartalmazó tömböt ad meg, amely(ek) a cmdlet-parancsmag gyermekelemek beolvasása során egyeztetendők. A kimenet minden egyező elemet tartalmaz. Adjon meg egy elérési út elemet vagy mintát, például "*.txt". A helyettesítő karakterek használata engedélyezett. Az Include paraméter csak akkor érvényes, ha a parancs egy elem tartalmát tartalmazza, például C:\Windows\*, ahol a helyettesítő karakter a C:\Windows könyvtár tartalmát adja meg.

A Beillesztés és Kizárás paraméterek együtt használhatók. A kizárások azonban a belefoglalások után lesznek alkalmazva, ami befolyásolhatja a végső kimenetet.

Paramétertulajdonságok

Típus:	String[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	True
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-LiteralPath

Egy vagy több hely elérési útját adja meg. A LiteralPath értékét pontosan a beírt módon használja a rendszer. A rendszer egyetlen karaktert sem értelmez helyettesítő karakterként. Ha az elérési útvonal escape karaktereket tartalmaz, tedd azt egyes idézőjelek közé. Az idézőjelek azt mondják a PowerShellnek, hogy ne értelmezzen karaktereket feloldósorozatként.

További információk az about_Quoting_Rules oldalon találhatók: .

Paramétertulajdonságok

Típus:	String[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	PSPath, LP

Paraméterkészletek

LiteralItems

Position:	Named
Kötelező:	True
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-Name

Csak a hely elemeinek nevét kapja meg. A kimenet egy sztringobjektum, amely elküldhető a folyamaton keresztül más parancsok számára. Helyettesítő karakterek használata engedélyezett.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	True
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Path

Egy vagy több hely elérési útját adja meg. A helyettesítő karaktereket a rendszer elfogadja. Az alapértelmezett hely az aktuális könyvtár (.).

Paramétertulajdonságok

Típus:	String[]
Alapértelmezett érték:	Current directory
Támogatja a helyettesítő karaktereket:	True
DontShow:	False

Paraméterkészletek

Items

Position:	0
Kötelező:	False
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-ReadOnly

Csak írásvédett elemek lekéréséhez használja a ReadOnly paramétert, vagy az Attribútumok paraméter ReadOnly tulajdonságot.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	Ar

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Recurse

Megszerzi az elemeket a megadott helyeken és a helyek összes gyermekelemeiben.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	s

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-System

Csak a rendszerfájlokat és könyvtárakat kapja meg. Ha csak rendszerfájlokat és mappákat szeretne lekérni, használja a System paramétert vagy Attribútumokat paramétert System tulajdonságot.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	amint

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bevitelek

String

A Get-ChildItemelérési útját tartalmazó sztringet csövezheti.

Kimenetek

Object

A Get-ChildItem visszaadott objektum típusát a szolgáltató meghajtó elérési útjának objektumai határozzák meg.

String

Ha a Név paramétert használja, Get-ChildItem sztringekként adja vissza az objektumneveket.

Jegyzetek

• Get-ChildItem A beépített aliasok bármelyikével futtatható, ls, dir, és gci. További információ: about_Aliases.
• Get-ChildItem alapértelmezés szerint nem kap rejtett elemeket. Rejtett elemek lekéréséhez használja a Force paramétert.
• A Get-ChildItem parancsmag úgy lett kialakítva, hogy bármely szolgáltató által közzétett adatokkal működjön együtt. A munkamenetben elérhető szolgáltatók listájához írja be a Get-PSProvider. További információért lásd a about_Providerscímű részt.

Kapcsolódó hivatkozások

• tanúsítvány_szolgáltató_ról
• A szolgáltatókról
• idézési szabályokról
• A rendszerleíró-szolgáltató ismertetése
• ForEach-Objektum
• Get-Alias
• Get-Item (Elem lekérése)
• Get-Location
• Get-Process
• Get-PSProvider
• Split-Path