Get-ItemProperty
Lekéri egy adott elem tulajdonságait.
Syntax
Path (Alapértelmezett)
Get-ItemProperty
[-Path] <String[]>
[[-Name] <String[]>]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
LiteralPath
Get-ItemProperty
[[-Name] <String[]>]
-LiteralPath <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" könyvtá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 Format-List parancsmagra van állítva, hogy listaként jelenítse meg a kimenetet.
Get-ItemProperty C:\Test\Weather.xls | Format-List
3. példa: Beállításjegyzék-bejegyzések értékének és adatainak megjelenítése egy beállításjegyzék-alkulcsban
Ez a parancs megjeleníti a "CurrentVersion" beállításkulcsban található összes beállításjegyzék-bejegyzés értéknevét és adatait.
Vegye figyelembe, hogy a parancshoz szükség van egy HKLM: nevű PowerShell-meghajtóra, amely a beállításjegyzék "HKEY_LOCAL_MACHINE" 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:
"Beállításjegyzék::HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion".
Get-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion
4. 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 "ProgramFilesDir" beállításjegyzék-bejegyzés értéknevét és adatait a "CurrentVersion" beállításkulcsban. A parancs a Path paramétert használja az alkulcs és a Név paraméter megadásához a bejegyzés értékének megadásához.
A parancs egy háttérjelet vagy súlyos ékezetet ('), a PowerShell folytatási karakterét használja a második sor parancsának folytatásához.
Get-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion -Name "ProgramFilesDir"
5. példa: A beállításjegyzék-bejegyzések értékneveinek és adatainak lekérése egy beállításkulcsban
Ez a parancs lekéri a beállításjegyzék bejegyzéseinek értékneveit és adatait a "PowerShellEngine" beállításkulcsban. 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
6. példa: A beállításjegyzék értékeinek és adatainak lekérése, formázása és megjelenítése
Ez a példa bemutatja, hogyan formázhatja egy Get-ItemProperty parancs kimenetét egy listában, hogy megkönnyítse a beállításjegyzék értékeinek és adatainak megtekintését, valamint az eredmények értelmezését.
Az első parancs a Get-ItemProperty parancsmaggal szerzi be a beállításjegyzék bejegyzéseit a Microsoft.PowerShell alkulcsában.
Ez az alkulcs a PowerShell alapértelmezett rendszerhéjának beállításait tárolja.
Az eredmények az alábbi mintakimenetben jelennek meg.
A kimenet azt mutatja, hogy két beállításjegyzék-bejegyzés van: "Path" és "ExecutionPolicy". Ha egy beállításkulcs ötnél kevesebb bejegyzést tartalmaz, alapértelmezés szerint megjelenik egy táblában, de gyakran könnyebben megtekinthető egy listában.
A második parancs ugyanazt a Get-ItemProperty parancsot használja.
Ezúttal azonban a parancs egy folyamatkezelő (|) használatával küldi el a parancs eredményeit a Format-List parancsmagnak.
A Format-List parancs a Tulajdonság paramétert használja "*" (mind) értékkel a listában lévő objektumok összes tulajdonságának megjelenítéséhez.
Az eredmények az alábbi mintakimenetben jelennek meg.
Az eredményül kapott megjelenítés megjeleníti az "Elérési út" és a "ExecutionPolicy" beállításjegyzék-bejegyzéseket, valamint a beállításkulcs-objektum számos kevésbé ismert tulajdonságát. A többi, PS előtaggal ellátott tulajdonság a PowerShell egyéni objektumainak tulajdonságai, például a beállításkulcsokat képviselő objektumok.
Get-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\PowerShell\1\ShellIds\Microsoft.PowerShell
Path ExecutionPolicy
---- ---------------
C:\Windows\system32\WindowsPowerShell\v1.0\powershell.exe RemoteSigned
Get-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\PowerShell\1\ShellIds\Microsoft.PowerShell | Format-List -Property *
PSPath : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\Software\Microsoft\PowerShell\1\ShellIds\Micro
soft.PowerShell
PSParentPath : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\Software\Microsoft\PowerShell\1\ShellIds
PSChildName : Microsoft.PowerShell
PSDrive : HKLM
PSProvider : Microsoft.PowerShell.Core\Registry
Path : C:\Windows\system32\WindowsPowerShell\v1.0\powershell.exe
ExecutionPolicy : RemoteSigned
Paraméterek
-Credential
A művelet végrehajtásához engedéllyel rendelkező felhasználói fiókot ad meg. Az alapértelmezett az aktuális felhasználó.
Írjon be egy felhasználónevet (például "User01" vagy "Domain01\User01"), vagy írjon be egy PSCredential objektumot, például a Get-Credential parancsmag által létrehozott objektumot.
Ha felhasználónevet ír be, a rendszer jelszót kér.
Figyelmeztetés
Ezt a paramétert a Windows PowerShell-lel telepített szolgáltatók nem támogatják.
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 |
-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.
Paramétertulajdonságok
| Típus: | String[] |
| 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
A szűrőt a szolgáltató formátumában vagy nyelvén adja meg. Ennek a paraméternek az értéke a Elérési út paramétert minősíti.
A szűrő szintaxisa, beleértve a helyettesítő karakterek használatát is, a szolgáltatótól függ. 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.
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 |
-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.
Paramétertulajdonságok
| Típus: | String[] |
| 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 |
-LiteralPath
Megadja a tulajdonság aktuális helyének elérési útját. A Path paramétertől eltérően a LiteralPath értéke pontosan a beíráskor lesz használva. 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.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | PSPath |
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 |
-Name
Megadja a lekérni kívánt tulajdonság vagy tulajdonságok nevét.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | PSProperty |
Paraméterkészletek
(All)
| Position: | 1 |
| 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 |
-Path
Megadja az elem vagy elemek elérési útját.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| 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 |
-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ó: Az aktív tranzakcióban lévő parancs bele van foglalva. Ez a paraméter csak akkor érvényes, ha egy tranzakció folyamatban van. További információ: about_Transactions.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | usetx |
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
A Get-ItemPropertyelérési útját tartalmazó sztringet csövezheti.
Kimenetek
System.Boolean, System.String, System.DateTime
Get-ItemProperty minden lekért elemtulajdonsághoz visszaad egy objektumot.
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 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.