Get-ChildItem

Modul:

Microsoft.PowerShell.Management

Získá položky a podřízené položky v jednom nebo více zadaných umístěních.

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

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

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

Umístění jsou vystavená 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 naleznete 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 pro 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 naleznete 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 zobrazí .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

Cmdlet Get-ChildItem používá parametr Path k určení C:\Test\*.txt. Path používá zástupný znak hvězdičky (*) k určení všech souborů s příponou názvu souboru .txt. Parametr Recurse prohledá adresář Path a jeho podadresáře, jak je znázorněno v nadpisech Directory:. Parametr Force zobrazuje skryté soubory, například hiddenfile.txt, které mají 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í C:\Testadresáře . Parametr Path obsahuje zástupný znak hvězdičky (*), který určuje obsah adresáře. Parametr Include používá zástupný znak hvězdičky (*) k určení všech souborů s příponou názvu souboru .txt.

Pokud se použije parametr Include, parametr Path potřebuje zástupný znak hvězdičky (*) pro zadání obsahu adresáře. Například -Path C:\Test\*.

• Pokud je do příkazu přidán parametr Recurse, je koncová hvězdička (*) v parametru Cesta volitelná. Parametr Recurse získá 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 referenční informace pro 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í C:\Test\Logsadresáře . Parametr Exclude používá zástupný znak hvězdičky (*) k určení souborů nebo adresářů, které začínají A nebo a, jsou z výstupu vyloučeny.

Pokud se použije parametr 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í součástí parametru Path, zobrazí se obsah parametru Path. Výjimky jsou názvy souborů nebo podadresářů, které odpovídají hodnotě parametru Exclude.
• Pokud je v parametru Path zahrnuta koncová hvězdička (*), příkaz se znovu vrátí do podadresářů Path parametru. Výjimky jsou názvy souborů nebo podadresářů, které odpovídají hodnotě parametru Exclude.
• Pokud se do příkazu přidá parametr Recurse, rekurzní výstup je stejný, jestli 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-ChildItem používá parametr Path k určení klíče registru HKLM:\HARDWARE. Cesta hivu a nejvyšší úroveň klíčů registru se zobrazují v konzole PowerShellu.

Další informace zjistíte 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 klíče registru HKLM:\HARDWARE. Parametr Exclude říká, aby Get-ChildItem nevracel žá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 certifikací pro podepisování kódu

Tento příklad získá všechny certifikáty na jednotce Cert: v PowerShellu, které mají autorizaci pro podepisování kódu.

Cmdlet Get-ChildItem používá parametr Path k určení certifikátového poskytovatele ve spojení s jednotkou Cert:. Parametr Recurse prohledá adresář určený Path a jeho podadresáře. Parametr CodeSigningCert získá pouze certifikáty, které mají oprávnění pro podpis kódu.

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

Další informace o poskytovateli certifikátu a jednotce Cert: naleznete v 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 Depth 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

Cmdlet Get-ChildItem používá parametr Path k určení C:\Parent. Parametr hloubky 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 Unix poskytuje Get-ChildItem výstup podobný unixu:

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.

Poznámka

Tato funkce byla přesunuta z experimentálního do hlavního proudu v PowerShellu 7.1.

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ého Get-ChildItem a zobrazí se 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 přesměrovací bod AppX

Tento příklad se pokusí získat cílové informace pro reparse bod typu AppX. Aplikace z Microsoft Storu vytvářejí přesměrovací body 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 AppX reparse point. Vlastnosti LinkTarget a LinkType objektu systému souborů jsou prázdné.

Parametry

-Attributes

Poznámka

Tento parametr je k dispozici pouze ve zprostředkovateli FileSystem.

Získá soubory a složky se zadanými atributy. Tento parametr podporuje všechny atributy a umožňuje zadat složité kombinace atributů.

Pokud například chcete získat nesystémové soubory (ne adresáře), které jsou šifrované nebo komprimované, zadejte:

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

K vyhledání souborů a složek s běžně používanými atributy použijte parametr Atributy. Nebo parametry Adresář, Soubor, Skryté, Jen pro čtení, Systém.

Parametr Attributes podporuje následující vlastnosti:

• Archiv
• komprimované
• zařízení
• adresář
• šifrované
• Skrytý
• IntegrityStream
• Normální
• NoScrubData
• NezobrazitAVyhledávání
• offline
• jen pro čtení
• ReparsePoint
• ŘídkýSoubor
• Systém
• dočasné

Popis těchto atributů najdete v FileAttributes výčtu.

Ke kombinování atributů použijte následující operátory:

• ! (NE)
• + (AND)
• , (OR)

Nepoužívejte mezery mezi operátorem a jeho atributem. Mezery se přijímají po čárkách.

Pro běžné atributy použijte následující zkratky:

• D (adresář)
• H (skryté)
• R (jen pro čtení)
• S (systém)

Typ:	FlagsExpression<T>[FileAttributes]
Přípustné hodnoty:	Archive, Compressed, Device, Directory, Encrypted, Hidden, IntegrityStream, Normal, NoScrubData, NotContentIndexed, Offline, ReadOnly, ReparsePoint, SparseFile, System, Temporary
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-CodeSigningCert

Poznámka

Tento parametr je dostupný pouze u poskytovatele Certificate.

Chcete-li získat seznam certifikátů, které mají ve vlastnosti EnhancedKeyUsageList hodnotu Code Signing, použijte parametr CodeSigningCert.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Depth

Tento parametr byl přidán v PowerShellu 5.0 a umožňuje řídit hloubku rekurze. Ve výchozím nastavení Get-ChildItem zobrazí obsah nadřazeného adresáře. Parametr Depth určuje počet úrovní podadresáře, které jsou součástí rekurze, a zobrazí obsah.

Například -Depth 2 zahrnuje adresář Path parametru, první úroveň podadresářů a druhou úroveň podadresářů. Ve výstupu jsou ve výchozím nastavení zahrnuty názvy adresářů a názvy souborů.

Poznámka

Na počítači s Windows z PowerShellu nebo cmd.exemůžete zobrazit grafické zobrazení adresářové struktury pomocí příkazu tree.com.

Typ:	UInt32
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Directory

Poznámka

Tento parametr je k dispozici pouze ve zprostředkovateli FileSystem.

Chcete-li získat seznam adresářů, použijte parametr Directory nebo parametr Attributes s vlastností Directory. Parametr Recurse můžete použít s Directory.

Typ:	SwitchParameter
Aliasy:	ad
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DnsName

Poznámka

Tento parametr je k dispozici pouze u poskytovatele certifikátu .

Určuje vzor názvu domény nebo názvu, který se má shodovat s vlastností DNSNameList certifikátů, které rutina získá. Hodnota tohoto parametru může být Unicode nebo ASCII. Hodnoty Punycode se převádějí na Unicode. Jsou povoleny zástupné znaky (*).

Tento parametr byl znovu vyvolán v PowerShellu 7.1.

Typ:	DnsNameRepresentation
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	True

-DocumentEncryptionCert

Poznámka

Tento parametr je k dispozici pouze u poskytovatele Certificate.

Pokud chcete získat seznam certifikátů, které mají Document Encryption v hodnotě vlastnosti EnhancedKeyUsageList, použijte parametr DocumentEncryptionCert.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Eku

Poznámka

Tento parametr je k dispozici pouze u poskytovatele Certificate.

Určuje text nebo textový vzor, který se má shodovat s vlastností EnhancedKeyUsageList certifikátů, které rutina získá. Jsou povoleny zástupné znaky (*). EnhancedKeyUsageList vlastnost obsahuje přátelský název a pole OID pro EKU.

Tento parametr byl znovu zaveden v PowerShellu 7.1.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	True

-Exclude

Určuje pole jednoho nebo více vzorů řetězců, které se mají shodovat s tím, jak rutina získá podřízené položky. Každá odpovídající položka je vyloučena z výstupu. Zadejte prvek nebo vzor cesty, například *.txt nebo A*. Zástupné znaky jsou akceptovány.

Koncová hvězdička (*) v parametru Path je volitelná. Například -Path C:\Test\Logs nebo -Path C:\Test\Logs\*. Pokud je zahrnuta koncová hvězdička (*), příkaz se vrátí do podadresářů parametru Path. Bez hvězdičky (*) se zobrazí obsah parametru Path. Další podrobnosti najdete v příkladu 5 a v části Poznámky.

Parametry Zahrnout a Vyloučit lze použít společně. Vyloučení se však použijí po zahrnutích, což může ovlivnit konečný výstup.

Typ:	String[]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	True

-ExpiringInDays

Poznámka

Tento parametr je k dispozici pouze u poskytovatele Certificate.

Určuje, že rutina by měla vracet pouze certifikáty, jejichž platnost vyprší nebo před zadaným počtem dní. Hodnota nula (0) zobrazí certifikáty, které mají vypršenou platnost.

Tento parametr byl znovu zaveden v PowerShellu 7.1.

Typ:	Int32
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-File

Poznámka

Tento parametr je k dispozici pouze ve zprostředkovateli FileSystem.

Pokud chcete získat seznam souborů, použijte parametr File. Parametr Recurse můžete použít s File.

Typ:	SwitchParameter
Aliasy:	af
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Filter

Určuje filtr pro kvalifikaci parametru Path. Zprostředkovatel FileSystem je jediným nainstalovaným poskytovatelem PowerShellu, který podporuje filtry. Filtry jsou efektivnější než jiné parametry. Zprostředkovatel použije filtr, když rutina získá objekty místo toho, aby objekty po jejich načtení vyfiltrovaly PowerShell. Řetězec filtru se předá rozhraní .NET API pro výčet souborů. Rozhraní API podporuje pouze zástupné znaky * a ?.

Typ:	String
Position:	1
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	True

-FollowSymlink

Poznámka

Tento parametr je k dispozici pouze ve zprostředkovateli FileSystem.

Ve výchozím nastavení zobrazuje cmdlet Get-ChildItem symbolické odkazy na adresáře nalezené během rekurze, ale do těchto adresářů dále nepostupuje. Pomocí parametru FollowSymlink vyhledejte adresáře, které cílí na tyto symbolické odkazy. FollowSymlink je dynamický parametr a podporuje se pouze v poskytovateli FileSystem.

Tento parametr byl představen v PowerShellu 6.0.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Force

Umožňuje rutině získat položky, ke kterým jinak uživatel nemá přístup, například skryté nebo systémové soubory. Parametr Force nemá schopnost přepsat omezení zabezpečení. Implementace se liší mezi poskytovateli. Další informace naleznete v tématu about_Providers.

Typ:	SwitchParameter
Position:	Named
Default value:	False
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Hidden

Poznámka

Tento parametr je k dispozici pouze ve zprostředkovateli FileSystem.

Pokud chcete získat pouze skryté položky, použijte parametr Hidden nebo Attributes parametr s vlastností Hidden. Ve výchozím nastavení Get-ChildItem nezobrazuje skryté položky. K získání skrytých položek použijte parametr Force.

Typ:	SwitchParameter
Aliasy:	ah, h
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Include

Určuje pole jednoho nebo více vzorů řetězců, které se mají shodovat s tím, jak rutina získá podřízené položky. Každá odpovídající položka je zahrnuta ve výstupu. Zadejte prvek cesty nebo vzor, například "*.txt". Jsou povoleny zástupné znaky. Parametr Include je efektivní pouze v případě, že příkaz obsahuje obsah položky, například C:\Windows\*, kde zástupný znak určuje obsah adresáře C:\Windows.

Parametry Zahrnout a Vyloučit lze použít společně. Vyloučení se však použijí po zahrnutích, což může ovlivnit konečný výstup.

Typ:	String[]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	True

-LiteralPath

Určuje cestu k jednomu nebo více umístěním. Hodnota LiteralPath se používá přesně tak, jak je zadána. Žádné znaky nejsou interpretovány jako zástupné znaky. Pokud cesta obsahuje escape znaky, uzavřete ji do jednoduchých uvozovek. Jednoduché uvozovky říkají PowerShellu, aby nepřekládaly žádné znaky jako řídicí sekvence.

Další informace najdete v tématu about_Quoting_Rules.

Typ:	String[]
Aliasy:	PSPath, LP
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-Name

Získá pouze názvy položek v umístění. Výstup je řetězcový objekt, který lze odeslat potrubím dalším příkazům. Vrácené názvy jsou relativní vzhledem k hodnotě parametru Path.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Path

Určuje cestu k jednomu nebo více umístěním. Zástupné cardy jsou přijímány. Výchozí umístění je aktuální adresář (.).

Typ:	String[]
Position:	0
Default value:	Current directory
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	True

-ReadOnly

Poznámka

Tento parametr je k dispozici pouze ve zprostředkovateli FileSystem.

Pokud chcete získat pouze položky určené jen pro čtení, použijte parametr ReadOnly nebo parametr Atributy s vlastností ReadOnly.

Typ:	SwitchParameter
Aliasy:	ar
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Recurse

Získá položky v zadaných umístěních a ve všech podřízených položkách těchto umístění.

Typ:	SwitchParameter
Aliasy:	s, r
Position:	Named
Default value:	False
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-SSLServerAuthentication

Poznámka

Tento parametr je k dispozici pouze u poskytovatele certificate.

Pokud chcete získat seznam certifikátů, které mají Server Authentication v hodnotě vlastnosti EnhancedKeyUsageList, použijte parametr SSLServerAuthentication.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-System

Poznámka

Tento parametr je k dispozici pouze ve zprostředkovateli FileSystem.

Získá pouze systémové soubory a adresáře. Chcete-li získat pouze systémové soubory a složky, použijte parametr System nebo Atributy parametr System vlastnost.

Typ:	SwitchParameter
Aliasy:	as
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

Vstupy

String

Řetězec, který obsahuje cestu, můžete přesměrovat do této rutiny.

Výstupy

AliasInfo

Cmdlet vypisuje tento typ při přístupu k jednotce Alias:.

X509StoreLocation

X509Store

X509Certificate2

Cmdlet vypisuje tyto typy při přístupu k jednotce Cert:.

DictionaryEntry

Cmdlet zobrazí tento typ při přístupu k jednotce Env:.

DirectoryInfo

FileInfo

Cmdlet vypíše tyto typy při přístupu k diskovým jednotkám souborového systému.

FunctionInfo

FilterInfo

Cmdlet vypíše tyto typy při přístupu k diskům Function:.

RegistryKey

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

PSVariable

Cmdlet vypisuje tento typ při přístupu k jednotkám Variable:.

WSManConfigContainerElement

WSManConfigLeafElement

Cmdlet vypíše tyto typy při přístupu k disků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íská 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 jakýmkoli poskytovatelem. Pokud chcete zobrazit seznam poskytovatelů dostupných v relaci, zadejte Get-PSProvider. Další informace naleznete v tématu about_Providers.

Související odkazy

• o_poskytovateli_certifikátů
• about_Providers
• o_Citačních_Pravidlech
• about_Registry_Provider
• ForEach-Object
• Get-Alias
• Get-Item
• Get-Location
• Get-Process
• Get-PSProvider
• Split-Path