Get-Item

Modul:

Microsoft.PowerShell.Management Module

Lekérdezi az elemet a megadott helyen.

Syntax

Path (Default) - FileSystem provider

Get-Item
    [-Path] <string[]>
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Force]
    [-Credential <pscredential>]
    [-Stream <string[]>]
    [<CommonParameters>]

LiteralPath - FileSystem provider

Get-Item
    -LiteralPath <string[]>
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Force]
    [-Credential <pscredential>]
    [-Stream <string[]>]
    [<CommonParameters>]

Path (Default) - Certificate provider

Get-Item
    [-Path] <string[]>
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Force]
    [-Credential <pscredential>]
    [-CodeSigningCert]
    [-DocumentEncryptionCert]
    [-SSLServerAuthentication]
    [-DnsName <string>]
    [-Eku <string[]>]
    [-ExpiringInDays <int>]
    [<CommonParameters>]

LiteralPath - Certificate provider

Get-Item
    -LiteralPath <string[]>
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Force]
    [-Credential <pscredential>]
    [-CodeSigningCert]
    [-DocumentEncryptionCert]
    [-SSLServerAuthentication]
    [-DnsName <string>]
    [-Eku <string[]>]
    [-ExpiringInDays <int>]
    [<CommonParameters>]

Path (Default) - All providers

Get-Item
    [-Path] <string[]>
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Force]
    [-Credential <pscredential>]
    [<CommonParameters>]

LiteralPath - All providers

Get-Item
    -LiteralPath <string[]>
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Force]
    [-Credential <pscredential>]
    [<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

-CodeSigningCert

Ez egy dinamikus paraméter, amelyet a tanúsítványszolgáltató elérhetővé tett. Ez a paraméter és a tanúsítvány szolgáltató csak Windows rendszeren érhető el.

A tanúsítványok, amelyek Code Signing értéket tartalmaznak a EnhancedKeyUsageList tulajdonságukban, lekéréséhez használja a CodeSigningCert paramétert.

További információért lásd a about_Certificate_Providerrészt.

Paramétertulajdonságok

Típus:	SwitchParameter
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

-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

-DnsName

Ez egy dinamikus paraméter, amelyet a tanúsítványszolgáltató elérhetővé tett. Ez a paraméter és a tanúsítvány szolgáltató csak Windows rendszeren érhető el.

Olyan tartománynevet vagy névmintát ad meg, amely megfelel a parancsmag által lekért tanúsítványok DNSNameList tulajdonságának. A paraméter értéke lehet Unicode vagy ASCII. A punycode-értékek Unicode-ra lesznek konvertálva. A helyettesítő karakterek (*) használata engedélyezett.

Ezt a paramétert újra bevezették a PowerShell 7.1-ben

További információért lásd a about_Certificate_Providerrészt.

Paramétertulajdonságok

Típus:	DnsNameRepresentation
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

-DocumentEncryptionCert

Ez egy dinamikus paraméter, amelyet a tanúsítványszolgáltató elérhetővé tett. Ez a paraméter és a tanúsítvány szolgáltató csak Windows rendszeren érhető el.

Ha olyan tanúsítványokat szeretne lekérni, amelyek Document Encryption tulajdonságértékében , használja a DocumentEncryptionCert paramétert.

További információért lásd a about_Certificate_Providerrészt.

Paramétertulajdonságok

Típus:	SwitchParameter
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

-Eku

Ez egy dinamikus paraméter, amelyet a tanúsítványszolgáltató elérhetővé tett. Ez a paraméter és a tanúsítvány szolgáltató csak Windows rendszeren érhető el.

Adja meg a szöveget vagy szövegmintát, amely illeszkedik a parancsmag által lekért tanúsítványok EnhancedKeyUsageList tulajdonságához. A helyettesítő karakterek (*) használata engedélyezett. A EnhancedKeyUsageList tulajdonság tartalmazza az EKU barátságos nevét és az OID mezőket.

Ezt a paramétert újra bevezették a PowerShell 7.1-ben

További információért lásd a about_Certificate_Providerrészt.

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

-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

-ExpiringInDays

Ez egy dinamikus paraméter, amelyet a tanúsítványszolgáltató elérhetővé tett. Ez a paraméter és a tanúsítvány szolgáltató csak Windows rendszeren érhető el.

Megadja, hogy a parancsmag csak a megadott számú napon belül vagy azt megelőzően lejáró tanúsítványokat adja vissza. A nulla (0) érték megkapja a lejárt tanúsítványokat.

Ezt a paramétert újra bevezették a PowerShell 7.1-ben

További információért lásd a about_Certificate_Providerrészt.

Paramétertulajdonságok

Típus:	Int32
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

-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

-SSLServerAuthentication

Ez egy dinamikus paraméter, amelyet a tanúsítványszolgáltató elérhetővé tett. Ez a paraméter és a tanúsítvány szolgáltató csak Windows rendszeren érhető el.

A Server Authentication paraméter használatával szerezhet be olyan tanúsítványokat, amelyeknek az EnhancedKeyUsageList tulajdonsága tartalmazza a értéket.

További információért lásd a about_Certificate_Providerrészt.

Paramétertulajdonságok

Típus:	SwitchParameter
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

-Stream

Ez a FileSystem szolgáltató által elérhetővé tett dinamikus paraméter. Ez a paraméter csak Windows rendszeren érhető el.

Lekéri a megadott alternatív adatfolyamot 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 érvényes a könyvtárakra, de vegye figyelembe, hogy a könyvtárak alapértelmezés szerint nem rendelkeznek adatfolyamokkal.

Ezt a paramétert a PowerShell 3.0-ban vezettük be. A PowerShell 7.2-től a Get-Item más adatfolyamokat is lekérhet könyvtárakból és fájlokból.

Lásd about_FileSystem_Providera további információkért.

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

AliasInfo

A parancsmag ezt a típust adja ki a Alias: meghajtó elérésekor.

X509StoreLocation

X509Store

X509Certificate2

A parancsmag ezeket a típusokat a Cert: meghajtó elérésekor adja ki.

DictionaryEntry

A parancsmag ezt a típust adja ki a Env: meghajtó elérésekor.

DirectoryInfo

FileInfo

A parancsmag ezeket a típusokat kimeneteli a Fájlrendszer-meghajtók elérésekor.

FunctionInfo

FilterInfo

A parancsmag ezeket a típusokat a Function: meghajtók elérésekor adja ki.

RegistryKey

A parancsmag ezt a típust adja ki a beállításjegyzék-meghajtók elérésekor.

PSVariable

A parancsmag ezt a típust adja ki a Variable: meghajtók elérésekor.

WSManConfigContainerElement

WSManConfigLeafElement

A parancsmag ezeket a típusokat a WSMan: meghajtók elérésekor adja ki.

Jegyzetek

A PowerShell a következő aliasokat tartalmazza Get-Item:

• Minden platform:
  • gi

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.

Kapcsolódó hivatkozások

• Elem törlése
• Másolás-Elem
• Invoke-Item
• Áthelyezés-Elem
• Új-Elem
• Elem eltávolítása
• Átnevezés-Elem
• Set-Item
• Get-ChildItem
• Get-ItemProperty (Tulajdonság lekérése)
• Get-PSProvider
• A szolgáltatókról