Get-ItemProperty

Lekéri egy adott elem tulajdonságait.

Syntax

Get-ItemProperty
   [-Path] <String[]>
   [[-Name] <String[]>]
   [-Filter <String>]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-ItemProperty
   -LiteralPath <String[]>
   [[-Name] <String[]>]
   [-Filter <String>]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Credential <PSCredential>]
   [<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 címtá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 parancsmagra Format-List lesz átirányí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-alkulcsban lévő beállításjegyzék-bejegyzés értéknevének és adatainak lekérése

Ez a parancs lekéri a beállításjegyzék-alkulcsban lévő CurrentVersion beállításjegyzék-bejegyzés értéknevét és adataitProgramFilesDir. Az Elérési út megadja az alkulcsot, a Name paraméter pedig a bejegyzés értéknevét.

Get-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion -Name "ProgramFilesDir"

Megjegyzés

Ehhez a parancshoz szükség van egy nevű HKLM: PowerShell-meghajtóra, amely a HKEY_LOCAL_MACHINE beállításjegyzék hive-jára van leképezve.

Az ilyen nevű és leképezésű meghajtók alapértelmezés szerint elérhetők a PowerShellben. Másik lehetőségként megadhatja a beállításjegyzék alkulcsának elérési útját a következő alternatív elérési úttal, 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ékneveinek é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

Megjegyzés

Ezt a paramétert a PowerShell-lel telepített szolgáltatók nem támogatják. Ha egy másik felhasználót szeretne megszemélyesíteni, vagy a parancsmag futtatásakor megemelni a hitelesítő adatait, használja az Invoke-Command parancsot.

Type:PSCredential
Position:Named
Default value:Current user
Accept pipeline input:True
Accept wildcard characters:False

-Exclude

Sztringtömbként olyan elemet vagy elemeket határoz meg, amelyeket a parancsmag kizár a műveletből. Ennek a paraméternek az értéke a Path paramétert minősíti. Adjon meg egy elérésiút-elemet vagy mintát, például *.txt: . Helyettesítő karakterek használata engedélyezett. Az Exclude paraméter csak akkor érvényes, ha a parancs egy elem tartalmát tartalmazza( például C:\Windows\*), ahol a helyettesítő karakter a könyvtár tartalmát C:\Windows határozza meg.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

-Filter

Egy szűrőt ad meg a Path paraméter minősítéséhez. 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 szintaxisát a about_Wildcards találja. 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 ahelyett, hogy a PowerShell a lekérésük után szűri az objektumokat.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

-Include

Sztringtömbként megad egy elemet vagy elemet, amelyet ez a parancsmag tartalmaz a műveletben. Ennek a paraméternek az értéke a Path paramétert minősíti. Adjon meg egy elérésiút-elemet vagy mintát, például *.txt: . 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\*), ahol a helyettesítő karakter a könyvtár tartalmát C:\Windows határozza meg.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

-LiteralPath

Egy vagy több hely elérési útját adja meg. 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 út tartalmaz feloldókaraktereket, tegye idézőjelek közé. Az egyszeres idézőjelek azt jelzik, hogy a PowerShell nem értelmez feloldósorozatként egyetlen karaktert sem.

További információ: about_Quoting_Rules.

Type:String[]
Aliases:PSPath, LP
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Name

Megadja a lekérni kívánt tulajdonság vagy tulajdonságok nevét. Helyettesítő karakterek használata engedélyezett.

Type:String[]
Aliases:PSProperty
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

-Path

Megadja az elem vagy elemek elérési útját. Helyettesítő karakterek használata engedélyezett.

Type:String[]
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:True

Bevitelek

String

Olyan sztringet is futtathat, amely a elérési Get-ItemPropertyútját tartalmazza.

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. Például egy fájlrendszer-meghajtón egy fájlt vagy mappát adhat vissza.

Jegyzetek

A PowerShell a következő aliasokat tartalmazza:Get-ItemProperty

  • Összes platform:
    • gp

A Get-ItemProperty parancsmag úgy lett kialakítva, hogy bármely szolgáltató által közzétett adatokkal működjön. A munkamenetben elérhető szolgáltatók listázásához írja be a következőt Get-PSProvider: . További információ: about_Providers.