Megosztás a következőn keresztül:

Get-ChildItem

  • Referencia
Modul:
Microsoft.PowerShell.Management

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

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

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 Get-ChildItem parancsmag úgy lett kialakítva, hogy bármely szolgáltató által közzétett elemekkel működjön együtt. Az elemek lehetnek például fájlrendszerfájl vagy könyvtár, beállításjegyzék-hive vagy tanúsítványtároló. A munkamenetben elérhető szolgáltatók listájához használja a Get-PSProvider parancsot. Egyes paraméterek csak egy adott szolgáltatóhoz érhetők el. További információ: about_Providers.

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. A visszaadott nevek a Elérési út paraméter értékéhez viszonyítva jelennek meg.

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 annak alkönyvtáraiban található .txt fájlokat jeleníti meg.

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

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árban és 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 Get-ChildItem parancsmag a Path paramétert használja a címtár C:\Testmegadá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 könyvtár C:\Test\Logstartalmát jeleníti meg. 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ő karaktert használja annak megadására, hogy minden A vagy a kezdődő fájl vagy könyvtár kizárásra kerül 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 minden olyan tanúsítványt lekér a PowerShell Cert: meghajtóban, amely kódaláírási jogosultsággal rendelkezik.

A Get-ChildItem parancsmag a Path paraméterrel adja meg a tanúsítványszolgáltatót a Cert: meghajtóval. 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

A tanúsítványszolgáltatóról és a Cert: meghajtóról további információt a about_Certificate_Providercímű témakörben talál.

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 Path paramétert használja a 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

Jegyzet

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

11. példa: Csatlakozási 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-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

12. példa: Egy AppX-újraelemzési pont hivatkozási céljának lekérése

Ez a példa egy AppX-újraelemzési pont céladatait próbálja lekérni. A Microsoft Store alkalmazások AppX-újraelemzési pontokat hoznak létre a felhasználó AppData-címtárában.

Get-ChildItem ~\AppData\Local\Microsoft\WindowsApps\MicrosoftEdge.exe |
    Select-Object Mode, LinkTarget, LinkType, Name

Mode  LinkTarget LinkType Name
----  ---------- -------- ----
la---                     MicrosoftEdge.exe

A Windows jelenleg nem biztosítja az AppX-újraelemzési pontok céladatainak lekérését. A fájlrendszerobjektum LinkTarget és LinkType tulajdonságai üresek.

Paraméterek

-Attributes

Jegyzet

Ez a paraméter csak a Fájlrendszer szolgáltatóban érhető el.

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ő értékeket támogatja:

  • Archive
  • Compressed
  • Device
  • Directory
  • Encrypted
  • Hidden
  • IntegrityStream
  • Normal
  • NoScrubData
  • NotContentIndexed
  • Offline
  • ReadOnly
  • ReparsePoint
  • SparseFile
  • System
  • Temporary

Ezeknek az attribútumoknak a leírását a FileAttributes enumerálásban 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)
Típus:FlagsExpression<T>[FileAttributes]
Elfogadott értékek:Archive, Compressed, Device, Directory, Encrypted, Hidden, IntegrityStream, Normal, NoScrubData, NotContentIndexed, Offline, ReadOnly, ReparsePoint, SparseFile, System, Temporary
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-CodeSigningCert

Jegyzet

Ez a paraméter csak a Tanúsítvány szolgáltatóban érhető el.

A Code Signing értékkel rendelkező tanúsítványok listájának lekéréséhez az EnhancedKeyUsageList tulajdonságában, használja a CodeSigningCert paramétert.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása: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.

Jegyzet

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.

Típus:UInt32
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Directory

Jegyzet

Ez a paraméter csak a Fájlrendszer szolgáltatóban érhető el.

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.

Típus:SwitchParameter
Aliasok:ad
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-DnsName

Jegyzet

Ez a paraméter csak a Tanúsítvány szolgáltatóban érhető el.

Olyan tartománynevet vagy névmintát ad meg, amely megfelel a parancsmag által lekért tanúsítványok DNSNameList tulajdonságának. A paraméter értéke lehet Unicode vagy ASCII. A punycode-értékek Unicode-ra lesznek konvertálva. A helyettesítő karakterek (*) használata engedélyezett.

Ezt a paramétert újra bevezették a PowerShell 7.1-ben

Típus:DnsNameRepresentation
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:True

-DocumentEncryptionCert

Jegyzet

Ez a paraméter csak a Tanúsítvány szolgáltatóban érhető el.

A Document Encryption tulajdonságértékében szereplő tanúsítványok listájának lekéréséhez használja a DocumentEncryptionCert paramétert.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Eku

Jegyzet

Ez a paraméter csak a Tanúsítvány szolgáltatóban érhető el.

A parancsmag által lekért tanúsítványok EnhancedKeyUsageList tulajdonságának megfelelő szöveget vagy szövegmintát adja meg. A helyettesítő karakterek (*) használata engedélyezett. A EnhancedKeyUsageList tulajdonság tartalmazza az EKU barátságos nevét és OID mezőit.

Ezt a paramétert újra bevezették a PowerShell 7.1-ben

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:True

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

Típus:String[]
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:True

-ExpiringInDays

Jegyzet

Ez a paraméter csak a Tanúsítvány szolgáltatóban érhető el.

Megadja, hogy a parancsmag csak a megadott számú napon belül vagy azt megelőzően lejáró tanúsítványokat adja vissza. A nulla (0) érték megkapja a lejárt tanúsítványokat.

Ezt a paramétert újra bevezették a PowerShell 7.1-ben

Típus:Int32
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-File

Jegyzet

Ez a paraméter csak a Fájlrendszer szolgáltatóban érhető el.

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.

Típus:SwitchParameter
Aliasok:af
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása: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ősztring átadásra kerül a .NET API-nak a fájlok felsorolásához. Az API csak * és ? helyettesítő karaktereket támogat.

Típus:String
Position:1
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:True

-FollowSymlink

Jegyzet

Ez a paraméter csak a Fájlrendszer szolgáltatóban érhető el.

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.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása: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 szolgáltatónként eltérő. További információ: about_Providers.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:False
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Hidden

Jegyzet

Ez a paraméter csak a Fájlrendszer szolgáltatóban érhető el.

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.

Típus:SwitchParameter
Aliasok:ah, h
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása: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.

Típus:String[]
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:True

-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 út tartalmaz escape karaktereket, tegyük 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óért lásd a about_Quoting_Rulescímű részt.

Típus:String[]
Aliasok:PSPath, LP
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása: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. A visszaadott nevek a Elérési út paraméter értékéhez viszonyítva jelennek meg.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Path

Egy vagy több hely elérési útját adja meg. Ha nincs megadva, az alapértelmezett hely az aktuális könyvtár (.). A helyettesítő karaktereket a rendszer elfogadja. Óvatosan használja a Path paramétert a Recurse paraméterrel. További információt a cikk NOTES szakaszában talál.

Típus:String[]
Position:0
Alapértelmezett érték:Current directory
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:True

-ReadOnly

Jegyzet

Ez a paraméter csak a Fájlrendszer szolgáltatóban érhető el.

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

Típus:SwitchParameter
Aliasok:ar
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Recurse

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

Típus:SwitchParameter
Aliasok:s, r
Position:Named
Alapértelmezett érték:False
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-SSLServerAuthentication

Jegyzet

Ez a paraméter csak a Tanúsítvány szolgáltatóban érhető el.

A tanúsítványok listájának lekéréséhez, amelyek Server Authentication értékkel rendelkeznek az EnhancedKeyUsageList tulajdonságában, használja az SSLServerAuthentication paramétert.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-System

Jegyzet

Ez a paraméter csak a Fájlrendszer szolgáltatóban érhető el.

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.

Típus:SwitchParameter
Aliasok:as
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

Bevitelek

String

A karakterláncot, amely elérési utat tartalmaz, csövezheti ehhez a parancsmaghoz.

Kimenetek

AliasInfo

A parancsmag ezt a típust adja ki a Alias: meghajtó elérésekor.

X509StoreLocation

X509Store

X509Certificate2

A parancsmag ezeket a típusokat a Cert: meghajtó elérésekor adja ki.

DictionaryEntry

A parancsmag ezt a típust adja ki a Env: meghajtó elérésekor.

DirectoryInfo

FileInfo

A parancsmag ezeket a típusokat kimeneteli a Fájlrendszer-meghajtók elérésekor.

FunctionInfo

FilterInfo

A parancsmag ezeket a típusokat a Function: meghajtók elérésekor adja ki.

RegistryKey

A parancsmag ezt a típust adja ki a beállításjegyzék-meghajtók elérésekor.

PSVariable

A parancsmag ezt a típust adja ki a Variable: meghajtók elérésekor.

WSManConfigContainerElement

WSManConfigLeafElement

A parancsmag ezeket a típusokat a WSMan: meghajtók elérésekor adja ki.

String

Ha a Név paramétert használja, ez a parancsmag sztringekként adja vissza az objektumneveket.

Jegyzetek

A PowerShell a következő aliasokat tartalmazza Get-ChildItem:

  • Minden platform:
    • dir, gci
  • Windows:
    • ls

Rekurziós viselkedés az Elérési út paraméterrel:

Ha Get-ChildItem -Recurse a Elérési út paraméterrel használja, a parancsmag megkeresi az utolsó elérési út összetevőjét, függetlenül attól, hogy helyettesítő vagy konstans névről van-e szó.

  • Ha az utolsó elérési út összetevő megegyezik a célkönyvtár meglévő közvetlen alkönyvtárával, a parancsmag rekurzív enumerálást hajt végre az egyező könyvtáron.
  • Ha az utolsó elérési út összetevő nem egyezik meg a célkönyvtár meglévő közvetlen alkönyvtárával, a parancsmag rekurzív módon keres a célkönyvtár hierarchiájában az utolsó elérésiút-összetevőnek megfelelő elemeket

Ha Get-ChildItem -Recurse használ a Elérési út és Név paraméterekkel, a viselkedés megváltozik. A parancs megkeresi az utolsó elérési út összetevőjét a célkönyvtár közvetlen gyermekelemei között.

  • Ha a közvetlen gyermekelemek között egyezés van, a parancsmag rekurzív enumerálást hajt végre az egyező elemeken. A helyettesítő karakterek egyeztetése csak egyszer történik a célkönyvtár legfelső szintjén. A rendszer úgy dolgozza fel az eredményeket, mintha egyenként adták volna át őket a LiteralPath paraméternek.
  • Ha az utolsó elérésiút-összetevő nem egyezik meg a legfelső szinten lévő elemekkel, hiba történik.

Ne használja a Path paramétert a Recurse paraméterrel. A legjobb eredményekért:

  • A LiteralPath használatával adja meg a célkönyvtárat, hogy ne aktiváljon rekurzív keresést az utolsó elérési út összetevőjére.
  • A Szűrő vagy A paraméterek belefoglalásával helyettesítő vagy literális mintákat adhat meg, amelyeket a célkönyvtár hierarchiájának minden szintjén keresni kell.