Get-ChildItem

Reference

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

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.

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

Poznámka:

Tento parametr je k dispozici pouze v 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 Directory, File, Hidden, ReadOnly a System.

Parametr Attributes podporuje následující vlastnosti:

Archiv
Komprimovaný
Zařízení
Adresář
Zakódovaný
Schovaný
IntegrityStream
Normální
NoScrubData
NotContentIndexed
Offline
ReadOnly
ReparsePoint
Řídký soubor
Systém
Dočasné

Popis těchto atributů naleznete v souboru FileAttributes Výčtu.

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

! (NE)
+ (A)
, (NEBO)

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 k dispozici pouze ve zprostředkovateli certifikátu .

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

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 se zobrazí obsah nadřazeného adresáře. Parametr Hloubka určuje počet úrovní podadresáře, které jsou součástí rekurze, a zobrazí obsah.

Zahrnuje například -Depth 2 adresář parametru Path , 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.exe můžete pomocí příkazu tree.com zobrazit grafické zobrazení adresářové struktury.

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 v zprostředkovateli FileSystem .

Seznam adresářů získáte pomocí parametru Directory nebo atributu Attributes s vlastností Directory . S adresářem můžete použít parametr Recurse.

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 ve zprostředkovateli certifikátu .

Určuje název domény nebo vzor 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. Punycode hodnoty jsou převedeny na Unicode. Jsou povoleny zástupné znaky (*).

Tento parametr byl znovu vyvolána 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 ve zprostředkovateli certifikátu .

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

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 ve zprostředkovateli certifikátu .

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 popisný název a pole OID EKU.

Tento parametr byl znovu vyvolána 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 přijímá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 znovu zobrazí 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 ve zprostředkovateli certifikátu .

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) získá certifikáty, jejichž platnost vypršela.

Tento parametr byl znovu vyvolána 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 v zprostředkovateli FileSystem .

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

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, který má kvalifikovat parametr 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 k vytvoření výčtu souborů. Rozhraní API podporuje * pouze zástupné dokumentace.?

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 v zprostředkovateli FileSystem .

Rutina Get-ChildItem ve výchozím nastavení zobrazuje symbolické odkazy na adresáře nalezené během rekurze, ale nenabídá se do nich. Pomocí parametru FollowSymlink vyhledejte adresáře, které cílí na tyto symbolické odkazy. FollowSymlink je dynamický parametr a je podporován pouze v zprostředkovateli 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 nepřepíše omezení zabezpečení. Implementace se liší mezi poskytovateli. Další informace najdete 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 v zprostředkovateli FileSystem .

Chcete-li získat pouze skryté položky, použijte hidden parametr nebo Attributes parametr s Hidden vlastnost. Ve výchozím nastavení Get-ChildItem se skryté položky nezobrazují. 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 element nebo vzor cesty, 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 C:\Windows adresáře.

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 řídicí 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 kanál do jiných příkazů. 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 v zprostředkovateli FileSystem .

Chcete-li získat pouze položky jen pro čtení, použijte readOnly parametr nebo Attributes parametr ReadOnly vlastnost.

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 umístění.

Typ:	SwitchParameter
Aliasy:	s
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 ve zprostředkovateli certifikátu .

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 v 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 system parametr nebo atribut 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 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.

Sdílet prostřednictvím

Get-ChildItem

Syntaxe

Description

Příklady

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

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

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

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

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

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

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

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

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

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

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

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

Parametry

-Attributes

-CodeSigningCert

-Depth

-Directory

-DnsName

-DocumentEncryptionCert

-Eku

-Exclude

-ExpiringInDays

-File

-Filter

-FollowSymlink

-Force

-Hidden

-Include

-LiteralPath

-Name

-Path

-ReadOnly

-Recurse

-SSLServerAuthentication

-System

Vstupy

Výstupy

Poznámky

Související odkazy

Další materiály