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 <uint32>]
    [-Force]
    [-Name]
    [-UseTransaction]
    [-Attributes <FlagsExpression[FileAttributes]>]
    [-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 obsahuje parametry hloubky nebo , 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ů. Pro více informací viz about_Providers.

Parametry

-Attributes

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
• Nezaindexováno obsahem
• Offline
• jen pro čtení
• ReparsePoint
• ŘídkýSoubor
• Systém
• dočasné

Popis těchto atributů naleznete 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

-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ýchozím nastavení jsou do výstupu zahrnuty názvy adresářů a 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.

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

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

-Exclude

Určuje, jako pole řetězců, vlastnost nebo vlastnost, které tato rutina vylučuje z operace. Hodnota tohoto parametru kvalifikuje parametr Path. 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.

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

-File

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 použití filtrů. Filtry jsou efektivnější než jiné parametry, protože je poskytovatel použije, když rutina získá objekty místo toho, aby objekty po jejich načtení vyfiltroval PowerShell. Řetězec filtru je předán rozhraní .NET API za účelem výčtu souborů. Toto rozhraní API podporuje pouze * a ? zástupnými cardy.

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

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

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, jako pole řetězců, jednu nebo více položek, které tento cmdlet zahrnuje v operaci. Hodnota tohoto parametru kvalifikuje parametr Path. 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.

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 žádné znaky neinterpretoval jako únikové sekvence.

Další informace najdete v about_Quoting_Rules.

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. Jsou povoleny zástupné symboly.

Vlastnosti parametru

Typ:	SwitchParameter
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

-Path

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

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

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

-System

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 k Get-ChildItem, můžete pipetovat .

Výstupy

Object

Typ objektu, který Get-ChildItem vrací, je určen objekty v cestě jednotky zprostředkovatele.

String

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

Poznámky

• Na Get-ChildItem můžete odkazovat pomocí předdefinovaných aliasů, ls, dira gci. Další informace viz about_Aliases.
• 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 jakýmkoli poskytovatelem. Chcete-li zobrazit seznam poskytovatelů dostupných ve vaší relaci, napište Get-PSProvider. Pro více informací viz about_Providers.

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