Get-Item
Ruft das Element am angegebenen Speicherort ab.
Syntax
Get-Item [-LiteralPath] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-UseTransaction] [<CommonParameters>]
Get-Item [-Path] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-UseTransaction] [<CommonParameters>]
Beschreibung
Das Cmdlet "Get-Item" ruft das Element am angegebenen Speicherort ab. Dabei wird nicht der Inhalt des Elements am Speicherort abgerufen, es sei denn, Sie fordern mit einem Platzhalterzeichen (*) den gesamten Inhalt des Elements an.
Windows PowerShell-Anbieter erlauben mithilfe des Cmdlets "Get-Item" das Navigieren durch verschiedene Typen von Datenspeichern.
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. Der Path-Parameter wird durch den Wert dieses Parameters qualifiziert. Geben Sie ein Pfadelement oder -muster wie "*.txt" ein. Platzhalter sind zulässig.
Der Exclude-Parameter ist nur dann wirksam, wenn der Befehl den Inhalt eines Elements enthält, beispielsweise "C:\Windows\*", wobei das Platzhalterzeichen den Inhalt des Verzeichnisses "C:\Windows" angibt.
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 |
-Force
Ermöglicht dem Cmdlet das Abrufen von Elementen, auf die anderweitig nicht zugegriffen werden kann, z. B. versteckte Elemente. Die Implementierung unterscheidet sich bei den einzelnen Anbietern. Weitere Informationen finden Sie unter "about_Providers". Auch bei Verwendung des Force-Parameters kann das Cmdlet keine Sicherheitseinschränkungen außer Kraft setzen.
Erforderlich? |
false |
Position? |
named |
Standardwert |
|
Pipelineeingaben akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
-Include <string[]>
Ruft nur die angegebenen Elemente ab. Der Path-Parameter wird durch den Wert dieses Parameters qualifiziert. Geben Sie ein Pfadelement oder -muster wie "*.txt" ein. Platzhalter sind zulässig.
Der Include-Parameter ist nur dann wirksam, wenn der Befehl den Inhalt eines Elements enthält, beispielsweise "C:\Windows\*", wobei das Platzhalterzeichen den Inhalt des Verzeichnisses "C:\Windows" angibt.
Erforderlich? |
false |
Position? |
named |
Standardwert |
|
Pipelineeingaben akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
-LiteralPath <string[]>
Gibt den Pfad zum Element an. Im Gegensatz zu "Path" wird der Wert von "LiteralPath" 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 |
-Path <string[]>
Gibt den Pfad für ein Element an. Get-Item ruft das Element am angegebenen Speicherort ab. Platzhalter sind zulässig. Dieser Parameter ist erforderlich, der Parametername ("Path") ist jedoch optional.
Verwenden Sie einen Punkt (.), um den aktuellen Speicherort anzugeben. Mit dem Platzhalterzeichen (*) geben Sie alle Elemente am aktuellen Speicherort 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-Item übergeben. |
Ausgaben |
Object Get-Item gibt die vom Cmdlet abgerufenen Objekte zurück. Der Typ wird durch den Typ der im Pfad enthaltenen Objekte bestimmt. |
Hinweise
Sie können auch über den integrierten Alias "gi" auf Get-Item verweisen. Weitere Informationen finden Sie unter "about_Aliases".
Get-Item weist keinen Recurse-Parameter auf, da nur ein Element und nicht dessen Inhalt abgerufen wird. Verwenden Sie Get-ChildItem, um den Inhalt eines Elements rekursiv abzurufen.
Um durch die Registrierung zu navigieren, rufen Sie mit Get-Item Registrierungsschlüssel und mit Get-ItemProperty Registrierungswerte und -daten ab. Die Registrierungswerte werden als Eigenschaften des Registrierungsschlüssels angesehen.
Das Cmdlet "Get-Item" 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-item .
Directory: C:\
Mode LastWriteTime Length Name
---- ------------- ------ ----
d---- 7/26/2006 10:01 AM ps-test
Beschreibung
-----------
Mit diesem Befehl wird das aktuelle Verzeichnis abgerufen. Der Punkt (.) stellt das Element am aktuellen Speicherort (jedoch nicht dessen Inhalt) dar.
Beispiel 2
C:\PS>get-item *
Directory: C:\ps-test
Mode LastWriteTime Length Name
---- ------------- ------ ----
d---- 7/26/2006 9:29 AM Logs
d---- 7/26/2006 9:26 AM Recs
-a--- 7/26/2006 9:28 AM 80 date.csv
-a--- 7/26/2006 10:01 AM 30 filenoext
-a--- 7/26/2006 9:30 AM 11472 process.doc
-a--- 7/14/2006 10:47 AM 30 test.txt
Beschreibung
-----------
Mit diesem Befehl werden alle Elemente im aktuellen Verzeichnis abgerufen. Das Platzhalterzeichen (*) stellt den gesamten Inhalt des aktuellen Elements dar.
Beispiel 3
C:\PS>get-item C:\
Beschreibung
-----------
Mit diesem Befehl wird das aktuelle Verzeichnis des Laufwerks "C:" abgerufen. Das abgerufene Objekt stellt nur das Verzeichnis dar, nicht dessen Inhalt.
Beispiel 4
C:\PS>get-item C:\*
Beschreibung
-----------
Mit diesem Befehl werden die Elemente auf Laufwerk "C:" abgerufen. Das Platzhalterzeichen (*) stellt alle Elemente im Container dar, nicht nur den Container.
Verwenden Sie in Windows PowerShell zum Abrufen des Inhalts ein einzelnes Sternchen (*) und nicht das herkömmliche "*.*". Das Format wird buchstäblich interpretiert, daher würden mit "*.*" keine Verzeichnisse oder Dateinamen abgerufen werden, die keinen Punkt enthalten.
Beispiel 5
C:\PS>(get-item C:\Windows).LastAccessTime
Beschreibung
-----------
Mit diesem Befehl wird die LastAccessTime-Eigenschaft des Verzeichnisses "C:\Windows" abgerufen. "LastAccessTime" ist nur eine der Eigenschaften von Verzeichnissen des Dateisystems. Um alle Eigenschaften eines Verzeichnisses anzuzeigen, geben Sie "(Get-Item <Verzeichnisname>) | Get-Member" ein.
Beispiel 6
C:\PS>get-item hklm:\software\microsoft\powershell\1\shellids\microsoft.powershell\*
Beschreibung
-----------
Mit diesem Befehl wird der Inhalt des Registrierungsschlüssels "Microsoft.PowerShell" angezeigt. Sie können Get-Item zusammen mit dem Windows PowerShell-Registry-Anbieter verwenden, um Registrierungsschlüssel und -unterschlüssel abzurufen, die Registrierungswerte und -daten müssen Sie jedoch mit Get-ItemProperty abrufen.
Beispiel 7
C:\PS>get-item c:\Windows\* -include *.* -exclude w*
Beschreibung
-----------
Mit diesem Befehl werden die Elemente im Windows-Verzeichnis abgerufen, deren Name einen Punkt (.) enthält und nicht mit "w*" beginnt. Dieser Befehl kann nur verwendet werden, wenn der Pfad ein Platzhalterzeichen (*) enthält, mit dem der Inhalt des Elements angegeben wird.
Siehe auch
Konzepte
about_Providers
Clear-Item
Copy-Item
Invoke-Item
Move-Item
Set-Item
New-Item
Remove-Item
Rename-Item