Ruft die Eigenschaften eines angegebenen Elements ab. (Get-ItemProperty)
NAMEGet-ItemPropertyÜBERSICHTRuft die Eigenschaften eines angegebenen Elements ab.SYNTAXGet-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>]BESCHREIBUNGDas 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 [<SwitchParameter>] 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 folgende allgemeine Parameter: "Verbose", "Debug", "ErrorAction", "ErrorVariable", "WarningAction", "WarningVariable", "OutBuffer" und "OutVariable". Weitere Informationen erhalten Sie mit dem Befehl "get-help about_commonparameters".EINGABENSystem.String Sie können eine Zeichenfolge mit einem Pfad über die Pipeline an Get-ItemProperty übergeben.AUSGABENObject Get-ItemProperty gibt ein Objekt für jede Elementeigenschaft zurück, die das Cmdlet abruft. Der Objekttyp richtet sich nach dem abgerufenen Objekt.HINWEISEDas 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".Beispiele
BEISPIEL 1C:\PS>get-itemproperty C:\Windows Beschreibung ----------- Mit diesem Befehl werden Informationen über das Verzeichnis "C:\Windows" abgerufen.BEISPIEL 2C:\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 3C:\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 4C:\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 5C:\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 6C:\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. VERWANDTE LINKS Online version: http://go.microsoft.com/fwlink/?LinkID=113320 (möglicherweise auf Englisch) about_Providers Set-ItemProperty Clear-ItemProperty Copy-ItemProperty Move-ItemProperty New-ItemProperty Remove-ItemProperty Rename-ItemProperty C:\Windows>powershell get-help Get-WmiObject -full
Microsoft Windows [Version 10.0.19045.3693]
Copyright (c) 2023 Microsoft Corporation.
ColorConsole [Version 3.7.1000] PowerShell 2.0-Export
