Get-ItemProperty

  • Referencia
Modul:
Microsoft.PowerShell.Management

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 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 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

-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

-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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-Name

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

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

-Path

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

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

Bevitelek

String

A parancsmag elérési útját tartalmazó sztringet csövezheti.

Kimenetek

Boolean

String

DateTime

FileInfo

DirectoryInfo

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 PowerShell a következő aliasokat Get-ItemPropertytartalmazza:

  • Minden platform:
    • 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.