Delen via

Get-ItemProperty

  • Referentie
Module:
Microsoft.PowerShell.Management

Hiermee haalt u de eigenschappen van een opgegeven item op.

Syntaxis

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

De cmdlet Get-ItemProperty haalt de eigenschappen van de opgegeven items op. U kunt deze cmdlet bijvoorbeeld gebruiken om de waarde op te halen van de eigenschap LastAccessTime van een bestandsobject. U kunt deze cmdlet ook gebruiken om registervermeldingen en hun waarden weer te geven.

Voorbeelden

Voorbeeld 1: Informatie over een specifieke map ophalen

Met deze opdracht wordt informatie opgehaald over de map C:\Windows.

Get-ItemProperty C:\Windows

Voorbeeld 2: De eigenschappen van een specifiek bestand ophalen

Met deze opdracht worden de eigenschappen van het bestand 'C:\Test\Weather.xls' opgehaald. Het resultaat wordt doorgesluisd naar de Format-List cmdlet om de uitvoer weer te geven als een lijst.

Get-ItemProperty C:\Test\Weather.xls | Format-List

Voorbeeld 3: De waardenaam en gegevens van registervermeldingen weergeven in een registersubsleutel

Met deze opdracht worden de waardenaam en gegevens weergegeven van elk van de registervermeldingen in de registersubsleutel CurrentVersion. Houd er rekening mee dat de opdracht vereist dat er een PowerShell-station met de naam HKLM: is toegewezen aan de hive 'HKEY_LOCAL_MACHINE' van het register. Een station met die naam en toewijzing is standaard beschikbaar in PowerShell. U kunt ook het pad naar deze registersubsleutel opgeven met behulp van het volgende alternatieve pad dat begint met de providernaam, gevolgd door twee dubbele punten:

"Register::HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion".

Get-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion

Voorbeeld 4: De waardenaam en gegevens ophalen van een registervermelding in een registersubsleutel

Met deze opdracht worden de waardenaam en gegevens opgehaald van de registervermelding ProgramFilesDir in de registersubsleutel CurrentVersion. De opdracht gebruikt de parameter Path om de subsleutel en de parameter Name op te geven om de waardenaam van de vermelding op te geven.

De opdracht maakt gebruik van een terugtik- of graveaccent ('), het PowerShell-vervolgteken, om de opdracht op de tweede regel voort te zetten.

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

Voorbeeld 5: De waardenamen en gegevens van registervermeldingen in een registersleutel ophalen

Met deze opdracht worden de waardenamen en gegevens opgehaald van de registervermeldingen in de registersleutel PowerShellEngine. De resultaten worden weergegeven in de volgende voorbeelduitvoer.

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

Voorbeeld 6: De resultaten van registerwaarden en -gegevens ophalen, opmaken en weergeven

In dit voorbeeld ziet u hoe u de uitvoer van een Get-ItemProperty-opdracht in een lijst opmaken, zodat u de registerwaarden en -gegevens gemakkelijk kunt bekijken en de resultaten gemakkelijk kunt interpreteren.

De eerste opdracht maakt gebruik van de Get-ItemProperty cmdlet om de registervermeldingen op te halen in de Microsoft.PowerShell subsleutel. Met deze subsleutel worden opties voor de standaardshell voor PowerShell opgeslagen. De resultaten worden weergegeven in de volgende voorbeelduitvoer.

In de uitvoer ziet u dat er twee registervermeldingen zijn: Path en ExecutionPolicy. Wanneer een registersleutel minder dan vijf vermeldingen bevat, wordt deze standaard weergegeven in een tabel, maar is het vaak gemakkelijker om in een lijst weer te geven.

De tweede opdracht maakt gebruik van dezelfde Get-ItemProperty opdracht. Deze keer gebruikt de opdracht echter een pijplijnoperator (|) om de resultaten van de opdracht naar de Format-List cmdlet te verzenden. De opdracht Format-List gebruikt de parameter Eigenschap met de waarde *(alle) om alle eigenschappen van de objecten in een lijst weer te geven. De resultaten worden weergegeven in de volgende voorbeelduitvoer.

De resulterende weergave toont de registervermeldingen Path en ExecutionPolicy, samen met enkele minder bekende eigenschappen van het registersleutelobject. De andere eigenschappen, voorafgegaan door PS, zijn eigenschappen van aangepaste PowerShell-objecten, zoals de objecten die de registersleutels vertegenwoordigen.

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

Parameters

-Credential

Hiermee geeft u een gebruikersaccount op dat gemachtigd is om deze actie uit te voeren. De standaardwaarde is de huidige gebruiker.

Typ een gebruikersnaam, zoals 'User01' of 'Domain01\User01', of voer een PSCredential--object in, zoals een object dat is gegenereerd door de Get-Credential-cmdlet. Als u een gebruikersnaam typt, wordt u om een wachtwoord gevraagd.

Waarschuwing

Deze parameter wordt niet ondersteund door providers die zijn geïnstalleerd met Windows PowerShell.

Type:PSCredential
Position:Named
Default value:Current user
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Exclude

Hiermee geeft u, als een tekenreeksmatrix, een item of items op die door deze cmdlet worden uitgesloten van de bewerking. De waarde van deze parameter komt in aanmerking voor de parameter Path. Voer een padelement of -patroon in, zoals '*.txt'. Jokertekens zijn toegestaan.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Filter

Hiermee geeft u een filter in de indeling of taal van de provider. De waarde van deze parameter komt in aanmerking voor de parameter Path.

De syntaxis van het filter, inclusief het gebruik van jokertekens, is afhankelijk van de provider. Filters zijn efficiënter dan andere parameters, omdat de provider deze toepast wanneer de cmdlet de objecten ophaalt in plaats van PowerShell de objecten te filteren nadat ze zijn opgehaald.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:True

-Include

Hiermee geeft u, als tekenreeksmatrix, een item of items op die deze cmdlet in de bewerking bevat. De waarde van deze parameter komt in aanmerking voor de parameter Path. Voer een padelement of -patroon in, zoals '*.txt'. Jokertekens zijn toegestaan.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-LiteralPath

Hiermee geeft u het pad naar de huidige locatie van de eigenschap. In tegenstelling tot de parameter Path, wordt de waarde van LiteralPath- exact gebruikt zoals deze is getypt. Er worden geen tekens geïnterpreteerd als jokertekens. Als het pad escapetekens bevat, plaatst u het tussen enkele aanhalingstekens. Enkele aanhalingstekens geven PowerShell aan dat er geen tekens als escapereeksen moeten worden geïnterpreteerd.

Type:String[]
Aliassen:PSPath
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Name

Hiermee geeft u de naam van de eigenschap of eigenschappen die moeten worden opgehaald.

Type:String[]
Aliassen:PSProperty
Position:1
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Path

Hiermee geeft u het pad naar het item of de items.

Type:String[]
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-UseTransaction

Bevat de opdracht in de actieve transactie. Deze parameter is alleen geldig wanneer een transactie wordt uitgevoerd. Zie Inclusief de opdracht in de actieve transactie voor meer informatie. Deze parameter is alleen geldig wanneer een transactie wordt uitgevoerd. Zie about_Transactionsvoor meer informatie.

Type:SwitchParameter
Aliassen:usetx
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

String

U kunt een tekenreeks met een pad naar Get-ItemPropertydoorspezen.

Uitvoerwaarden

System.Boolean, System.String, System.DateTime

Get-ItemProperty retourneert een object voor elke itemeigenschap die wordt opgehaald. Het objecttype is afhankelijk van het object dat wordt opgehaald. In een bestandssysteemstation kan bijvoorbeeld een bestand of map worden geretourneerd.

Notities

De cmdlet Get-ItemProperty is ontworpen om te werken met de gegevens die door elke provider worden weergegeven. Als u de providers wilt weergeven die beschikbaar zijn in uw sessie, typt u 'Get-PSProvider'. Zie about_Providers voor meer informatie.