Get-ChildItem
Lekéri az elemeket és a gyermekelemeket egy vagy több megadott helyen.
Syntax
Items (Alapértelmezett)
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
A Get-ChildItem parancsmag lekéri az elemeket egy vagy több megadott helyen. Ha az elem egy tároló, a tárolóban lévő elemeket, más néven gyermekelemeket kapja meg. A Recurse paraméter használatával lekérheti az elemeket az összes gyermektárolóban, és a Mélység paraméter használatával korlátozhatja a rekurzívan bejárandó szintek számát.
Get-ChildItem nem jelenít meg üres könyvtárakat. Ha egy Get-ChildItem parancs tartalmazza a Mélységi vagy Recurse paramétereket, a kimenet nem tartalmaz üres könyvtárakat.
A helyszínek a PowerShell-szolgáltatók által a Get-ChildItem-nek vannak kitéve. A hely lehet fájlrendszerkönyvtár, beállításjegyzék-hive vagy tanúsítványtároló. További információért lásd a about_Providerscímű részt.
Paraméterek
-Attributes
Lekéri a megadott attribútumokkal rendelkező fájlokat és mappákat. Ez a paraméter támogatja az összes attribútumot, és lehetővé teszi az attribútumok összetett kombinációjának megadását.
Ha például titkosított vagy tömörített rendszer nélküli fájlokat (nem könyvtárakat) szeretne lekérni, írja be a következőt:
Get-ChildItem -Attributes !Directory+!System+Encrypted, !Directory+!System+Compressed
A gyakran használt attribútumokkal rendelkező fájlok és mappák kereséséhez használja az Attribútumok paramétert. Vagy a címtár , fájl, Rejtett, ReadOnlyés Rendszerparamétereket.
Az attribútumok paraméter a következő tulajdonságokat támogatja:
- Archívum
- tömörített
- Eszköz
- Címtár
- Titkosított
- rejtett
- IntegrityStream
- Normális
- NoScrubData
- Nem tartalomindexelt
- Offline
- Csak olvasható
- ReparsePoint
- SparseFile
- Rendszer
- ideiglenes
Ezeknek az attribútumoknak a leírását a FileAttributes Enumerationcímű cikkben talál.
Az attribútumok kombinálásához használja a következő operátorokat:
-
!(NEM) -
+(ÉS) -
,(VAGY)
Ne használjon szóközöket egy operátor és attribútuma között. A vesszők után szóközök elfogadhatók.
Gyakori attribútumok esetén használja a következő rövidítéseket:
-
D(címtár) -
H(rejtett) -
R(írásvédett) -
S(rendszer)
Paramétertulajdonságok
| Típus: | |
| Alapértelmezett érték: | None |
| Elfogadott értékek: | Archive, Compressed, Device, Directory, Encrypted, Hidden, IntegrityStream, Normal, NoScrubData, NotContentIndexed, Offline, ReadOnly, ReparsePoint, SparseFile, System, Temporary |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Depth
Ez a paraméter a PowerShell 5.0-s verziójában lett hozzáadva, és lehetővé teszi a rekurzió mélységének szabályozását. Alapértelmezés szerint Get-ChildItem megjeleníti a szülőkönyvtár tartalmát. A Depth paraméter határozza meg a rekurzióban szereplő alkönyvtárszintek számát, és megjeleníti a tartalmat.
A Depth 2 például tartalmazza a Elérési út paraméter könyvtárát, az alkönyvtárak első szintjét és az alkönyvtárak második szintjét. Alapértelmezés szerint a könyvtárnevek és a fájlnevek szerepelnek a kimenetben.
Megjegyzés:
A PowerShell-ből vagy cmd.exewindowsos számítógépen megjelenítheti a könyvtárszerkezet grafikus nézetét a tree.com paranccsal.
Paramétertulajdonságok
| Típus: | UInt32 |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Directory
A címtárak listájának lekéréséhez használja a Címtár paramétert vagy a Attribútumok paramétert a Directory tulajdonsággal. A Recurse paramétert használhatja Directory.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | hirdetés, d |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Exclude
Karakterlánctömbként olyan tulajdonságot vagy tulajdonságot határoz meg, amelyet ez a parancsmag kizár a műveletből.
Ennek a paraméternek az értéke a Elérési út paramétert minősíti. Adjon meg egy elérési út elemet vagy mintát, például *.txt vagy A*. A helyettesítő karaktereket a rendszer elfogadja.
A * paraméter végén lévő csillag () megadása nem kötelező. Például, -Path C:\Test\Logs vagy -Path C:\Test\Logs\*. Ha egy záró csillagot (*) tartalmaz, a parancs rekurzívan belép a elérési út paraméterének alkönyvtáraiba. A csillag (*) nélkül a Elérési út paraméter tartalma jelenik meg. További részletek az 5. példában és a Megjegyzések szakaszban találhatók.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | True |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-File
A fájlok listájának lekéréséhez használja a Fájl paramétert. A Recurse paramétert használhatja Fájl.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | af |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Filter
Szűrőt ad meg a útvonal paraméter minősítéséhez. A Fájlrendszer szolgáltató az egyetlen telepített PowerShell-szolgáltató, amely támogatja a szűrők használatát. A szűrők hatékonyabbak, mint a többi paraméter, mivel a szolgáltató akkor alkalmazza őket, amikor a parancsmag lekéri az objektumokat, és nem azt, hogy a PowerShell szűrje az objektumokat a lekérés után. A szűrőkarakterláncot a fájlok felsorolásához továbbítják a .NET API-nak. Ez az API csak * és ? helyettesítő karaktereket támogat.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | True |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | 1 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Force
Lehetővé teszi a parancsmag számára, hogy olyan elemeket szerezzen be, amelyeket egyébként nem tud elérni a felhasználó, például rejtett vagy rendszerfájlokat. A Force paraméter nem bírálja felül a biztonsági korlátozásokat. A megvalósítás a szolgáltatók között eltérő. További információért lásd a about_Providerscímű részt.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Hidden
Ha csak rejtett elemeket szeretne lekérni, használja a Rejtett paramétert vagy az Attribútumok paramétert a Rejtett tulajdonsággal. Alapértelmezés szerint a Get-ChildItem nem jeleníti meg a rejtett elemeket. A rejtett elemek lekéréséhez használja a Force paramétert.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | ah, h |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Include
Sztringtömbként egy elemet vagy elemet határoz meg, amelyet ez a parancsmag tartalmaz a műveletben. Ennek a paraméternek az értéke a Elérési út paramétert minősíti. Adjon meg egy elérési út elemet vagy mintát, például "*.txt". A helyettesítő karakterek használata engedélyezett. Az Include paraméter csak akkor érvényes, ha a parancs egy elem tartalmát tartalmazza, például C:\Windows\*, ahol a helyettesítő karakter a C:\Windows könyvtár tartalmát adja meg.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | True |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-LiteralPath
Egy vagy több hely elérési útját adja meg. A LiteralPath értéke pontosan a beíráskor használatos. A rendszer egyetlen karaktert sem értelmez helyettesítő karakterként. Ha az elérési útvonal escape karaktereket tartalmaz, tedd azt egyes idézőjelek közé. Az egyes idézőjelek azt mondják a PowerShellnek, hogy egyetlen karaktert se értelmezzen escape szekvenciaként.
További információk az about_Quoting_Rules oldalon találhatók: .
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | PSPath |
Paraméterkészletek
LiteralItems
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-Name
Csak a hely elemeinek nevét kapja meg. A kimenet egy sztringobjektum, amely elküldhető a folyamaton keresztül más parancsok számára. Helyettesítő karakterek használata engedélyezett.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | True |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Path
Egy vagy több hely elérési útját adja meg. A helyettesítő karaktereket a rendszer elfogadja. Az alapértelmezett hely az aktuális könyvtár (.).
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | Current directory |
| Támogatja a helyettesítő karaktereket: | True |
| DontShow: | False |
Paraméterkészletek
Items
| Position: | 0 |
| Kötelező: | False |
| Folyamatból származó érték: | True |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-ReadOnly
Csak írásvédett elemek lekéréséhez használja a ReadOnly paramétert, vagy az Attribútumok paraméter ReadOnly tulajdonságot.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Ar |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Recurse
Megszerzi az elemeket a megadott helyeken és a helyek összes gyermekelemeiben.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | s |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-System
Csak a rendszerfájlokat és könyvtárakat kapja meg. Ha csak rendszerfájlokat és mappákat szeretne lekérni, használja a System paramétert vagy Attribútumokat paramétert System tulajdonságot.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | amint |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-UseTransaction
Tartalmazza a parancsot az aktív tranzakcióban. Ez a paraméter csak akkor érvényes, ha egy tranzakció folyamatban van. További információ: about_Transactions.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | usetx |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.
Bevitelek
String
A Get-ChildItemelérési útját tartalmazó sztringet csövezheti.
Kimenetek
Object
A Get-ChildItem visszaadott objektum típusát a szolgáltató meghajtó elérési útjának objektumai határozzák meg.
String
Ha a Név paramétert használja, Get-ChildItem sztringekként adja vissza az objektumneveket.
Jegyzetek
- A
Get-ChildItema beépített aliasai,ls,dirésgcialapján tekintheti meg. További információ: about_Aliases. -
Get-ChildItemalapértelmezés szerint nem kap rejtett elemeket. Rejtett elemek lekéréséhez használja a Force paramétert. - A
Get-ChildItemparancsmag úgy lett kialakítva, hogy bármely szolgáltató által közzétett adatokkal működjön együtt. A munkamenetben elérhető szolgáltatók listájához írja be aGet-PSProvider. További információért lásd a about_Providerscímű részt.