Get-ItemProperty
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:\WindowsVoorbeeld 2: De eigenschappen van een specifiek bestand ophalen
Met deze opdracht worden de eigenschappen van het C:\Test\Weather.xls-bestand opgeslagen. 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-ListVoorbeeld 3: De waardenaam en gegevens ophalen van een registervermelding in een registersubsleutel
Met deze opdracht worden de waardenaam en gegevens opgehaald van de ProgramFilesDir registervermelding in de CurrentVersion registersubsleutel. De Pad geeft de subsleutel op en de parameter naam geeft de waardenaam van de vermelding op.
Get-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion -Name "ProgramFilesDir"Notitie
Voor deze opdracht is vereist dat er een PowerShell-station met de naam HKLM: is toegewezen aan de HKEY_LOCAL_MACHINE hive 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:
Registry::HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion.
Voorbeeld 4: De waardenamen en gegevens van registervermeldingen ophalen in een registersleutel
Met deze opdracht worden de waardenamen en gegevens opgehaald van de registervermeldingen in de PowerShellEngine registersleutel. 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.0Parameters
-Credential
Notitie
Deze parameter wordt niet ondersteund door providers die zijn geïnstalleerd met Windows PowerShell. Als u een andere gebruiker wilt imiteren of uw referenties wilt verhogen bij het uitvoeren van deze cmdlet, gebruikt u Invoke-Command-.
| 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 in 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. De parameter Uitsluiten is alleen van kracht wanneer de opdracht de inhoud van een item bevat, zoals C:\Windows\*, waarbij het jokerteken de inhoud van de C:\Windows map aangeeft.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | True |
-Filter
Hiermee geeft u een filter op om de parameter Path te kwalificeren. De FileSystem-provider is de enige geïnstalleerde PowerShell-provider die het gebruik van filters ondersteunt. U vindt de syntaxis voor de Bestandssysteem filtertaal in about_Wildcards. 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. De parameter Opnemen is alleen van kracht wanneer de opdracht de inhoud van een item bevat, zoals C:\Windows\*, waarbij het jokerteken de inhoud van de C:\Windows map aangeeft.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | True |
-LiteralPath
Hiermee geeft u het pad naar de huidige locatie van de eigenschap. De waarde van LiteralPath- wordt 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.
Zie about_Quoting_Rulesvoor meer informatie.
| 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 about_Transactionsvoor meer informatie.
| Type: | SwitchParameter |
| Aliassen: | usetx |
| Position: | Named |
| Default value: | False |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
Invoerwaarden
U kunt een tekenreeks met een pad naar deze cmdlet doorsluisen.
Uitvoerwaarden
Met deze cmdlet wordt een object geretourneerd 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
Windows PowerShell bevat de volgende aliassen voor Get-ItemProperty:
gp
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_Providersvoor meer informatie.
