Ruft die Eigenschaften eines angegebenen Elements ab.
Syntax
Get-ItemProperty [-LiteralPath] <string[]> [[-Name] <string[]>] [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Include <string[]>] [-UseTransaction] [<CommonParameters>] Get-ItemProperty [-Path] <string[]> [[-Name] <string[]>] [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Include <string[]>] [-UseTransaction] [<CommonParameters>]
Beschreibung
Das Cmdlet "Get-ItemProperty" ruft die Eigenschaften der angegebenen Elemente ab. Mit Get-ItemProperty können Sie z. B. den Wert der LastAccessTime-Eigenschaft eines Dateiobjekts abrufen. Mit Get-ItemProperty können Sie auch Registrierungseinträge und ihre Werte anzeigen.
Parameter
-Credential <PSCredential>
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 "Domain01\User01", oder geben Sie ein PSCredential-Objekt ein, z. B. ein vom Cmdlet "Get-Credential" generiertes Objekt. Wenn Sie einen Benutzernamen eingeben, werden Sie zur Eingabe eines Kennworts aufgefordert.
Dieser Parameter wird nicht von mit Windows PowerShell installierten Anbietern unterstützt.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
true (ByPropertyName) |
|
Platzhalterzeichen akzeptieren? |
false |
-Exclude <string[]>
Lässt die angegebenen Elemente aus. Platzhalter sind zulässig.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Filter <string>
Gibt einen Filter im Format oder in der Sprache des Anbieters an. Der Path-Parameter wird durch den Wert dieses Parameters qualifiziert. Die Syntax des Filters einschließlich der Verwendung von Platzhaltern ist vom Anbieter abhängig. Filter sind effizienter als andere Parameter, da sie beim Abrufen der Objekte vom Anbieter angewendet werden und die Objekte nicht erst nach dem Abrufen von Windows PowerShell gefiltert werden.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Include <string[]>
Schließt die angegebenen Elemente ein.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-LiteralPath <string[]>
Gibt den Pfad zur Elementeigenschaft an. Der Wert von "LiteralPath" wird genau so verwendet, wie er eingegeben wurde. 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 veranlassen Windows PowerShell, Zeichen nicht als Escapesequenzen zu interpretieren.
|
Erforderlich? |
true |
|
Position? |
1 |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
true (ByPropertyName) |
|
Platzhalterzeichen akzeptieren? |
false |
-Name <string[]>
Gibt den Namen der abzurufenden Eigenschaft oder Eigenschaften an.
|
Erforderlich? |
false |
|
Position? |
2 |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Path <string[]>
Gibt den Pfad zu dem Element oder den Elementen an.
|
Erforderlich? |
true |
|
Position? |
1 |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
true (ByValue, ByPropertyName) |
|
Platzhalterzeichen akzeptieren? |
false |
-UseTransaction
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".
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
<CommonParameters>
Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.
Eingaben und Ausgaben
Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.
|
Eingaben |
System.String Sie können eine Zeichenfolge mit einem Pfad über die Pipeline an Get-ItemProperty übergeben. |
|
Ausgaben |
Object Get-ItemProperty gibt ein Objekt für jede Elementeigenschaft zurück, die das Cmdlet abruft. Der Objekttyp richtet sich nach dem abgerufenen Objekt. |
Hinweise
Das Cmdlet "Get-ItemProperty" ist für die Verwendung mit Daten konzipiert, die von beliebigen Anbietern verfügbar gemacht werden. Um die in der Sitzung verfügbaren Anbieter aufzuführen, geben Sie "Get-PSProvider" ein. Weitere Informationen finden Sie unter "about_Providers".
Beispiel 1
C:\PS>get-itemproperty C:\Windows Beschreibung ----------- Mit diesem Befehl werden Informationen über das Verzeichnis "C:\Windows" abgerufen.
Beispiel 2
C:\PS>get-itemproperty C:\Test\Weather.xls | format-list Beschreibung ----------- Mit diesem Befehl werden die Eigenschaften der Datei "C:\Test\Weather.xls" abgerufen. Das Ergebnis wird über die Pipeline an das Cmdlet "Format-List" übergeben, um die Ausgabe als Liste anzuzeigen.
Beispiel 3
C:\PS>get-itemproperty -path HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion Beschreibung ----------- Mit diesem Befehl werden der Name des Werts und die Daten der einzelnen Registrierungseinträge im Registrierungsunterschlüssel "CurrentVersion" angezeigt. Beachten Sie, dass für den Befehl ein Windows PowerShell-Laufwerk mit dem Namen "HKLM:" vorhanden sein muss, das der Registrierungsstruktur "HKEY_LOCAL_MACHINE" zugeordnet ist. Ein Laufwerk mit diesem Namen und der entsprechenden Zuordnung ist in Windows PowerShell standardmäßig verfügbar. Der Pfad zu diesem Registrierungsunterschlüssel kann jedoch auch mit dem folgenden alternativen Pfad angegeben werden, der mit dem Anbieternamen beginnt, auf den zwei Doppelpunkte folgen: Registry::HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion.
Beispiel 4
C:\PS>get-itemproperty -path HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion ` -name "ProgramFilesDir" Beschreibung ----------- Mit diesem Befehl werden der Name des Werts und die Daten des Registrierungseintrags "ProgramFilesDir" im Registrierungsunterschlüssel "CurrentVersion" abgerufen. Der Befehl gibt mit dem Path-Parameter den Unterschlüssel an, und der Name des Werts des Eintrags wird im Name-Parameter angegeben.
Beispiel 5
C:\PS>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=31bf3856ad
364e35, ProcessorArchitecture=msil
PowerShellVersion : 2.0
RuntimeVersion : v2.0.50727
CTPVersion : 5
PSCompatibleVersion : 1.0,2.0
Beschreibung
-----------
Dieser Befehl ruft die Wertnamen und die Daten der Registrierungseinträge im Registrierungsschlüssel PowerShellEngine ab. Die Ergebnisse werden in der folgenden Beispielausgabe gezeigt.
Beispiel 6
C:\PS>get-itemproperty -path HKLM:\SOFTWARE\Microsoft\PowerShell\1\ShellIds\Microsoft.PowerShell
Path ExecutionPolicy
---- ---------------
C:\Windows\system32\WindowsPowerShell\v1.0\powershell.exe RemoteSigned
C:\PS>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
Beschreibung
-----------
In diesem Beispiel wird gezeigt, wie die Ausgabe eines Get-ItemProperty-Befehls zur übersichtlichen Anzeige der Registrierungswerte und -daten in einer Liste formatiert und die Interpretation der Ergebnisse erleichtert werden kann.
Der erste Befehl verwendet das Cmdlet "Get-ItemProperty", um die Registrierungseinträge im Unterschlüssel Microsoft.PowerShell abzurufen. Dieser Unterschlüssel speichert Optionen für die Standardshell für Windows PowerShell. Die Ergebnisse werden in der folgenden Beispielausgabe gezeigt.
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. Die Darstellung in einer Liste ist jedoch häufig übersichtlicher.
Im zweiten Befehl wird der gleiche Get-ItemProperty-Befehl verwendet. In diesem Fall verwendet der Befehl jedoch einen Pipelineoperator (|), um die Ergebnisse des Befehls an das Cmdlet "Format-List" zu senden. Im Befehl "Format-List" werden mit dem Property-Parameter mit dem Wert * (alle) alle Eigenschaften der Objekte in einer Liste angezeigt. Die Ergebnisse werden in der folgenden Beispielausgabe gezeigt.
In der resultierenden Anzeige werden die Registrierungseinträge "Path" und "ExecutionPolicy" angezeigt sowie einige weniger häufig verwendete Eigenschaften des Registrierungsschlüsselobjekts. Bei den anderen Eigenschaften, denen "PS" vorangestellt ist, handelt es sich um Eigenschaften von benutzerdefinierten Windows PowerShell-Objekten, z. B. den Objekten, die die Registrierungsschlüssel darstellen.
Siehe auch