Get-Item
Lekéri az elemet a megadott helyen.
Syntax
Path (Alapértelmezett)
Get-Item
[-Path] <String[]>
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Force]
[-Credential <PSCredential>]
[-Stream <String[]>]
[<CommonParameters>]
LiteralPath
Get-Item
-LiteralPath <String[]>
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Force]
[-Credential <PSCredential>]
[-Stream <String[]>]
[<CommonParameters>]
Description
A Get-Item parancsmag a megadott helyen kapja meg az elemet. Csak akkor kapja meg az elem tartalmát a helyen, ha helyettesítő karaktert (*) használ az elem teljes tartalmának lekéréséhez.
Ezt a parancsmagot a PowerShell-szolgáltatók használják a különböző típusú adattárak közötti navigáláshoz.
Példák
1. példa: Az aktuális könyvtár lekérése
Ez a példa lekéri az aktuális könyvtárat. A pont ('.') az aktuális helyen lévő elemet jelöli (nem annak tartalmát).
Get-Item .
Directory: C:\
Mode LastWriteTime Length Name
---- ------------- ------ ----
d---- 7/26/2006 10:01 AM ps-test
2. példa: Az aktuális könyvtár összes elemének lekérése
Ez a példa lekéri az aktuális könyvtár összes elemét. A helyettesítő karakter (*) az aktuális elem teljes tartalmát jelöli.
Get-Item *
Directory: C:\ps-test
Mode LastWriteTime Length Name
---- ------------- ------ ----
d---- 7/26/2006 9:29 AM Logs
d---- 7/26/2006 9:26 AM Recs
-a--- 7/26/2006 9:28 AM 80 date.csv
-a--- 7/26/2006 10:01 AM 30 filenoext
-a--- 7/26/2006 9:30 AM 11472 process.doc
-a--- 7/14/2006 10:47 AM 30 test.txt
3. példa: Meghajtó aktuális könyvtárának lekérése
Ez a példa a C: meghajtó aktuális könyvtárát kéri le. A lekért objektum csak a könyvtárat jelöli, a tartalmát nem.
Get-Item C:
4. példa: Elemek lekérése a megadott meghajtón
Ez a példa megszerzi a C: meghajtó elemeit. A helyettesítő karakter (*) a tároló összes elemét jelöli, nem csak a tárolót.
Get-Item C:\*
A PowerShellben a hagyományos *helyett egyetlen csillagot (*.*) használjon a tartalom lekéréséhez. A formátum szó szerint értelmezve van, így *.* pont nélkül nem kér le könyvtárakat vagy fájlneveket.
5. példa: Tulajdonság lekérése a megadott könyvtárban
Ez a példa a könyvtár C:\Windows tulajdonságát kapja meg.
LastAccessTime csak a fájlrendszerkönyvtárak egyik tulajdonsága. Egy könyvtár összes tulajdonságának megtekintéséhez írja be a (Get-Item <directory-name>) | Get-Member.
(Get-Item C:\Windows).LastAccessTime
6. példa: Beállításkulcs tartalmának megjelenítése
Ez a példa a Microsoft.PowerShell beállításkulcs tartalmát mutatja be. Ezt a parancsmagot a PowerShell beállításjegyzék-szolgáltatójával használhatja a beállításkulcsok és alkulcsok lekéréséhez, de a beállításjegyzék értékeinek és adatainak lekéréséhez a Get-ItemProperty parancsmagot kell használnia.
Get-Item HKLM:\Software\Microsoft\Powershell\1\Shellids\Microsoft.Powershell\
7. példa: Kizárással rendelkező címtár elemeinek lekérése
Ez a példa beolvasja a Windows könyvtárban azokat az elemeket, amelyek pontot (.) tartalmaznak a nevükben, de nem kezdődnek w*-gyel. Ez a példa csak akkor működik, ha az elérési út helyettesítő karaktert (*) tartalmaz az elem tartalmának megadásához.
Get-Item C:\Windows\*.* -Exclude "w*"
8. példa: A hardlink-információk lekérése
A PowerShell 6.2-ben egy másik nézet lett hozzáadva a hardlink-információk lekéréséhez. A hardlink-információk megszerzéséhez irányítsa a kimenetet a Format-Table -View childrenWithHardlink-ra.
Get-Item C:\Windows\System32\ntoskrnl.exe | Format-Table -view childrenWithHardLink
Directory: C:\Windows\System32
Mode LastWriteTime Length Name
---- ------------- ------ ----
la--- 5/12/2021 7:40 AM 10848576 ntoskrnl.exe
A Mode tulajdonság a l által az la----ben azonosítja a hardlinket.
9. példa: Nem Windows operációs rendszerek kimenete
A Unix-rendszereken futó PowerShell 7.1-ben a Get-Item parancsmag Unix-szerű kimenetet biztosít:
PS> Get-Item /Users
Directory: /
UnixMode User Group LastWriteTime Size Name
-------- ---- ----- ------------- ---- ----
drwxr-xr-x root admin 12/20/2019 11:46 192 Users
A kimenet részét képező új tulajdonságok a következők:
- UnixMode a Unix-rendszeren ábrázolt fájlengedélyek
- felhasználói a fájl tulajdonosa
- csoport a csoport tulajdonosa
- mérete a Unix-rendszeren ábrázolt fájl vagy könyvtár mérete
Megjegyzés:
Ezt a funkciót a PowerShell 7.1-ben a kísérleti verzióról a mainstreamre helyezték át.
Paraméterek
-Credential
Megjegyzés:
Ezt a paramétert a PowerShell-lel telepített szolgáltatók nem támogatják. Ha egy másik felhasználó szerepében szeretne fellépni, vagy emelni szeretné hitelesítő adatait a parancsmag futtatásakor, használja a Invoke-Command.
Paramétertulajdonságok
| Típus: | PSCredential |
| Alapértelmezett érték: | Current user |
| 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: | True |
| Fennmaradó argumentumokból származó érték: | False |
-Exclude
Sztringtömbként olyan elemet vagy elemeket határoz meg, amelyeket 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. A helyettesítő karakterek használata engedélyezett. A Kizárás 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 |
-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őket. A szűrők hatékonyabbak, mint a többi paraméter. A szolgáltató akkor alkalmazza a szűrőt, ha a parancsmag lekéri az objektumokat ahelyett, hogy a PowerShell a lekérés után szűri az objektumokat. A szűrőkarakterláncot a fájlok felsorolásához továbbítják a .NET API-nak. 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: | 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 |
-Force
Azt jelzi, hogy ez a parancsmag olyan elemeket kap, amelyek egyébként nem érhetők el, például rejtett elemeket. A megvalósítás szolgáltatónként eltérő. További információért lásd a about_Providerscímű részt. A parancsmag még a Force paraméter használatával sem tudja felülbírálni a biztonsági korlátozásokat.
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 |
-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ékét pontosan a beírt módon használja a rendszer. 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, LP |
Paraméterkészletek
LiteralPath
| 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 |
-Path
Egy elem elérési útját adja meg. Ez a parancsmag lekéri az elemet a megadott helyen. A helyettesítő karakterek használata engedélyezett. Ez a paraméter kötelező, de a paraméter neve Elérési út megadása nem kötelező.
Az aktuális hely megadásához használjon egy pont (.) értéket. A helyettesítő karakter (*) használatával adja meg az aktuális hely összes elemét.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | True |
| DontShow: | False |
Paraméterkészletek
Path
| Position: | 0 |
| Kötelező: | True |
| 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 |
-Stream
Megjegyzés:
Ez a paraméter csak Windows rendszeren érhető el.
Lekéri a megadott másodlagos NTFS-fájlstreamet a fájlból. Adja meg a stream nevét. A helyettesítő karakterek használatát támogatjuk. Az összes stream lekéréséhez használjon csillagot (*). Ez a paraméter nem érvényes mappákban.
Stream egy dinamikus paraméter, amelyet a Fájlrendszer-szolgáltató hozzáad a Get-Item parancsmaghoz.
Ez a paraméter csak fájlrendszer-meghajtókon működik.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | No alternate file streams |
| 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 |
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
Egy elérési utat tartalmazó karakterláncot küldhet tovább ehhez a cmdlethez.
Kimenetek
Object
Ez a parancsmag visszaadja a lekért objektumokat. A típust az elérési út objektumtípusa határozza meg.
Jegyzetek
Ez a parancsmag nem rendelkezik Recurse paraméterrel, mert csak egy elemet kap, a tartalmát nem.
Ha egy elem tartalmát rekurzív módon szeretné lekérni, használja a Get-ChildItem.
A beállításjegyzékben való navigáláshoz használja ezt a parancsmagot a beállításkulcsok és a Get-ItemProperty lekéréséhez a beállításjegyzék értékeinek és adatainak lekéréséhez. A beállításjegyzék értékei a beállításkulcs tulajdonságainak minősülnek.
Ez a parancsmag ú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 a Get-PsProvider. További információért lásd a about_Providerscímű részt.