Get-ChildItem

Syntaxe

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

Rutina Get-ChildItem získá položky v jednom nebo více zadaných umístěních. Pokud je položka kontejnerem, získá položky uvnitř kontejneru, označované jako podřízené položky. Pomocí parametru Recurse můžete získat položky ve všech podřízených kontejnerech a pomocí parametru Hloubka omezit počet úrovní, které se mají vrátit.

Get-ChildItem nezobrazuje prázdné adresáře. Get-ChildItem Pokud příkaz obsahuje parametry hloubky nebo rekurse, prázdné adresáře se do výstupu nezahrnou.

Umístění jsou zpřístupněná Get-ChildItem poskytovateli PowerShellu. Umístění může být adresář systému souborů, podregistr registru nebo úložiště certifikátů. Některé parametry jsou dostupné jenom pro konkrétního poskytovatele. Další informace najdete v tématu about_Providers.

Příklady

Příklad 1: Získání podřízených položek z adresáře systému souborů

Tento příklad získá podřízené položky z adresáře systému souborů. Zobrazí se názvy názvů souborů a podadresářů. V případě prázdných umístění příkaz nevrací žádný výstup a vrátí se do příkazového řádku PowerShellu.

Rutina Get-ChildItem používá parametr Path k určení adresáře C:\Test. Get-ChildItem zobrazí soubory a adresáře v konzole PowerShellu.

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

Ve výchozím nastavení Get-ChildItem uvádí režim (atributy), LastWriteTime, velikost souboru (délka) a název položky. Písmena ve vlastnosti Mode lze interpretovat takto:

• l (odkaz)
• d (adresář)
• a (archiv)
• r (jen pro čtení)
• h (skryté)
• s (systém)

Další informace o příznakech režimu najdete v tématu about_Filesystem_Provider.

Příklad 2: Získání názvů podřízených položek v adresáři

Tento příklad uvádí pouze názvy položek v adresáři.

Rutina Get-ChildItem používá parametr Path k určení adresáře C:\Test. Parametr Name vrátí pouze názvy souborů nebo adresářů ze zadané cesty. Vrácené názvy jsou relativní vzhledem k hodnotě parametru Path .

Get-ChildItem -Path C:\Test -Name

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

Příklad 3: Získání podřízených položek v aktuálním adresáři a podadresářích

Tento příklad zobrazuje .txt soubory, které jsou umístěny v aktuálním adresáři a jeho podadresářích.

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

Rutina Get-ChildItem používá k určení C:\Test\*.txtparametru Path . Cesta používá zástupný znak hvězdičky (*) k určení všech souborů s příponou .txtnázvu souboru . Parametr Recurse prohledá adresář Path a jeho podadresáře, jak je znázorněno v nadpisech Directory: nadpisy. Parametr Force zobrazí skryté soubory, jako hiddenfile.txt jsou například režim h.

Příklad 4: Získání podřízených položek pomocí parametru Include

V tomto příkladu Get-ChildItem používá parametr Include k vyhledání konkrétních položek z adresáře určeného parametrem Path .

# When using the -Include parameter, if you don't include an asterisk in the path
# the command returns no output.
Get-ChildItem -Path C:\Test\ -Include *.txt



Get-ChildItem -Path C:\Test\* -Include *.txt

Directory: C:\Test

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----        2/13/2019     08:55             26 anotherfile.txt
-a----        2/12/2019     15:40         118014 Command.txt
-ar---        2/12/2019     14:31             27 ReadOnlyFile.txt

Rutina Get-ChildItem používá parametr Path k určení adresáře C:\Test. Parametr Path obsahuje zástupný znak hvězdičky (*) pro zadání obsahu adresáře. Parametr Include používá zástupný znak hvězdičky (*) k určení všech souborů s příponou .txtnázvu souboru .

Při použití parametru Include potřebuje parametr Path k určení obsahu adresáře koncovou hvězdičku (*). Například -Path C:\Test\*.

• Pokud je do příkazu přidán parametr Recurse, je koncová hvězdička (*) v parametru Path nepovinná. Parametr Recurse získává položky z adresáře Path a jeho podadresářů. Například -Path C:\Test\ -Recurse -Include *.txt
• Pokud koncová hvězdička (*) není součástí parametru Path , příkaz nevrací žádný výstup a vrátí se do příkazového řádku PowerShellu. Například -Path C:\Test\.

Příklad 5: Získání podřízených položek pomocí parametru Exclude

Výstup příkladu ukazuje obsah adresáře C:\Test\Logs. Výstup je odkaz na ostatní příkazy, které používají parametry Exclude a Recurse .

Get-ChildItem -Path C:\Test\Logs

Directory: C:\Test\Logs

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----        2/15/2019     13:21                Adirectory
d-----        2/15/2019     08:28                AnEmptyDirectory
d-----        2/15/2019     13:21                Backup
-a----        2/12/2019     16:16             20 Afile.txt
-a----        2/13/2019     13:26             20 LogFile1.txt
-a----        2/12/2019     16:24             23 systemlog1.log

Get-ChildItem -Path C:\Test\Logs\* -Exclude A*

Directory: C:\Test\Logs

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----        2/15/2019     13:21                Backup
-a----        2/13/2019     13:26             20 LogFile1.txt
-a----        2/12/2019     16:24             23 systemlog1.log

Rutina Get-ChildItem používá parametr Path k určení adresáře C:\Test\Logs. Parametr Exclude používá zástupný znak hvězdičky (*) k určení všech souborů nebo adresářů, které začínají A nebo a jsou vyloučeny z výstupu.

Při použití parametru Exclude je volitelná koncová hvězdička (*) v parametru Path . Například -Path C:\Test\Logs nebo -Path C:\Test\Logs\*.

• Pokud koncový hvězdička (*) není zahrnuta v parametru Path , zobrazí se obsah parametru Path . Výjimky jsou názvy souborů nebo podadresáře, které odpovídají hodnotě parametru Exclude .
• Pokud je v parametru Path zahrnuta koncová hvězdička (*), příkaz se znovu vrátí do podadresářů parametru Path. Výjimky jsou názvy souborů nebo podadresáře, které odpovídají hodnotě parametru Exclude .
• Pokud je do příkazu přidán parametr Recurse, rekurze výstup je stejný, zda parametr Path obsahuje koncovou hvězdičku (*).

Příklad 6: Získání klíčů registru z podregistru registru

Tento příklad získá všechny klíče registru z HKEY_LOCAL_MACHINE\HARDWARE.

Get-ChildItempoužívá parametr Path k určení klíče HKLM:\HARDWAREregistru . Cesta hivu a nejvyšší úroveň klíčů registru se zobrazují v konzole PowerShellu.

Další informace najdete v tématu 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

První příkaz zobrazí obsah HKLM:\HARDWARE klíče registru. Parametr Exclude říká Get-ChildItem , že nevrací žádné podklíče, které začínají D*. V současné době parametr Exclude funguje pouze u podklíčů, nikoli vlastností položky.

Příklad 7: Získání všech certifikátů s podpisovou autoritou kódu

Tento příklad získá každý certifikát na jednotce PowerShellu Cert: , která má podpisovou autoritu kódu.

Rutina Get-ChildItem používá parametr Path k určení zprostředkovatele certifikátu s jednotkou Cert: . Parametr Recurse prohledá adresář určený path a jeho podadresáře. Parametr CodeSigningCert získá pouze certifikáty, které mají podpisovou autoritu kódu.

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

Další informace o poskytovateli certifikátu a jednotce najdete v Cert: tématu about_Certificate_Provider.

Příklad 8: Získání položek pomocí parametru Hloubka

Tento příklad zobrazuje položky v adresáři a jeho podadresářích. Parametr Hloubka určuje počet úrovní podadresáře, které se mají zahrnout do rekurze. Prázdné adresáře jsou z výstupu vyloučené.

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

Rutina Get-ChildItem používá k určení C:\Parentparametru Path . Parametr Hloubka určuje dvě úrovně rekurze. Get-ChildItem zobrazí obsah adresáře určeného parametrem Path a dvěma úrovněmi podadresářů.

Příklad 9: Získání informací o pevném odkazu

V PowerShellu 6.2 se přidalo alternativní zobrazení pro získání informací o pevném odkazu.

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

Příklad 10: Výstup pro operační systémy mimo Windows

V PowerShellu 7.1 v systémech Get-ChildItem Unix poskytuje výstup podobný systému Unix:

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

Nové vlastnosti, které jsou nyní součástí výstupu, jsou:

• UnixMode je oprávnění k souborům reprezentovaná v systému Unix.
• Uživatel je vlastníkem souboru.
• Skupina je vlastníkem skupiny.
• Velikost je velikost souboru nebo adresáře reprezentované v systému Unix.

Příklad 11: Získání cíle propojení pro spojovací bod

Příkaz dir v příkazovém prostředí Windows zobrazuje cílové umístění spojovacího bodu systému souborů. V PowerShellu jsou tyto informace k dispozici z Vlastnosti LinkTarget objektu systému souborů vrácené Get-ChildItem a jsou zobrazeny ve výchozím výstupu.

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

Příklad 12: Získání cíle odkazu pro spojovací bod AppX

Tento příklad se pokusí získat cílové informace pro bod opakování AppX. Aplikace z Microsoft Storu vytvářejí body opakování AppX v adresáři AppData uživatele.

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

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

V tuto chvíli Windows neposkytuje způsob, jak získat cílové informace pro bod opakování AppX. Vlastnosti LinkTarget a LinkType objektu systému souborů jsou prázdné.

Parametry

-Attributes

-CodeSigningCert

-Depth

-Directory

-DnsName

-DocumentEncryptionCert

-Eku

-Exclude

-ExpiringInDays

-File

-Filter

-FollowSymlink

-Force

-Hidden

-Include

-LiteralPath

-Name

-Path

-ReadOnly

-Recurse

-SSLServerAuthentication

-System

Vstupy

String

Řetězec, který obsahuje cestu k této rutině, můžete převést.

Výstupy

AliasInfo

Rutina tento typ vypíše při přístupu k jednotce Alias: .

X509StoreLocation

X509Store

X509Certificate2

Rutina vypíše tyto typy při přístupu k Cert: jednotce.

DictionaryEntry

Rutina tento typ vypíše při přístupu k jednotce Env: .

DirectoryInfo

FileInfo

Rutina vypíše tyto typy při přístupu k jednotkám Systému souborů.

FunctionInfo

FilterInfo

Rutina vypíše tyto typy při přístupu k jednotkám Function: .

RegistryKey

Rutina tento typ vypíše při přístupu k jednotkám registru.

PSVariable

Rutina tento typ vypíše při přístupu k jednotkám Variable: .

WSManConfigContainerElement

WSManConfigLeafElement

Rutina vypíše tyto typy při přístupu k jednotkám WSMan: .

String

Pokud použijete parametr Name , vrátí tato rutina názvy objektů jako řetězce.

Poznámky

PowerShell obsahuje následující aliasy pro Get-ChildItem:

• Všechny platformy:
  • dir, gci
• Windows:
  • ls

Get-ChildItem ve výchozím nastavení nezískute skryté položky. Pokud chcete získat skryté položky, použijte parametr Force .

Rutina Get-ChildItem je navržená tak, aby fungovala s daty vystavenými libovolným poskytovatelem. Pokud chcete zobrazit seznam poskytovatelů dostupných v relaci, zadejte Get-PSProvider. Další informace najdete v tématu about_Providers.

Související odkazy

• 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