Get-ItemProperty
Lekéri egy adott elem tulajdonságait.
Syntax
Get-ItemProperty
[-Path] <String[]>
[[-Name] <String[]>]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
Get-ItemProperty
-LiteralPath <String[]>
[[-Name] <String[]>]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
Description
A Get-ItemProperty
parancsmag lekéri a megadott elemek tulajdonságait. Ezzel a parancsmaggal például lekérheti egy fájlobjektum LastAccessTime tulajdonságának értékét. Ezzel a parancsmaggal a beállításjegyzék bejegyzéseit és értékeit is megtekintheti.
Példák
1. példa: Információk lekérése egy adott könyvtárról
Ez a parancs információt kap a C:\Windows
címtárról.
Get-ItemProperty C:\Windows
2. példa: Adott fájl tulajdonságainak lekérése
Ez a parancs lekéri a C:\Test\Weather.xls
fájl tulajdonságait. Az eredmény a parancsmagra Format-List
van állítva, hogy listaként jelenítse meg a kimenetet.
Get-ItemProperty C:\Test\Weather.xls | Format-List
3. példa: Egy beállításjegyzék-bejegyzés értéknevének és adatainak lekérése egy beállításjegyzék-alkulcsban
Ez a parancs lekéri a beállításjegyzék-bejegyzés értéknevét ProgramFilesDir
és adatait a CurrentVersion
beállításkulcs alkulcsában. Az elérési út megadja az alkulcsot, a Név paraméter pedig a bejegyzés értéknevét.
Get-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion -Name "ProgramFilesDir"
Feljegyzés
Ehhez a parancshoz rendelkeznie kell egy PowerShell-meghajtóval HKLM:
, amely a HKEY_LOCAL_MACHINE
beállításjegyzék hive-jára van leképezve.
Az ilyen nevű és leképezésű meghajtó alapértelmezés szerint elérhető a PowerShellben. Másik lehetőségként a beállításkulcs elérési útja a következő alternatív elérési úttal adható meg, amely a szolgáltató nevével kezdődik, majd két kettősponttal:
Registry::HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion
.
4. példa: Beállításjegyzék-bejegyzések értéknevének és adatainak lekérése egy beállításkulcsban
Ez a parancs lekéri a beállításkulcs beállításjegyzék-bejegyzéseinek PowerShellEngine
értékneveit és adatait. Az eredmények az alábbi mintakimenetben jelennek meg.
Get-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\PowerShell\1\PowerShellEngine
ApplicationBase : C:\Windows\system32\WindowsPowerShell\v1.0\
ConsoleHostAssemblyName : Microsoft.PowerShell.ConsoleHost, Version=1.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, ProcessorArchitecture=msil
PowerShellVersion : 2.0
RuntimeVersion : v2.0.50727
CTPVersion : 5
PSCompatibleVersion : 1.0,2.0
Paraméterek
-Credential
Feljegyzés
Ezt a paramétert a Windows 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 |
-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 |
-Filter
Egy szűrőt ad meg, amely megfelel az Elérési út paraméternek. A Fájlrendszer-szolgáltató az egyetlen telepített PowerShell-szolgáltató, amely támogatja a szűrők használatát. A Fájlrendszer szűrőnyelvének szintaxisa about_Wildcards található. 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.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | True |
-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
Megadja a tulajdonság aktuális helyének elérési útját. 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 feloldó karaktereket, csatolja egy idézőjelbe ('
). 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 |
-Name
Megadja a lekérni kívánt tulajdonság vagy tulajdonságok nevét.
Típus: | String[] |
Aliasok: | PSProperty |
Position: | 1 |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Path
Megadja az elem vagy elemek elérési útját.
Típus: | String[] |
Position: | 0 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | 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.
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
Ez a parancsmag egy objektumot ad vissza minden egyes lekért elemtulajdonsághoz. Az objektum típusa a lekért objektumtól függ. Egy fájlrendszer-meghajtón például előfordulhat, hogy egy fájlt vagy mappát ad vissza.
Jegyzetek
A Windows PowerShell a következő aliasokat Get-ItemProperty
tartalmazza:
gp
A Get-ItemProperty
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.