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>]
Get-ChildItem
   [[-Path] <string[]>]
   [[-Filter] <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Recurse]
   [-Depth <uint>]
   [-Force]
   [-Name]
   [-CodeSigningCert]
   [-DocumentEncryptionCert]
   [-SSLServerAuthentication]
   [-DnsName <string>]
   [-Eku <string[]>]
   [-ExpiringInDays <int>]
   [<CommonParameters>]
Get-ChildItem
   [[-Filter] <string>]
   -LiteralPath <string[]>
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Recurse]
   [-Depth <uint>]
   [-Force]
   [-Name]
   [-CodeSigningCert]
   [-DocumentEncryptionCert]
   [-SSLServerAuthentication]
   [-DnsName <string>]
   [-Eku <string[]>]
   [-ExpiringInDays <int>]
   [<CommonParameters>]
Get-ChildItem
   [[-Path] <string[]>]
   [[-Filter] <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Recurse]
   [-Depth <uint>]
   [-Force]
   [-Name]
   [-Attributes <FlagsExpression[FileAttributes]>]
   [-FollowSymlink]
   [-Directory]
   [-File]
   [-Hidden]
   [-ReadOnly]
   [-System]
   [<CommonParameters>]
Get-ChildItem
   [[-Filter] <string>]
   -LiteralPath <string[]>
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Recurse]
   [-Depth <uint>]
   [-Force]
   [-Name]
   [-Attributes <FlagsExpression[FileAttributes]>]
   [-FollowSymlink]
   [-Directory]
   [-File]
   [-Hidden]
   [-ReadOnly]
   [-System]
   [<CommonParameters>]

Description

A Get-ChildItem parancsmag egy vagy több megadott helyen kapja meg az elemeket. 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 ismétlődni kívánt szintek számát.

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

A helyek a Get-ChildItem PowerShell-szolgáltatók számára érhetők el. A hely lehet fájlrendszerkönyvtár, beállításjegyzék-hive vagy tanúsítványtároló. 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 a gyermekelemeket egy fájlrendszerkö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 az Elérési út paraméter használatával adja meg a könyvtárat C:\Test. 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útumokat), a LastWriteTime-ot, a fájlméretet (Hossz) és az elem nevét . 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 (csak olvasható)
  • 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 az Elérési út paraméter használatával adja meg a könyvtárat C:\Test. A Név paraméter csak a megadott elérési út fájl- vagy könyvtárneveit adja vissza. A visszaadott nevek az 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ó fájlokat jeleníti meg .txt .

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 az Elérési út paramétert használja a beállításhozC:\Test\*.txt. Az elérési út a csillag (*) helyettesítő karakterrel adja meg a fájlnévkiterjesztéssel .txtrendelkező összes fájlt. A Recurse paraméter az Elérési út könyvtár alkönyvtáraiban keres, ahogyan az a Címtár: címsorok című témakörben látható. A Force paraméter olyan rejtett fájlokat jelenít meg, mint hiddenfile.txt például a H mód.

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

Ebben a példában Get-ChildItem az Include paramétert használja az 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 az Elérési út paraméter használatával adja meg a könyvtárat C:\Test. Az 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ő karakterrel adja meg a fájlnévkiterjesztéssel .txtrendelkező összes fájlt.

Az Include paraméter használata esetén az Elérési út 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 Recurse paraméter hozzá van adva a parancshoz, az Elérési út paraméter záró csillaga (*) nem kötelező. A Recurse paraméter az 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 az 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 a kizárási és recurse paramétereket használó többi parancsra mutató hivatkozás.

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 az Elérési út paraméter használatával adja meg a könyvtárat C:\Test\Logs. A Kizárás paraméter a csillag (*) helyettesítő karakterrel adja meg azokat a fájlokat vagy könyvtárakat, amelyek a kimenettel A kezdődnek, vagy a amelyek ki vannak zárva a kimenetből.

A Kizárás paraméter használata esetén az Elérési út paraméterben egy záró csillag (*) megadása nem kötelező. Például, -Path C:\Test\Logs vagy -Path C:\Test\Logs\*.

  • Ha egy záró csillag (*) nem szerepel az Elérési út paraméterben, az Elérési út paraméter tartalma jelenik meg. A kivételek a kizárási paraméter értékének megfelelő fájlnevek vagy alkönyvtárnevek.
  • Ha egy záró csillag (*) szerepel az Elérési út paraméterben, a parancs újra megjelenik az Elérési út paraméter alkönyvtáraiban. A kivételek a kizárási paraméter értékének megfelelő fájlnevek vagy alkönyvtárnevek.
  • Ha a Recurse paraméter hozzá van adva a parancshoz, a rekurzió kimenete megegyezik, függetlenül 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 az összes beállításkulcsot lekéri a rendszerből HKEY_LOCAL_MACHINE\HARDWARE.

Get-ChildItemAz Elérési út paraméter használatával adja meg a beállításkulcsotHKLM:\HARDWARE. A hive elérési útja és a beállításkulcsok legfelső szintje megjelenik a PowerShell-konzolon.

További információ: about_Registry_Provider.

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 beállításkulcs tartalmát HKLM:\HARDWARE . A Kizárás paraméter azt jelzi Get-ChildItem , hogy nem ad vissza olyan alkulcsokat, amelyek a következővel D*kezdődnek: . A Kizárás paraméter jelenleg csak alkulcsokon működik, elemtulajdonságok nem.

7. példa: Az összes tanúsítvány lekérése kódaláíró szolgáltatóval

Ez a példa beolvas minden olyan tanúsítványt a PowerShell-meghajtón Cert: , amely kódaláíró szolgáltatóval rendelkezik.

A Get-ChildItem parancsmag az Elérési út paraméterrel adja meg a meghajtóval rendelkező tanúsítványszolgáltatót Cert: . A Recurse paraméter az Elérési út és annak alkönyvtárai által megadott könyvtárban keres. A CodeSigningCert paraméter csak olyan tanúsítványokat kap, amelyek kódaláíró szolgáltatóval rendelkeznek.

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

További információ a tanúsítványszolgáltatóról és a Cert: 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 Mélység paraméter határozza meg a rekurzióba belefoglalandó alkönyvtárszintek számá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 az Elérési út paramétert használja a beállításhozC:\Parent. A Mélység paraméter két rekurziós szintet határoz meg. Get-ChildItemmegjeleníti az Elérési út paraméter által megadott könyvtár tartalmát és az alkönyvtárak két szintjét.

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

A PowerShell 6.2-ben egy másik nézet lett hozzáadva 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 unix-szerű Get-ChildItem 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:

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

Feljegyzé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: Csatlakozási pont hivatkozási céljának lekérése

A dir Windows command Shell parancsa megjeleníti a fájlrendszer-csomópont célhelyét. A PowerShellben ezek az információk a fájlrendszer objektum által visszaadott Get-ChildItem LinkTarget tulajdonságából érhetők el, és az alapértelmezett kimenetben jelennek 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 AlkalmazásX-ú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

Feljegyzés

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 megkereséséhez használja az Attribútumok paramétert . Vagy a Könyvtár, a Fájl, a Rejtett, a ReadOnly és a System paraméter.

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

  • Archívum
  • Tömörített
  • Eszköz
  • Taglista
  • Titkosított
  • Rejtett
  • IntegrityStream
  • Normál
  • NoScrubData
  • NotContentIndexed
  • Offline
  • ReadOnly
  • ReparsePoint
  • SparseFile
  • Rendszer
  • Ideiglenes

Ezeknek az attribútumoknak a leírásáért lásd a FileAttributes Enumerálás című témakört.

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 szóközök vesszők után fogadhatók el.

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)
Type:FlagsExpression<T>[FileAttributes]
Accepted values:Archive, Compressed, Device, Directory, Encrypted, Hidden, IntegrityStream, Normal, NoScrubData, NotContentIndexed, Offline, ReadOnly, ReparsePoint, SparseFile, System, Temporary
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CodeSigningCert

Feljegyzés

Ez a paraméter csak a tanúsítványszolgáltatóban érhető el.

Az EnhancedKeyUsageList tulajdonságértékben lévő tanúsítványok Code Signing listájának lekéréséhez használja a CodeSigningCert paramétert.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 Mélység paraméter határozza meg a rekurzióban szereplő alkönyvtárszintek számát, és megjeleníti a tartalmat.

Tartalmazza például -Depth 2 az 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.

Feljegyzés

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

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

-Directory

Feljegyzés

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 az Attribútumok paramétert a Címtár tulajdonsággal. A Recurse paramétert a Directoryval is használhatja.

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

-DnsName

Feljegyzés

Ez a paraméter csak a tanúsítványszolgáltatóban érhető el.

A parancsmag által lekért tanúsítványok DNSNameList tulajdonságával egyező tartománynevet vagy névmintát ad meg. Ennek a paraméternek az é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

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

-DocumentEncryptionCert

Feljegyzés

Ez a paraméter csak a tanúsítványszolgáltatóban érhető el.

Az EnhancedKeyUsageList tulajdonságértékben lévő tanúsítványok Document Encryption listájának lekéréséhez használja a DocumentEncryptionCert paramétert.

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

-Eku

Feljegyzés

Ez a paraméter csak a tanúsítványszolgáltatóban érhető el.

A parancsmag által lekért tanúsítványok EnhancedKeyUsageList tulajdonságával egyező szöveget vagy szövegmintát határoz meg. A helyettesítő karakterek (*) használata engedélyezett. Az EnhancedKeyUsageList tulajdonság tartalmazza az EKU rövid nevét és OID mezőit.

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

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

-Exclude

Egy vagy több sztringmintát tartalmazó tömböt ad meg, amelyet a parancsmag gyermekelemek beolvasása során kell egyeztetni. 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.

Az Elérési út paraméterben egy záró csillag (*) megadása nem kötelező. Például, -Path C:\Test\Logs vagy -Path C:\Test\Logs\*. Ha egy záró csillag (*) szerepel a fájlban, a parancs újra megjelenik az Elérési út paraméter alkönyvtárában. A csillag (*) nélkül az 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 Belefoglalá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.

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

-ExpiringInDays

Feljegyzés

Ez a paraméter csak a tanúsítványszolgá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 lekéri a lejárt tanúsítványokat.

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

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

-File

Feljegyzés

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 a Fájl használatával is használhatja.

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

-Filter

Egy szűrőt ad meg, amely megfelel az Elérési út paraméternek. A FileSystem-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 a .NET API-nak továbbítja a fájlok számbavételéhez. Az API csak támogatja * és ? helyettesítő karaktereket.

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-FollowSymlink

Feljegyzés

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

A parancsmag alapértelmezés szerint Get-ChildItem szimbolikus hivatkozásokat jelenít meg a rekurzió során talált könyvtárakra, 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 Fájlrendszer-szolgáltató támogatja.

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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ó: about_Providers.

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

-Hidden

Feljegyzés

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 Hidden tulajdonsággal. Alapértelmezés szerint Get-ChildItem nem jelenít meg rejtett elemeket. Rejtett elemek lekéréséhez használja a Force paramétert.

Type:SwitchParameter
Aliases:ah, h
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Include

Egy vagy több sztringmintát tartalmazó tömböt ad meg, amelyet a parancsmag gyermekelemek beolvasása során kell egyeztetni. 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\*amikor a helyettesítő karakter a könyvtár tartalmát C:\Windows adja meg.

A Belefoglalá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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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, csatolja egy 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ó: about_Quoting_Rules.

Type:String[]
Aliases:PSPath, LP
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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 az Elérési út paraméter értékéhez viszonyítva jelennek meg.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 (.).

Type:String[]
Position:0
Default value:Current directory
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-ReadOnly

Feljegyzés

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 a ReadOnly attribútumparamétert.

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

-Recurse

Lekéri az elemeket a megadott helyeken és a helyek összes gyermekelemében.

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

-SSLServerAuthentication

Feljegyzés

Ez a paraméter csak a tanúsítványszolgáltatóban érhető el.

Az EnhancedKeyUsageList tulajdonságértékben lévő tanúsítványok Server Authentication listájának lekéréséhez használja az SSLServerAuthentication paramétert.

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

-System

Feljegyzés

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 az Attribútumok paraméter Rendszer tulajdonságát.

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

Bevitelek

String

A parancsmag elérési útját tartalmazó sztringet csövezheti.

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 kimeneteli a Cert: meghajtó elérésekor.

DictionaryEntry

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

DirectoryInfo

FileInfo

A parancsmag ezeket a típusokat a fájlrendszer-meghajtók elérésekor adja ki.

FunctionInfo

FilterInfo

A parancsmag ezeket a típusokat a meghajtók elérésekor Function: 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 meghajtók elérésekor WSMan: adja ki.

String

A Név paraméter használatakor ez a parancsmag sztringként adja vissza az objektumneveket.

Jegyzetek

A PowerShell a következő aliasokat Get-ChildItemtartalmazza:

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

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 következőt Get-PSProvider: További információ: about_Providers.