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>]
[-UseTransaction]
[-Stream <String[]>]
[<CommonParameters>]
LiteralPath
Get-Item
-LiteralPath <String[]>
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Force]
[-Credential <PSCredential>]
[-UseTransaction]
[-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 parancs 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 parancs az aktuális könyvtár összes elemét lekéri. A helyettesítő karakter ('*') az aktuális elem összes 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 parancs lekéri a C: meghajtó aktuális könyvtárát. 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 parancs lekéri a C: meghajtó elemeit. A helyettesítő karakter ('*') a tároló összes elemét jelöli, nem csak a tárolót.
A PowerShellben a hagyományos "helyett egyetlen csillagot ('
Get-Item C:\*
5. példa: Tulajdonság lekérése a megadott könyvtárban
Ez a parancs lekéri a "C:\Windows" könyvtár LastAccessTime tulajdonságát.
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 parancs a Microsoft.PowerShell beállításkulcs 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 parancs lekéri a Windows könyvtárban a pont ('.') elemet tartalmazó elemeket, de nem a "w*" betűvel kezdődik. Ez a parancs 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*"
Paraméterek
-Credential
A művelet végrehajtásához engedéllyel rendelkező felhasználói fiókot ad meg. Az alapértelmezett az aktuális felhasználó.
Írjon be egy felhasználónevet (például "User01" vagy "Domain01\User01"), vagy írjon be egy PSCredential objektumot, például a Get-Credential parancsmag által létrehozott objektumot.
Ha felhasználónevet ír be, a rendszer jelszót kér.
Figyelmeztetés
Ezt a paramétert a Windows PowerShell-lel telepített szolgáltatók nem támogatják.
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 lép érvénybe, 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
A szűrőt a szolgáltató formátumában vagy nyelvén adja meg. Ennek a paraméternek az értéke a Elérési út paramétert minősíti.
A szűrő szintaxisa, beleértve a helyettesítő karakterek használatát is, a szolgáltatótól függ. 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.
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.
A Belefoglalá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 |
-LiteralPath
Megadja az elem elérési útját. A Path paramétertől eltérően a LiteralPath értéke pontosan a beíráskor lesz használva. 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.
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
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. 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. Használja a helyettesítő karaktert (*) az aktuális hely összes elemének megadásához.
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
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.
A 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 |
-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
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.