Get-Item
Lekéri az elemet a megadott helyen.
Syntax
Get-Item
[-Path] <string[]>
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Force]
[-Credential <pscredential>]
[-Stream <string[]>]
[<CommonParameters>]
Get-Item
-LiteralPath <string[]>
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Force]
[-Credential <pscredential>]
[-Stream <string[]>]
[<CommonParameters>]
Get-Item
[-Path] <string[]>
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Force]
[-Credential <pscredential>]
[-CodeSigningCert]
[-DocumentEncryptionCert]
[-SSLServerAuthentication]
[-DnsName <string>]
[-Eku <string[]>]
[-ExpiringInDays <int>]
[<CommonParameters>]
Get-Item
-LiteralPath <string[]>
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Force]
[-Credential <pscredential>]
[-CodeSigningCert]
[-DocumentEncryptionCert]
[-SSLServerAuthentication]
[-DnsName <string>]
[-Eku <string[]>]
[-ExpiringInDays <int>]
[<CommonParameters>]
Get-Item
[-Path] <string[]>
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Force]
[-Credential <pscredential>]
[<CommonParameters>]
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. Egyes paraméterek csak egy adott szolgáltatóhoz érhetők el. További információ: about_Providers.
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 az aktuális könyvtár összes elemét lekéri. 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 lekéri a meghajtó aktuális könyvtárát C:
. 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 beolvasja a meghajtó elemeit C:
. 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 használjon egyetlen csillagot (*
) a tartalom lekéréséhez. A formátum szó szerint értelmezve van, ezért *.*
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 LastAccessTime tulajdonságát C:\Windows
kapja meg. A LastAccessTime csak a fájlrendszerkönyvtárak egyik tulajdonsága. Egy könyvtár összes tulajdonságának megtekintéséhez írja be a következőt (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ár olyan elemeit, amelyekben egy pont (.
) szerepel, de nem a következővel w*
kezdődik: 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 kapcsolati adatok 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 lekéréséhez a kimenetet a következőre kell becsúsznia: Format-Table -View childrenWithHardlink
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 azonosítja a hardlinket a l
la---
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:
- A UnixMode a Unix-rendszeren ábrázolt fájlengedélyek
- A felhasználó a fájl tulajdonosa
- A csoport a csoport tulajdonosa
- A méret a Unix-rendszeren ábrázolt fájl vagy könyvtár mérete
Feljegyzé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 a tanúsítványszolgáltató által elérhetővé tett dinamikus paraméter. Ez a paraméter és a tanúsítványszolgáltató csak Windows rendszeren érhető el.
Az EnhancedKeyUsageList tulajdonságértékben lévő Code Signing
tanúsítványok lekéréséhez használja a CodeSigningCert paramétert.
További információ: about_Certificate_Provider.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Credential
Feljegyzés
Ezt a paramétert a PowerShell-lel telepített szolgáltatók nem támogatják. Ha megszemélyesíteni szeretne egy másik felhasználót, vagy a parancsmag futtatásakor emeli a hitelesítő adatait, használja az Invoke-Command parancsot.
Típus: | PSCredential |
Position: | Named |
Alapértelmezett érték: | Current user |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-DnsName
Ez a tanúsítványszolgáltató által elérhetővé tett dinamikus paraméter. Ez a paraméter és a tanúsítványszolgáltató csak Windows rendszeren érhető el.
A parancsmag által lekért tanúsítványok DNSNameList tulajdonságával egyező tartománynevet vagy névmintát ad meg. Ennek a paraméternek az é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ó: about_Certificate_Provider.
Típus: | DnsNameRepresentation |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | True |
-DocumentEncryptionCert
Ez a tanúsítványszolgáltató által elérhetővé tett dinamikus paraméter. Ez a paraméter és a tanúsítványszolgáltató csak Windows rendszeren érhető el.
Az EnhancedKeyUsageList tulajdonságértékkel rendelkező Document Encryption
tanúsítványok lekéréséhez használja a DocumentEncryptionCert paramétert.
További információ: about_Certificate_Provider.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Eku
Ez a tanúsítványszolgáltató által elérhetővé tett dinamikus paraméter. Ez a paraméter és a tanúsítványszolgáltató csak Windows rendszeren érhető el.
A parancsmag által lekért tanúsítványok EnhancedKeyUsageList tulajdonságával egyező szöveget vagy szövegmintát határoz meg. A helyettesítő karakterek (*
) használata engedélyezett. Az EnhancedKeyUsageList tulajdonság tartalmazza az EKU rövid nevét és OID mezőit.
Ezt a paramétert újra bevezették a PowerShell 7.1-ben
További információ: about_Certificate_Provider.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | True |
-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 az 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\*
ha a helyettesítő karakter a könyvtár tartalmát C:\Windows
adja meg.
Típus: | String[] |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | True |
-ExpiringInDays
Ez a tanúsítványszolgáltató által elérhetővé tett dinamikus paraméter. Ez a paraméter és a tanúsítványszolgá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 lekéri a lejárt tanúsítványokat.
Ezt a paramétert újra bevezették a PowerShell 7.1-ben
További információ: about_Certificate_Provider.
Típus: | Int32 |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Filter
Egy szűrőt ad meg, amely megfelel az Elérési út paraméternek. A FileSystem-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ősztring a .NET API-nak továbbítja a fájlok számbavételéhez. Az API csak támogatja *
és ?
helyettesítő karaktereket.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | True |
-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ó: about_Providers. A Parancsmag még a Force paraméter használatával sem tudja felülbírálni a biztonsági korlátozásokat.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | False |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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 az 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\*
amikor a helyettesítő karakter a könyvtár tartalmát C:\Windows
adja meg.
Típus: | String[] |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | True |
-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 út tartalmaz escape karaktereket, csatolja egy idézőjelek közé. Az idézőjelek azt mondják a PowerShellnek, hogy ne értelmezzen karaktereket feloldósorozatként.
További információ: about_Quoting_Rules.
Típus: | String[] |
Aliasok: | PSPath, LP |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | 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 az Elérési út paraméter neve nem kötelező.
Az aktuális hely megadásához használjon pont (.
) értéket. A helyettesítő karakter (*
) használatával adja meg az aktuális hely összes elemét.
Típus: | String[] |
Position: | 0 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | True |
-SSLServerAuthentication
Ez a tanúsítványszolgáltató által elérhetővé tett dinamikus paraméter. Ez a paraméter és a tanúsítványszolgáltató csak Windows rendszeren érhető el.
Az EnhancedKeyUsageList tulajdonságértékkel rendelkező Server Authentication
tanúsítványok lekéréséhez használja az SSLServerAuthentication paramétert.
További információ: about_Certificate_Provider.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Stream
Ez a fájlrendszer-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 támogatottak. 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 Get-Item
alternatív adatfolyamokat szerezhet be könyvtárakból és fájlokból.
További információ: about_FileSystem_Provider.
Típus: | String[] |
Position: | Named |
Alapértelmezett érték: | No alternate file streams |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | True |
Bevitelek
A parancsmag elérési útját tartalmazó sztringet csövezheti.
Kimenetek
A parancsmag ezt a típust adja ki a Alias:
meghajtó elérésekor.
A parancsmag ezeket a típusokat kimeneteli a Cert:
meghajtó elérésekor.
A parancsmag ezt a típust adja ki a Env:
meghajtó elérésekor.
A parancsmag ezeket a típusokat a fájlrendszer-meghajtók elérésekor adja ki.
A parancsmag ezeket a típusokat a meghajtók elérésekor Function:
adja ki.
A parancsmag ezt a típust adja ki a beállításjegyzék-meghajtók elérésekor.
A parancsmag ezt a típust adja ki a Variable:
meghajtók elérésekor.
A parancsmag ezeket a típusokat a meghajtók elérésekor WSMan:
adja ki.
Jegyzetek
A PowerShell a következő aliasokat Get-Item
tartalmazza:
- Minden platform:
gi
Ez a parancsmag nem rendelkezik Recurse paraméterrel, mert csak egy elemet kap, nem a tartalmát.
Ha egy elem tartalmát rekurzív módon szeretné lekérni, használja a következőt Get-ChildItem
: .
A beállításjegyzékben való navigáláshoz használja ezt a parancsmagot a beállításkulcsok lekéréséhez, valamint a Get-ItemProperty
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 következőt Get-PsProvider
: További információ: about_Providers.