Get-ChildItem

Modul:

Microsoft.PowerShell.Management Module

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

Syntax

Items (Výchozí)

Get-ChildItem
    [[-Path] <string[]>]
    [[-Filter] <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Recurse]
    [-Depth <uint32>]
    [-Force]
    [-Name]
    [-UseTransaction]
    [-Attributes <FlagsExpression[FileAttributes]>]
    [-Directory]
    [-File]
    [-Hidden]
    [-ReadOnly]
    [-System]
    [<CommonParameters>]

LiteralItems

Get-ChildItem
    [[-Filter] <string>]
    -LiteralPath <string[]>
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Recurse]
    [-Depth <uint>]
    [-Force]
    [-Name]
    [<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.

Rutina Get-ChildItem je navržená tak, aby fungovala s položkami vystavenými jakýmkoli poskytovatelem. Například položky můžou být soubor systému souborů nebo adresář, podregistr registru nebo úložiště certifikátů. Pokud chcete zobrazit seznam poskytovatelů dostupných ve vaší relaci, použijte příkaz Get-PSProvider. Některé parametry jsou dostupné jenom pro konkrétního poskytovatele. Pro více informací viz 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 pro 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 pro určení adresáře C:\Test. 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 pro určení adresáře C:\Test\Logs. 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 * 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í 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 Target objektu systému souborů vráceného Get-ChildItem.

PS D:\> New-Item -ItemType Junction -Name tmp -Target $Env:TEMP
PS D:\> Get-ChildItem | Select-Object Name, *Target

Name     Target
----     ------
tmp      {C:\Users\user1\AppData\Local\Temp}

Příklad 10: Získání cíle odkazu pro spojovací 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í hodnoty:

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

Popis těchto atributů najdete v 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)

Vlastnosti parametru

Typ:	FlagsExpression<T>[FileAttributes]
Default value:	None
Přípustné hodnoty:	Archive, Compressed, Device, Directory, Encrypted, Hidden, IntegrityStream, Normal, NoScrubData, NotContentIndexed, Offline, ReadOnly, ReparsePoint, SparseFile, System, Temporary
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-CodeSigningCert

Poznámka:

Tento parametr je dostupný pouze u poskytovatele Certificate.

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

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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:

Parametr hloubky nemá žádný vliv při použití s parametrem Include. Chcete-li tento problém vyřešit, použijte místo toho parametr Filter. Toto je opravené v PowerShellu 6 a novějším.

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.

Vlastnosti parametru

Typ:	UInt32
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	reklama, d

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-DnsName

Poznámka:

Tento parametr je dostupný pouze u poskytovatele Certificate.

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.

Vlastnosti parametru

Typ:	DnsNameRepresentation
Default value:	None
Podporuje zástupné znaky:	True
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-DocumentEncryptionCert

Poznámka:

Tento parametr je dostupný pouze u poskytovatele Certificate.

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

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Eku

Poznámka:

Tento parametr je dostupný 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 EKU.

Tento parametr byl znovu vyvolán v PowerShellu 7.1.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	True
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

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

Poznámka:

Parametry Include a Exclude nemají žádný vliv při použití s parametrem LiteralPath. Toto je opravené v PowerShellu 7.

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	True
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-ExpiringInDays

Poznámka:

Tento parametr je dostupný 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 vyvolán v PowerShellu 7.1.

Vlastnosti parametru

Typ:	Int32
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	af

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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 je předán rozhraní .NET API za účelem výčtu souborů. Rozhraní API podporuje pouze zástupné znaky * a ?.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	True
DontShow:	False

Sady parametrů

(All)

Position:	1
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

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

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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ší podle poskytovatele. Pro více informací viz about_Providers.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	ach, h

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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.

Poznámka:

Parametry Include a Exclude nemají žádný vliv při použití s parametrem LiteralPath. Toto je opravené v PowerShellu 7.

Poznámka:

Parametr hloubky nemá žádný vliv při použití s parametrem Include. Chcete-li tento problém vyřešit, použijte místo toho parametr Filter. Toto je opravené v PowerShellu 6.

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	True
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-LiteralPath

Určuje cestu k jednomu nebo více místům. Hodnota LiteralPath se používá přesně tak, jak je zadána. Žádný znak není interpretován jako zástupný znak. Pokud cesta obsahuje únikové 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 about_Quoting_Rules.

Poznámka:

Parametry Include a Exclude nemají žádný vliv při použití s parametrem LiteralPath. Toto je opravené v PowerShellu 7.

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	PSPath

Sady parametrů

LiteralItems

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Path

Určuje cestu k jednomu nebo více místům. Pokud není zadáno, výchozím umístěním je aktuální adresář (.). Zástupné cardy jsou přijímány. Při použití parametru Path s parametrem Recurse používejte opatrně. Další informace najdete v části POZNÁMKY tohoto článku.

Vlastnosti parametru

Typ:	String[]
Default value:	Current directory
Podporuje zástupné znaky:	True
DontShow:	False

Sady parametrů

Items

Position:	0
Povinné:	False
Hodnota z kanálu:	True
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

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

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	AR

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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í.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	s

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-SSLServerAuthentication

Poznámka:

Tento parametr je dostupný pouze u poskytovatele Certificate.

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

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	protože

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-UseTransaction

Zahrnuje příkaz v aktivní transakci. Tento parametr je platný pouze v případě, že probíhá transakce. Další informace najdete v tématu about_Transactions.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	usetx

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

String

Řetězec, který obsahuje cestu, můžete předat tomuto cmdletu.

Výstupy

AliasInfo

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

X509StoreLocation

X509Store

X509Certificate2

Příkaz cmdlet vypíše tyto typy souborů při přístupu k disku Cert:.

DictionaryEntry

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

DirectoryInfo

FileInfo

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

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

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

• ls
• dir
• gci

rekurzivní chování s parametrem Path:

Když použijete Get-ChildItem -Recurse s parametrem Path, rutina vyhledá poslední komponentu cesty bez ohledu na to, jestli se jedná o vzor se zástupným znakem nebo názvem literálu.

• Pokud poslední komponenta cesty odpovídá existujícímu okamžitému podadresáři cílového adresáře, rutina provede rekurzivní výčet pro odpovídající adresář.
• Pokud poslední komponenta cesty neodpovídá existujícímu okamžitému podadresáři cílového adresáře, rutina rekurzivně prohledá hierarchii cílového adresáře položky, které odpovídají komponentě poslední cesty.

Když použijete Get-ChildItem -Recurse s parametry Path a Name, chování se změní. Příkaz vyhledá poslední komponentu cesty mezi bezprostředními podřízenými položkami cílového adresáře.

• Pokud existuje shoda mezi okamžitými podřízenými položkami, rutina provede rekurzivní výčet odpovídajících položek. Porovnávání zástupných znaků probíhá pouze jednou na nejvyšší úrovni cílového adresáře. Výsledky se zpracovávají tak, jako kdyby byly jednotlivě předány do parametru LiteralPath.
• Pokud poslední komponenta cesty neodpovídá žádným položkám na nejvyšší úrovni, dojde k chybě.

Měli byste se vyhnout použití parametru Path s parametrem Recurse. Nejlepších výsledků dosáhnete:

• Pomocí LiteralPath zadejte cílový adresář, aby se zabránilo aktivaci rekurzivního vyhledávání komponenty poslední cesty.
• Pomocí parametrů Filter nebo Include zadejte zástupné kóty nebo literály, které by se měly hledat v každé úrovni hierarchie cílového adresáře.

Související odkazy

• o_poskytovateli_certifikátů
• O poskytovatelích
• o_Pravidlech_Citování
• o_poskytovateli_registru
• ForEach-Object
• Get-Alias
• Get-Item
• Get-Location
• Get-Process
• Get-PSProvider
• Split-Path