Get-ItemProperty
Ruft die Eigenschaften eines angegebenen Elements ab.
Syntax
Path (Standard)
Get-ItemProperty
[-Path] <String[]>
[[-Name] <String[]>]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
LiteralPath
Get-ItemProperty
[[-Name] <String[]>]
-LiteralPath <String[]>
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
Beschreibung
Das Cmdlet Get-ItemProperty ruft die Eigenschaften der angegebenen Elemente ab.
Sie können dieses Cmdlet z. B. verwenden, um den Wert der LastAccessTime-Eigenschaft eines Dateiobjekts abzurufen.
Sie können dieses Cmdlet auch verwenden, um Registrierungseinträge und deren Werte anzuzeigen.
Beispiele
Beispiel 1: Abrufen von Informationen zu einem bestimmten Verzeichnis
Mit diesem Befehl werden Informationen über das Verzeichnis "C:\Windows" abgerufen.
Get-ItemProperty C:\Windows
Beispiel 2: Abrufen der Eigenschaften einer bestimmten Datei
Mit diesem Befehl werden die Eigenschaften der Datei "C:\Test\Weather.xls" abgerufen.
Das Ergebnis wird an das cmdlet Format-List weitergeleitet, um die Ausgabe als Liste anzuzeigen.
Get-ItemProperty C:\Test\Weather.xls | Format-List
Beispiel 3: Anzeigen des Wertnamens und der Daten von Registrierungseinträgen in einem Registrierungsunterschlüssel
Dieser Befehl zeigt den Wert, den Namen und die Daten jedes Registrierungseintrags an, der im Registrierungsunterschlüssel "CurrentVersion" enthalten ist.
Beachten Sie, dass für den Befehl ein PowerShell-Laufwerk mit dem Namen HKLM: vorhanden ist, das der Struktur "HKEY_LOCAL_MACHINE" der Registrierung zugeordnet ist.
Ein Laufwerk mit diesem Namen und dieser Zuordnung ist standardmäßig in PowerShell verfügbar.
Alternativ kann der Pfad zu diesem Registrierungsunterschlüssel mithilfe des folgenden alternativen Pfads angegeben werden, der mit dem Anbieternamen beginnt, gefolgt von zwei Doppelpunkten:
"Registrierung::HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion".
Get-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion
Beispiel 4: Abrufen des Wertnamens und der Daten eines Registrierungseintrags in einem Registrierungsunterschlüssel
Mit diesem Befehl werden der Wert, der Name und die Daten des Registrierungseintrags "ProgramFilesDir" im Registrierungsunterschlüssel "CurrentVersion" abgerufen. Der Befehl verwendet den Parameter Pfad, um den Unterschlüssel anzugeben, und den Parameter Name, um den Wertnamen des Eintrags anzugeben.
Der Befehl verwendet ein Backtick oder einen Grave-Akzent ('), das PowerShell-Fortsetzungszeichen, um den Befehl in der zweiten Zeile fortzusetzen.
Get-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion -Name "ProgramFilesDir"
Beispiel 5: Abrufen der Wertnamen und Daten von Registrierungseinträgen in einem Registrierungsschlüssel
Mit diesem Befehl werden die Wertnamen und Daten der Registrierungseinträge im Registrierungsschlüssel "PowerShellEngine" abgerufen. Die Ergebnisse werden in der folgenden Beispielausgabe angezeigt.
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
Beispiel 6: Abrufen, Formatieren und Anzeigen der Ergebnisse von Registrierungswerten und -daten
In diesem Beispiel wird gezeigt, wie die Ausgabe eines Get-ItemProperty Befehls in einer Liste formatiert wird, um die Anzeige der Registrierungswerte und -daten und die Interpretation der Ergebnisse zu erleichtern.
Der erste Befehl verwendet das Get-ItemProperty Cmdlet, um die Registrierungseinträge im Unterschlüssel Microsoft.PowerShell abzurufen.
In diesem Unterschlüssel werden Optionen für die Standardshell für PowerShell gespeichert.
Die Ergebnisse werden in der folgenden Beispielausgabe angezeigt.
Die Ausgabe zeigt, dass zwei Registrierungseinträge vorhanden sind: "Path" und "ExecutionPolicy". Wenn ein Registrierungsschlüssel weniger als fünf Einträge enthält, wird er standardmäßig in einer Tabelle angezeigt, aber es ist oft einfacher, ihn in einer Liste anzuzeigen.
Der zweite Befehl verwendet denselben Get-ItemProperty Befehl.
Dieses Mal verwendet der Befehl jedoch einen Pipelineoperator (|), um die Ergebnisse des Befehls an das Format-List Cmdlet zu senden.
Der Format-List Befehl verwendet den Parameter Property mit dem Wert '*' (all), um alle Eigenschaften der Objekte in einer Liste anzuzeigen.
Die Ergebnisse werden in der folgenden Beispielausgabe angezeigt.
Die resultierende Anzeige zeigt die Registrierungseinträge "Path" und "ExecutionPolicy" zusammen mit einigen weniger bekannten Eigenschaften des Registrierungsschlüsselobjekts an. Bei den anderen Eigenschaften, denen PS vorangestellt ist, handelt es sich um Eigenschaften von benutzerdefinierten PowerShell-Objekten, z. B. die Objekte, die die Registrierungsschlüssel darstellen.
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
Parameter
-Credential
Gibt ein Benutzerkonto an, das über die Berechtigung zum Ausführen dieser Aktion verfügt. Die Standardeinstellung ist der aktuelle Benutzer.
Geben Sie einen Benutzernamen ein, z. B. "User01" oder "Domain01\User01", oder geben Sie ein PSCredential--Objekt ein, z. B. ein objekt, das vom Cmdlet Get-Credential generiert wurde.
Wenn Sie einen Benutzernamen eingeben, werden Sie zur Eingabe eines Kennworts aufgefordert.
Warnung
Dieser Parameter wird von anbietern, die mit Windows PowerShell installiert sind, nicht unterstützt.
Parametereigenschaften
| Typ: | PSCredential |
| Standardwert: | Current user |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-Exclude
Gibt als Zeichenfolgenarray ein Element oder Elemente an, das dieses Cmdlet vom Vorgang ausschließt. Der Wert dieses Parameters qualifiziert den parameter Path. Geben Sie ein Pfadelement oder Einmuster ein, z. B. "*.txt". Platzhalterzeichen sind zulässig.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Filter
Gibt einen Filter im Format oder in der Sprache des Anbieters an. Der Wert dieses Parameters qualifiziert den parameter Path.
Die Syntax des Filters, einschließlich der Verwendung von Wildcardzeichen, hängt vom Anbieter ab. Filter sind effizienter als andere Parameter, da der Anbieter sie anwendet, wenn das Cmdlet die Objekte abruft, anstatt dass PowerShell die Objekte nach dem Abrufen filtert.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | True |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Include
Gibt als Zeichenfolgenarray ein oder mehrere Elemente an, die dieses Cmdlet in den Vorgang einbezieht. Der Wert dieses Parameters qualifiziert den parameter Path. Geben Sie ein Pfadelement oder Einmuster ein, z. B. "*.txt". Platzhalterzeichen sind zulässig.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-LiteralPath
Gibt den Pfad zum aktuellen Speicherort der Eigenschaft an. Im Gegensatz zum Path-Parameter wird der Wert LiteralPath- genau so verwendet, wie er eingegeben wird. Es werden keine Zeichen als Wildcards interpretiert. Wenn der Pfad Escapezeichen enthält, müssen Sie ihn in einfache Anführungszeichen einschließen. Einfache Anführungszeichen signalisieren PowerShell, dass keine Zeichen als Escapesequenzen interpretiert werden sollen.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | PSPath |
Parametersätze
LiteralPath
| Position: | Named |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-Name
Gibt den Namen der abzurufenden Eigenschaft oder Eigenschaften an.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | PSProperty |
Parametersätze
(All)
| Position: | 1 |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Path
Gibt den Pfad zu dem Element oder den Elementen an.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
Path
| Position: | 0 |
| Obligatorisch: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-UseTransaction
Enthält den Befehl in der aktiven Transaktion. Dieser Parameter ist nur gültig, wenn eine Transaktion ausgeführt wird. Weitere Informationen finden Sie unter Schließt den Befehl in die aktive Transaktion ein. Dieser Parameter ist nur gültig, wenn eine Transaktion ausgeführt wird. Weitere Informationen finden Sie unter about_Transactions.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | usetx |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
Eingaben
String
Sie können eine Zeichenfolge senden, die einen Pfad zu Get-ItemPropertyenthält.
Ausgaben
System.Boolean, System.String, System.DateTime
Get-ItemProperty Gibt für jede Item-Eigenschaft, die abgerufen wird, ein Objekt zurück.
Der Objekttyp hängt vom abgerufenen Objekt ab.
In einem Dateisystemlaufwerk kann z. B. eine Datei oder ein Ordner zurückgegeben werden.
Hinweise
Das Cmdlet Get-ItemProperty ist für die Arbeit mit den Daten konzipiert, die von einem beliebigen Anbieter verfügbar gemacht werden. Um die in Ihrer Sitzung verfügbaren Anbieter aufzulisten, geben Sie ""Get-PSProvider ein. Weitere Informationen finden Sie unter about_Providers.