Freigeben über

Get-Item

  • Referenz
Modul:
Microsoft.PowerShell.Management

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>]
Get-Item
   [-Path] <string[]>
   [-Filter <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Force]
   [-Credential <pscredential>]
   [-CodeSigningCert]
   [-DocumentEncryptionCert]
   [-SSLServerAuthentication]
   [-DnsName <string>]
   [-Eku <string[]>]
   [-ExpiringInDays <int>]
   [<CommonParameters>]
Get-Item
   -LiteralPath <string[]>
   [-Filter <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Force]
   [-Credential <pscredential>]
   [-CodeSigningCert]
   [-DocumentEncryptionCert]
   [-SSLServerAuthentication]
   [-DnsName <string>]
   [-Eku <string[]>]
   [-ExpiringInDays <int>]
   [<CommonParameters>]
Get-Item
   [-Path] <string[]>
   [-Filter <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Force]
   [-Credential <pscredential>]
   [<CommonParameters>]
Get-Item
   -LiteralPath <string[]>
   [-Filter <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Force]
   [-Credential <pscredential>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Get-Item ruft das Element an der angegebenen Position ab. Der Inhalt des Elements wird nicht am Ort abgerufen, es sei denn, Sie verwenden ein Wildcard-Zeichen (*), um alle Inhalte des Elements anzufordern.

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

Beispiele

Beispiel 1: Abrufen des aktuellen Verzeichnisses

Dieses Beispiel ruft das aktuelle Verzeichnis ab. Der Punkt ('.') stellt das Element an der aktuellen Position (nicht dessen 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

Dieses Beispiel ruft das aktuelle Verzeichnis des Laufwerks C: ab. Das abgerufene Objekt stellt nur das Verzeichnis dar, nicht dessen Inhalt.

Get-Item C:

Beispiel 4: Abrufen von Elementen im angegebenen Laufwerk

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

Get-Item C:\*

Verwenden Sie in PowerShell ein einzelnes Sternchen (*), um Inhalte anstelle der herkömmlichen *.*abzurufen. Das Format wird wörtlich interpretiert, sodass *.* keine Verzeichnisse oder Dateinamen ohne Punkt abrufen würden.

Beispiel 5: Abrufen einer Eigenschaft im angegebenen Verzeichnis

Dieses Beispiel ruft die Eigenschaft LastAccessTime des C:\Windows Verzeichnisses ab. LastAccessTime- ist nur eine Eigenschaft von Dateisystemverzeichnissen. Geben Sie (Get-Item <directory-name>) | Get-Memberein, um alle Eigenschaften eines Verzeichnisses anzuzeigen.

(Get-Item C:\Windows).LastAccessTime

Beispiel 6: Anzeigen des Inhalts eines Registrierungsschlüssels

Dieses Beispiel zeigt den Inhalt des Microsoft.PowerShell Registrierungsschlüssels. Sie können dieses Cmdlet mit dem PowerShell-Registrierungsanbieter verwenden, um Registrierungsschlüssel und Unterschlüssel abzurufen. Sie müssen jedoch das Cmdlet Get-ItemProperty 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 mit einem Ausschluss

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

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

In PowerShell 6.2 wurde eine alternative Ansicht hinzugefügt, um Hardlinkinformationen abzurufen. Um die Hardlink-Informationen zu erhalten, leiten Sie die Ausgabe nach 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 Eigenschaft Mode identifiziert den Hardlink durch das l in la---

Beispiel 9: Ausgabe für Nicht-Windows Betriebssysteme

In PowerShell 7.1 auf Unix-Systemen bietet das cmdlet Get-Item Unix-ähnliche Ausgabe:

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 sind die Dateiberechtigungen, wie sie in einem Unix-System dargestellt werden
  • Benutzer- ist der Dateibesitzer
  • Gruppe ist der Gruppenbesitzer
  • Size ist die Größe der Datei oder des Verzeichnisses, wie auf einem Unix-System dargestellt

Anmerkung

Dieses Feature wurde von experimentell in PowerShell 7.1 in den Mainstream verschoben.

Parameter

-CodeSigningCert

Dies ist ein dynamischer Parameter, der vom anbieter Certificate zur Verfügung gestellt wird. Dieser Parameter und der anbieter für Certificate sind nur unter Windows verfügbar.

Um Zertifikate abzurufen, die Code Signing in ihrem EnhancedKeyUsageList-Eigenschaftswert haben, verwenden Sie den Parameter CodeSigningCert.

Weitere Informationen findest du unter about_Certificate_Provider.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Credential

Anmerkung

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 imitieren oder Ihre Anmeldeinformationen beim Ausführen dieses Cmdlets zu erhöhen.

Typ:PSCredential
Position:Named
Standardwert:Current user
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-DnsName

Dies ist ein dynamischer Parameter, der vom anbieter Certificate zur Verfügung gestellt wird. Dieser Parameter und der anbieter für Certificate sind nur unter Windows verfügbar.

Gibt einen Domänennamen oder ein Namensmuster an, das mit der DNSNameList Eigenschaft von Zertifikaten übereinstimmt, die das Cmdlet abruft. Der Wert dieses Parameters kann entweder Unicode oder ASCIIsein. Punycode-Werte werden in Unicode konvertiert. Wildcardzeichen (*) sind zulässig.

Dieser Parameter wurde in PowerShell 7.1 erneut eingeführt.

Weitere Informationen findest du unter about_Certificate_Provider.

Typ:DnsNameRepresentation
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

-DocumentEncryptionCert

Dies ist ein dynamischer Parameter, der vom anbieter Certificate zur Verfügung gestellt wird. Dieser Parameter und der anbieter für Certificate sind nur unter Windows verfügbar.

Um Zertifikate abzurufen, die in ihrem EnhancedKeyUsageList Eigenschaftswert Document Encryption haben, verwenden Sie den parameter DocumentEncryptionCert.

Weitere Informationen findest du unter about_Certificate_Provider.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Eku

Dies ist ein dynamischer Parameter, der vom anbieter Certificate zur Verfügung gestellt wird. Dieser Parameter und der anbieter für Certificate sind nur unter Windows verfügbar.

Gibt Text oder ein Textmuster an, das mit der Eigenschaft EnhancedKeyUsageList der Zertifikate, die das Cmdlet abruft, übereinstimmen soll. Wildcardzeichen (*) sind zulässig. Die Eigenschaft EnhancedKeyUsageList enthält den Anzeigenamen und die OID-Felder der EKU.

Dieser Parameter wurde in PowerShell 7.1 erneut eingeführt.

Weitere Informationen findest du unter about_Certificate_Provider.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

-Exclude

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

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

-ExpiringInDays

Dies ist ein dynamischer Parameter, der vom anbieter Certificate zur Verfügung gestellt wird. Dieser Parameter und der anbieter für Certificate sind nur unter Windows verfügbar.

Gibt an, dass das Cmdlet nur Zertifikate zurückgeben soll, die innerhalb oder vor der angegebenen Anzahl von Tagen ablaufen. Ein Wert von Null (0) ruft Zertifikate ab, die abgelaufen sind.

Dieser Parameter wurde in PowerShell 7.1 erneut eingeführt.

Weitere Informationen findest du unter about_Certificate_Provider.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Filter

Gibt einen Filter an, der den parameter Path qualifizieren soll. 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 PowerShell die Objekte nach dem Abrufen filtern zu lassen. Die Filterzeichenfolge wird an die .NET-API übergeben, um Dateien aufzählen zu können. Die API unterstützt nur * und ? Wildcards.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

-Force

Gibt an, dass dieses Cmdlet Elemente abruft, auf die andernfalls nicht zugegriffen werden kann, z. B. ausgeblendete Elemente. Die Implementierung variiert von Anbieter zu Anbieter. Weitere Informationen finden Sie unter über_Anbieter. Selbst bei Verwendung des parameters Force kann das Cmdlet keine Sicherheitseinschränkungen außer Kraft setzen.

Typ:SwitchParameter
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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 Muster ein, z. B. *.txt. Platzhalterzeichen sind zulässig. Die Include-Parameter ist nur wirksam, wenn der Befehl den Inhalt eines Elements enthält, z. B. C:\Windows\*, wobei das Wildcardzeichen den Inhalt des C:\Windows Verzeichnisses angibt.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

-LiteralPath

Gibt einen Pfad zu einem oder mehreren Speicherorten an. Der Wert LiteralPath- wird genau so verwendet, wie er eingegeben wird. Es werden keine Zeichen als Wildcards interpretiert. Wenn der Pfad Escapezeichen enthält, schließen Sie ihn in einfache Anführungszeichen ein. Einfache Anführungszeichen weisen PowerShell an, keine Zeichen als Escapesequenzen zu interpretieren.

Weitere Informationen finden Sie unter about_Quoting_Rules.

Typ:String[]
Aliase:PSPath, LP
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Path

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

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

Typ:String[]
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:True

-SSLServerAuthentication

Dies ist ein dynamischer Parameter, der vom anbieter Certificate zur Verfügung gestellt wird. Dieser Parameter und der anbieter für Certificate sind nur unter Windows verfügbar.

Um Zertifikate abzurufen, die in ihrem EnhancedKeyUsageList Eigenschaftswert Server Authentication haben, verwenden Sie den parameter SSLServerAuthentication.

Weitere Informationen findest du unter about_Certificate_Provider.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Stream

Dies ist ein dynamischer Parameter, der vom FileSystem Provider zur Verfügung gestellt wird. Dieser Parameter ist nur unter Windows verfügbar.

Ruft den angegebenen alternativen Datenstrom aus der Datei ab. Geben Sie den Datenstromnamen ein. Platzhalter werden unterstützt. Um alle Datenströme abzurufen, verwenden Sie ein Sternchen (*). Dieser Parameter ist für Verzeichnisse gültig, beachten Sie jedoch, dass Verzeichnisse standardmäßig keine Datenströme enthalten.

Dieser Parameter wurde in PowerShell 3.0 eingeführt. Ab PowerShell 7.2 können Get-Item alternative Datenströme aus Verzeichnissen und Dateien abrufen.

Weitere Informationen finden Sie unter about_FileSystem_Provider.

Typ:String[]
Position:Named
Standardwert:No alternate file streams
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

Eingaben

String

Sie können eine Zeichenfolge weiterleiten, die einen Pfad zu diesem Cmdlet enthält.

Ausgaben

AliasInfo

Das Cmdlet gibt diesen Typ aus, wenn auf das Alias: Laufwerk zugegriffen wird.

X509StoreLocation

X509Store

X509Certificate2

Das Cmdlet gibt diese Typen aus, wenn es auf das Cert: Laufwerk zugreift.

DictionaryEntry

Das Cmdlet gibt diesen Typ aus, wenn auf das Env: Laufwerk zugegriffen wird.

DirectoryInfo

FileInfo

Das Cmdlet gibt diese Typen aus, wenn sie auf die Dateisystemlaufwerke zugreifen.

FunctionInfo

FilterInfo

Das Cmdlet gibt diese Typen aus, wenn es auf die Function: Laufwerke zugreift.

RegistryKey

Das Cmdlet gibt diesen Typ beim Zugriff auf die Registrierungslaufwerke aus.

PSVariable

Das Cmdlet gibt diesen Typ aus, wenn auf die Variable: Laufwerke zugegriffen wird.

WSManConfigContainerElement

WSManConfigLeafElement

Das Cmdlet gibt diese Typen aus, wenn es auf die WSMan:-Laufwerke zugreift.

Hinweise

PowerShell enthält die folgenden Aliase für Get-Item:

  • Alle Plattformen:
    • gi

Dieses Cmdlet hat keinen Recurse Parameter, da es nur ein Element abruft, nicht dessen Inhalt. Verwenden Sie Get-ChildItem, um den Inhalt eines Elements rekursiv abzurufen.

Verwenden Sie dieses Cmdlet, um die Registrierung zu durchsuchen und Registrierungsschlüssel sowie die Get-ItemProperty abzurufen, um Registrierungswerte und -daten zu erhalten. Die Registrierungswerte werden als Eigenschaften des Registrierungsschlüssels betrachtet.

Dieses Cmdlet wurde entwickelt, um mit den Daten zu arbeiten, die von einem beliebigen Anbieter verfügbar gemacht werden. Geben Sie Get-PsProviderein, um die in Ihrer Sitzung verfügbaren Anbieter auflisten zu können. Weitere Informationen finden Sie unter über_Anbieter.