Share via


Get-Item

Ruft das Element am angegebenen Speicherort ab.

Syntax

Get-Item
   [-Path] <String[]>
   [-Filter <String>]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Force]
   [-Credential <PSCredential>]
   [-Stream <String[]>]
   [<CommonParameters>]
Get-Item
   -LiteralPath <String[]>
   [-Filter <String>]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Force]
   [-Credential <PSCredential>]
   [-Stream <String[]>]
   [<CommonParameters>]

Beschreibung

Das Get-Item Cmdlet ruft das Element am angegebenen Speicherort ab. Der Inhalt des Elements wird nicht an der Position abgerufen, es sei denn, Sie verwenden ein Wildcardzeichen (*), um den gesamten Inhalt des Elements anzufordern.

Dieses Cmdlet wird von PowerShell-Anbietern verwendet, um durch verschiedene Arten von Datenspeichern zu navigieren.

Beispiele

Beispiel 1: Abrufen des aktuellen Verzeichnisses

In diesem Beispiel wird das aktuelle Verzeichnis abgerufen. Der Punkt ('.') stellt das Element an der aktuellen Position (nicht seinen Inhalt) dar.

Get-Item .

Directory: C:\

Mode                LastWriteTime     Length Name
----                -------------     ------ ----
d----         7/26/2006  10:01 AM            ps-test

Beispiel 2: Abrufen aller Elemente im aktuellen Verzeichnis

In diesem Beispiel werden alle Elemente im aktuellen Verzeichnis abgerufen. Das Wildcardzeichen (*) stellt den gesamten Inhalt des aktuellen Elements dar.

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

Beispiel 3: Abrufen des aktuellen Verzeichnisses eines Laufwerks

In diesem Beispiel wird das aktuelle Verzeichnis des C: Laufwerks abgerufen. Das abgerufene Objekt stellt nur das Verzeichnis dar, nicht dessen Inhalt.

Get-Item C:

Beispiel 4: Abrufen von Elementen auf dem angegebenen Laufwerk

In diesem Beispiel werden die Elemente im C: Laufwerk abgerufen. Das Wildcardzeichen (*) stellt alle Elemente im Container dar, nicht nur den Container.

Get-Item C:\*

Verwenden Sie in PowerShell anstelle des herkömmlichen *.*ein einzelnes Sternchen (*), um Inhalte abzurufen. Das Format wird wörtlich interpretiert, sodass *.* Verzeichnisse oder Dateinamen ohne Punkt nicht abgerufen werden.

Beispiel 5: Abrufen einer Eigenschaft im angegebenen Verzeichnis

In diesem Beispiel wird die LastAccessTime-Eigenschaft des C:\Windows Verzeichnisses abgerufen. LastAccessTime ist nur eine Eigenschaft von Dateisystemverzeichnissen. Um alle Eigenschaften eines Verzeichnisses anzuzeigen, geben Sie ein (Get-Item <directory-name>) | Get-Member.

(Get-Item C:\Windows).LastAccessTime

Beispiel 6: Anzeigen des Inhalts eines Registrierungsschlüssels

Dieses Beispiel zeigt den Inhalt des Registrierungsschlüssels Microsoft.PowerShell . Sie können dieses Cmdlet mit dem PowerShell-Registrierungsanbieter verwenden, um Registrierungsschlüssel und Unterschlüssel abzurufen, aber Sie müssen das Get-ItemProperty Cmdlet verwenden, um die Registrierungswerte und Daten abzurufen.

Get-Item HKLM:\Software\Microsoft\Powershell\1\Shellids\Microsoft.Powershell\

Beispiel 7: Abrufen von Elementen in einem Verzeichnis, die über einen Ausschluss verfügen

In diesem Beispiel werden Elemente im Windows-Verzeichnis mit Namen abgerufen, die einen Punkt (.) enthalten, aber nicht mit w*beginnen. Dieses Beispiel funktioniert nur, wenn der Pfad ein Wildcardzeichen (*) enthält, um den Inhalt des Elements anzugeben.

Get-Item C:\Windows\*.* -Exclude "w*"

Beispiel 8: Abrufen von Hardlinkinformationen

In PowerShell 6.2 wurde eine alternative Ansicht hinzugefügt, um Hardlinkinformationen abzurufen. Um die Hardlinkinformationen abzurufen, übergeben Sie die Ausgabe an Format-Table -View childrenWithHardlink

Get-Item C:\Windows\System32\ntoskrnl.exe | Format-Table -view childrenWithHardLink

Directory: C:\Windows\System32

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
la---           5/12/2021  7:40 AM       10848576 ntoskrnl.exe

Die Mode -Eigenschaft identifiziert den Hardlink durch den l in la---

Beispiel 9: Ausgabe für Nicht-Windows-Betriebssysteme

In PowerShell 7.1 auf Unix-Systemen stellt das Get-Item Cmdlet eine Unix-ähnliche Ausgabe bereit:

PS> Get-Item /Users

Directory: /

UnixMode    User  Group   LastWriteTime      Size  Name
--------    ----  -----   -------------      ----  ----
drwxr-xr-x  root  admin   12/20/2019 11:46   192   Users

Die neuen Eigenschaften, die jetzt Teil der Ausgabe sind, sind:

  • UnixMode ist die Dateiberechtigung, wie sie auf einem Unix-System dargestellt wird.
  • Der Benutzer ist der Dateibesitzer.
  • Group ist der Gruppenbesitzer.
  • Größe ist die Größe der Datei oder des Verzeichnisses, wie sie auf einem Unix-System dargestellt wird.

Hinweis

Dieses Feature wurde von „Experimentell“ in „Mainstream“ in PowerShell 7.1 verschoben.

Parameter

-Credential

Hinweis

Dieser Parameter wird von anbietern, die mit PowerShell installiert sind, nicht unterstützt. Verwenden Sie Invoke-Command, um die Identität eines anderen Benutzers zu annehmen oder Ihre Anmeldeinformationen beim Ausführen dieses Cmdlets zu erhöhen.

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

-Exclude

Gibt als Zeichenfolgenarray ein Element oder Elemente an, die von diesem Cmdlet im Vorgang ausgeschlossen werden. Der Wert dieses Parameters qualifiziert den Path-Parameter. Geben Sie ein Path-Element oder -Muster ein, z *.txt. B. . Platzhalterzeichen sind zulässig. Der Exclude-Parameter ist nur wirksam, wenn der Befehl den Inhalt eines Elements enthält, z C:\Windows\*. B. , wobei das Wildcardzeichen den Inhalt des C:\Windows Verzeichnisses angibt.

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

-Filter

Gibt einen Filter an, um den Path-Parameter zu qualifizieren. Der FileSystem-Anbieter ist der einzige installierte PowerShell-Anbieter, der Filter unterstützt. Filter sind effizienter als andere Parameter. Der Anbieter wendet filter an, wenn das Cmdlet die Objekte abruft, anstatt die Objekte nach dem Abrufen von PowerShell filtern zu lassen. Die Filterzeichenfolge wird an die .NET-API übergeben, um Dateien aufzulisten. Die API unterstützt * nur und ? Wildcards.

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

-Force

Gibt an, dass dieses Cmdlet Elemente abruft, auf die andernfalls nicht zugegriffen werden kann, z. B. ausgeblendete Elemente. Die Implementierung unterscheidet sich bei den einzelnen Anbietern. Weitere Informationen finden Sie unter about_Providers. Selbst mit dem Force-Parameter kann das Cmdlet keine Sicherheitseinschränkungen außer Kraft setzen.

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

-Include

Gibt als Zeichenfolgenarray ein Element oder Elemente an, die dieses Cmdlet in den Vorgang einschließt. Der Wert dieses Parameters qualifiziert den Path-Parameter. Geben Sie ein Path-Element oder -Muster ein, z *.txt. B. . Platzhalterzeichen sind zulässig. Der Include-Parameter ist nur wirksam, wenn der Befehl den Inhalt eines Elements enthält, z C:\Windows\*. B. , wobei das Wildcardzeichen den Inhalt des C:\Windows Verzeichnisses angibt.

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

-LiteralPath

Gibt einen Pfad zu einem oder mehreren Speicherorten an. Der Wert von LiteralPath wird 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.

Weitere Informationen finden Sie unter about_Quoting_Rules.

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

-Path

Gibt den Pfad zu einem Element an. Dieses Cmdlet ruft das Element am angegebenen Speicherort ab. Platzhalterzeichen sind zulässig. Dieser Parameter ist erforderlich, aber der Parametername Path ist optional.

Verwenden Sie einen Punkt (.), um die aktuelle Position anzugeben. Verwenden Sie das Wildcardzeichen (*), um alle Elemente am aktuellen Speicherort anzugeben.

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

-Stream

Hinweis

Dieser Parameter ist nur unter Windows verfügbar.

Ruft den angegebenen alternativen NTFS-Dateidatenstrom aus der Datei ab. Geben Sie den Namen des Stroms ein. Platzhalter werden unterstützt. Um alle Streams abzurufen, verwenden Sie ein Sternchen (*). Dieser Parameter ist für Ordner ungültig.

Stream ist ein dynamischer Parameter, den der FileSystem-Anbieter dem Get-Item Cmdlet hinzufügt. Dieser Parameter funktioniert nur in Dateisystemlaufwerken.

Type:String[]
Position:Named
Default value:No alternate file streams
Required:False
Accept pipeline input:False
Accept wildcard characters:True

Eingaben

String

Sie können eine Zeichenfolge, die einen Pfad enthält, an dieses Cmdlet übergeben.

Ausgaben

Object

Dieses Cmdlet gibt die Objekte zurück, die es abruft. Der Typ wird durch den Typ der im Pfad enthaltenen Objekte bestimmt.

Hinweise

Dieses Cmdlet verfügt nicht über einen Recurse-Parameter , da es nur ein Element und nicht dessen Inhalt abruft. Um den Inhalt eines Elements rekursiv abzurufen, verwenden Sie Get-ChildItem.

Um durch die Registrierung zu navigieren, verwenden Sie dieses Cmdlet zum Abrufen von Registrierungsschlüsseln und zum Abrufen von Get-ItemProperty Registrierungswerten und -daten. Die Registrierungswerte werden als Eigenschaften des Registrierungsschlüssels angesehen.

Dieses Cmdlet 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 ein Get-PsProvider. Weitere Informationen finden Sie unter about_Providers.