Get-Item
Lekéri az elemet a megadott helyen.
Syntax
Get-Item
[-Path] <String[]>
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Force]
[-Credential <PSCredential>]
[-UseTransaction]
[-Stream <String[]>]
[<CommonParameters>]
Get-Item
-LiteralPath <String[]>
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Force]
[-Credential <PSCredential>]
[-UseTransaction]
[-Stream <String[]>]
[<CommonParameters>]
Get-Item
[-Path] <string[]>
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Force]
[-Credential <pscredential>]
[-UseTransaction]
[-CodeSigningCert]
[-DocumentEncryptionCert]
[-SSLServerAuthentication]
[-DnsName <string>]
[-Eku <string[]>]
[-ExpiringInDays <int>]
[<CommonParameters>]
Get-Item
-LiteralPath <string[]>
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Force]
[-Credential <pscredential>]
[-UseTransaction]
[-CodeSigningCert]
[-DocumentEncryptionCert]
[-SSLServerAuthentication]
[-DnsName <string>]
[-Eku <string[]>]
[-ExpiringInDays <int>]
[<CommonParameters>]
Get-Item
[-Path] <string[]>
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Force]
[-Credential <pscredential>]
[-UseTransaction]
[<CommonParameters>]
Get-Item
-LiteralPath <string[]>
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Force]
[-Credential <pscredential>]
[-UseTransaction]
[<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*"
Paraméterek
-CodeSigningCert
Ez a tanúsítványszolgáltató által elérhetővé tett dinamikus paraméter.
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.
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.
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.
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.
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 |
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.
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.
Lekéri a megadott másodlagos NTFS-fájlstreamet 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 nem érvényes mappákban.
Ezt a paramétert a PowerShell 3.0-ban vezettük be.
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 |
-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.
Típus: | SwitchParameter |
Aliasok: | usetx |
Position: | Named |
Alapértelmezett érték: | False |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
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 Windows PowerShell a következő aliasokat Get-Item
tartalmazza:
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.