Delen via

Get-ItemPropertyValue

  • Referentie
Module:
Microsoft.PowerShell.Management

Hiermee haalt u de waarde op voor een of meer eigenschappen van een opgegeven item.

Syntaxis

Get-ItemPropertyValue
   [[-Path] <String[]>]
   [-Name] <String[]>
   [-Filter <String>]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Credential <PSCredential>]
   [-UseTransaction]
   [<CommonParameters>]
Get-ItemPropertyValue
   -LiteralPath <String[]>
   [-Name] <String[]>
   [-Filter <String>]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Credential <PSCredential>]
   [-UseTransaction]
   [<CommonParameters>]

Description

De Get-ItemPropertyValue haalt de huidige waarde op voor een eigenschap die u opgeeft wanneer u de parameter Name gebruikt, die zich bevindt in een pad dat u opgeeft met de parameters Pad of LiteralPath.

Voorbeelden

Voorbeeld 1: De waarde van de eigenschap Product-id ophalen

Met deze opdracht wordt de waarde opgehaald van de eigenschap ProductID van het object \SOFTWARE\Microsoft\Windows NT\CurrentVersion in de Windows-registerprovider.

Get-ItemPropertyValue HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion -Name ProductID

94253-50000-11141-AA785

Voorbeeld 2: De laatste schrijftijd van een bestand of map ophalen

Met deze opdracht wordt de waarde opgehaald van de eigenschap LastWriteTime, of de laatste keer dat een bestand of map is gewijzigd, vanuit de map C:\Users\Test\Documents\ModuleToAssembly, die werkt in de bestandssysteemprovider.

Get-ItemPropertyValue -Path C:\Users\Test\Documents\ModuleToAssembly -Name LastWriteTime

Wednesday, September 3, 2014 2:53:22 PM

Voorbeeld 3: Meerdere eigenschapswaarden van een bestand of map ophalen

Met deze opdracht worden de waarden opgehaald van de LastWriteTime, CreationTimeen eigenschappen van de hoofdmap van een map. De eigenschapswaarden worden geretourneerd in de volgorde waarin u de eigenschapsnamen hebt opgegeven.

Get-ItemPropertyValue -Path C:\Users\Test\Documents\ModuleToAssembly -Name LastWriteTime,CreationTime,Root

Wednesday, September 3, 2014 2:53:22 PM
Wednesday, September 3, 2014 2:53:10 PM

Name              : C:\
Parent            :
Exists            : True
Root              : C:\
FullName          : C:\
Extension         :
CreationTime      : 9/1/2014 4:59:45 AM
CreationTimeUtc   : 9/1/2014 11:59:45 AM
LastAccessTime    : 9/27/2014 5:22:02 PM
LastAccessTimeUtc : 9/28/2014 12:22:02 AM
LastWriteTime     : 9/27/2014 5:22:02 PM
LastWriteTimeUtc  : 9/28/2014 12:22:02 AM
Attributes        : Hidden, System, Directory
BaseName          : C:\
Target            :
LinkType          :
Mode              : d--hs-

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:None
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:True

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

-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:True
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:False
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_Transactions voor 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 deze cmdlet doorsluisen.

Uitvoerwaarden

System.Boolean, System.String, System.DateTime

Deze cmdlet retourneert een object voor elke itemeigenschapswaarde die wordt opgehaald. Het objecttype is afhankelijk van de eigenschapswaarde die wordt opgehaald. In een bestandssysteemstation kan de cmdlet bijvoorbeeld een bestand of map retourneren.

Notities

Deze cmdlet is ontworpen om te werken met de gegevens die door elke provider worden weergegeven. Voer de Get-PSProvider cmdlet uit om de providers weer te geven die beschikbaar zijn in uw sessie. Zie about_Providers voor meer informatie.