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-test2. 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.txt3. 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).LastAccessTime6. 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.exeA Mode tulajdonság azonosítja a hardlinket a lla---
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 UsersA 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | PSCredential |
| Position: | Named |
| Default value: | Current user |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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.
| Type: | DnsNameRepresentation |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String[] |
| Aliases: | PSPath, LP |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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.
| Type: | String[] |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String[] |
| Position: | Named |
| Default value: | No alternate file streams |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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-Itemtartalmazza:
- 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.
Kapcsolódó hivatkozások
Visszajelzés
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ: https://aka.ms/ContentUserFeedback.
Visszajelzés küldése és megtekintése a következőhöz: