Share via

Get-ItemPropertyValue

  • Referenz
Modul:
Microsoft.PowerShell.Management

Ruft den Wert für eine oder mehrere Eigenschaften eines angegebenen Elements ab.

Syntax

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

Beschreibung

Der Get-ItemPropertyValue aktuelle Wert für eine Eigenschaft, die Sie angeben, wenn Sie den Parameter Name verwenden, befindet sich in einem Pfad, den Sie mit den Parametern Path oder LiteralPath angeben.

Beispiele

Beispiel 1: Abrufen des Werts der ProductID-Eigenschaft

Dieser Befehl ruft den Wert der ProductID-Eigenschaft des \SOFTWARE\Microsoft\WindowsNT\CurrentVersion Objekts im Windows-Registrierungsanbieter ab.

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

94253-50000-11141-AA785

Beispiel 2: Abrufen der letzten Schreibzeit einer Datei oder eines Ordners

Dieser Befehl ruft den Wert der LastWriteTime-Eigenschaft oder das letzte Mal, wenn eine Datei oder ein Ordner geändert wurde, aus dem C:\Program Files\WindowsPowerShell Ordner ab, der im FileSystem-Anbieter funktioniert.

Get-ItemPropertyValue -Path 'C:\Program Files\WindowsPowerShell' -Name LastWriteTime

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

Beispiel 3: Abrufen mehrerer Eigenschaftswerte einer Datei oder eines Ordners

Dieser Befehl ruft die Werte der Eigenschaften LastWriteTime, CreationTime und Root eines Ordners ab. Die Eigenschaftswerte werden in der Reihenfolge zurückgegeben, in der Sie die Eigenschaftsnamen angegeben haben.

Get-ItemPropertyValue -Path 'C:\Program Files\WindowsPowerShell' -Name LastWriteTime,CreationTime,Root

Tuesday, March 23, 2021 6:53:13 AM
Monday, August 14, 2017 1:42:40 PM

Name              : C:\
FullName          : C:\
Parent            :
Exists            : True
Root              : C:\
Extension         :
CreationTime      : 10/30/2015 1:28:30 AM
CreationTimeUtc   : 10/30/2015 6:28:30 AM
LastAccessTime    : 5/26/2021 9:24:31 AM
LastAccessTimeUtc : 5/26/2021 2:24:31 PM
LastWriteTime     : 5/25/2021 7:25:08 AM
LastWriteTimeUtc  : 5/25/2021 12:25:08 PM
Attributes        : Hidden, System, Directory
Mode              : d--hs-
BaseName          : C:\
Target            : {}
LinkType          :

Parameter

-Credential

Gibt ein Benutzerkonto an, das über die Berechtigung zum Ausführen dieser Aktion verfügt. Der Standardwert ist der aktuelle Benutzer.

Geben Sie einen Benutzernamen ein, z. B. "User01" oder "Do Standard 01\User01", oder geben Sie ein PSCredential-Objekt ein, z. B. ein vom Get-Credential Cmdlet generiertes Objekt. Wenn Sie einen Benutzernamen eingeben, werden Sie zur Eingabe eines Kennworts aufgefordert.

Warnung

Dieser Parameter wird nicht von mit Windows PowerShell installierten Anbietern unterstützt.

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

-Exclude

Gibt als Zeichenfolgenarray ein Element oder Elemente an, das dieses Cmdlet vom Vorgang ausschließt. Der Wert dieses Parameters qualifiziert den Path-Parameter . Geben Sie ein Pfadelement oder ein Muster wie %%amp;quot;*.txt%%amp;quot; ein. Platzhalterzeichen sind zulässig.

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

-Filter

Gibt einen Filter im Format oder in der Sprache des Anbieters an. Der Wert dieses Parameters qualifiziert den Path-Parameter .

Die Syntax des Filters, einschließlich der Verwendung von Wild Karte Zeichen, hängt vom Anbieter ab. Filter sind effizienter als andere Parameter, da der Anbieter sie anwendet, wenn das Cmdlet die Objekte abruft, anstatt powerShell nach dem Abrufen der Objekte zu filtern.

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

-Include

Gibt als Zeichenfolgenarray ein Element oder elemente an, das dieses Cmdlet in den Vorgang einschließt. Der Wert dieses Parameters qualifiziert den Path-Parameter . Geben Sie ein Pfadelement oder ein Muster wie %%amp;quot;*.txt%%amp;quot; ein. Platzhalterzeichen sind zulässig.

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

-LiteralPath

Gibt den Pfad zum aktuellen Speicherort der Eigenschaft an. Im Gegensatz zum Path-Parameter wird der Wert von LiteralPath genau so verwendet, wie er eingegeben wird. Es werden keine Zeichen als Platzhalter interpretiert. Wenn der Pfad Escapezeichen enthält, müssen Sie ihn in einfache Anführungszeichen einschließen. Einfache Anführungszeichen weisen PowerShell an, keine Zeichen als Escapesequenzen zu interpretieren.

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

-Name

Gibt den Namen der abzurufenden Eigenschaft oder Eigenschaften an.

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

-Path

Gibt den Pfad zu den Elementen an.

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

-UseTransaction

Schließt den Befehl in die aktive Transaktion ein. Dieser Parameter ist nur gültig, wenn gerade eine Transaktion ausgeführt wird. Weitere Informationen finden Sie unter about_Transactions.

Type:SwitchParameter
Aliases:usetx
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

String

Sie können eine Zeichenfolge weiterleiten, die einen Pfad zu diesem Cmdlet enthält.

Ausgaben

PSObject

Dieses Cmdlet gibt ein Objekt für jeden Elementeigenschaftswert zurück, den es abruft. Der Objekttyp hängt vom abgerufenen Eigenschaftswert ab.

Hinweise

Windows PowerShell enthält die folgenden Aliase für Get-ItemPropertyValue:

  • gpv

Dieses Cmdlet wurde entwickelt, um mit den Daten zu arbeiten, die von einem beliebigen Anbieter verfügbar gemacht werden. Führen Sie das Get-PSProvider Cmdlet aus, um die in Ihrer Sitzung verfügbaren Anbieter aufzulisten. Weitere Informationen finden Sie unter about_Providers.