Get-Content

Syntax

Path (Standard)

Get-Content
    [-Path] <string[]>
    [-ReadCount <long>]
    [-TotalCount <long>]
    [-Tail <int>]
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Force]
    [-Credential <pscredential>]
    [-UseTransaction]
    [-Delimiter <string>]
    [-Wait]
    [-Raw]
    [-Encoding <FileSystemCmdletProviderEncoding>]
    [-Stream <string>]
    [<CommonParameters>]

LiteralPath

Get-Content
    -LiteralPath <string[]>
    [-ReadCount <long>]
    [-TotalCount <long>]
    [-Tail <int>]
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Force]
    [-Credential <pscredential>]
    [-UseTransaction]
    [-Delimiter <string>]
    [-Wait]
    [-Raw]
    [-Encoding <FileSystemCmdletProviderEncoding>]
    [-Stream <string>]
    [<CommonParameters>]

Beschreibung

Beispiele

Beispiel 1: Abrufen des Inhalts einer Textdatei

1..100 | ForEach-Object { Add-Content -Path .\LineNumbers.txt -Value "This is line $_." }
Get-Content -Path .\LineNumbers.txt

This is Line 1
This is Line 2
...
This is line 99.
This is line 100.

Beispiel 2: Begrenzen Sie die Anzahl der Zeilen, die Get-Content zurückgibt

Get-Content -Path .\LineNumbers.txt -TotalCount 5

This is Line 1
This is Line 2
This is Line 3
This is Line 4
This is Line 5

Beispiel 3: Abrufen einer bestimmten Inhaltszeile aus einer Textdatei

(Get-Content -Path .\LineNumbers.txt -TotalCount 25)[-1]

This is Line 25

Beispiel 4: Abrufen der letzten Zeile einer Textdatei

Get-Item -Path .\LineNumbers.txt | Get-Content -Tail 1

This is Line 100

Beispiel 5: Abrufen des Inhalts eines alternativen Datenstroms

Set-Content -Path .\Stream.txt -Value 'This is the content of the Stream.txt file'
# Specify a wildcard to the Stream parameter to display all streams of the recently created file.
Get-Item -Path .\Stream.txt -Stream *

PSPath        : Microsoft.PowerShell.Core\FileSystem::C:\Test\Stream.txt::$DATA
PSParentPath  : Microsoft.PowerShell.Core\FileSystem::C:\Test
PSChildName   : Stream.txt::$DATA
PSDrive       : C
PSProvider    : Microsoft.PowerShell.Core\FileSystem
PSIsContainer : False
FileName      : C:\Test\Stream.txt
Stream        : :$DATA
Length        : 44

# Retrieve the content of the primary, or $DATA stream.
Get-Content -Path .\Stream.txt -Stream $DATA

This is the content of the Stream.txt file

# Use the Stream parameter of Add-Content to create a new Stream containing sample content.
Add-Content -Path .\Stream.txt -Stream NewStream -Value 'Added a stream named NewStream to Stream.txt'
# Use Get-Item to verify the stream was created.
Get-Item -Path .\Stream.txt -Stream *

PSPath        : Microsoft.PowerShell.Core\FileSystem::C:\Test\Stream.txt::$DATA
PSParentPath  : Microsoft.PowerShell.Core\FileSystem::C:\Test
PSChildName   : Stream.txt::$DATA
PSDrive       : C
PSProvider    : Microsoft.PowerShell.Core\FileSystem
PSIsContainer : False
FileName      : C:\Test\Stream.txt
Stream        : :$DATA
Length        : 44

PSPath        : Microsoft.PowerShell.Core\FileSystem::C:\Test\Stream.txt:NewStream
PSParentPath  : Microsoft.PowerShell.Core\FileSystem::C:\Test
PSChildName   : Stream.txt:NewStream
PSDrive       : C
PSProvider    : Microsoft.PowerShell.Core\FileSystem
PSIsContainer : False
FileName      : C:\Test\Stream.txt
Stream        : NewStream
Length        : 46

# Retrieve the content of your newly created Stream.
Get-Content -Path .\Stream.txt -Stream NewStream

Added a stream named NewStream to Stream.txt

Beispiel 6: Abrufen von unformatierten Inhalten

$raw = Get-Content -Path .\LineNumbers.txt -Raw
$lines = Get-Content -Path .\LineNumbers.txt
Write-Host "Raw contains $($raw.Count) lines."
Write-Host "Lines contains $($lines.Count) lines."

Raw contains 1 lines.
Lines contains 100 lines.

Beispiel 7: Verwenden von Filtern mit Get-Content

Get-Content -Path C:\Temp\* -Filter *.log

Beispiel 8: Abrufen von Dateiinhalten als Bytearray

$byteArray = Get-Content -Path C:\temp\test.txt -Encoding Byte -Raw
Get-Member -InputObject $bytearray

   TypeName: System.Byte[]

Name           MemberType            Definition
----           ----------            ----------
Count          AliasProperty         Count = Length
Add            Method                int IList.Add(System.Object value)

Parameter

-Credential

Parametereigenschaften

Parametersätze

-Delimiter

Gibt das Trennzeichen an, das Get-Content verwendet, um die Datei während des Lesens in Objekte aufzuteilen. Der Standardwert ist \n, das Zeilenendezeichen. Gibt beim Lesen einer Textdatei Get-Content eine Auflistung von Zeichenfolgenobjekten zurück, die jeweils mit einem Zeilenendezeichen enden. Wenn Sie ein Trennzeichen eingeben, das in der Datei nicht vorhanden ist, Get-Content wird die gesamte Datei als einzelnes Objekt ohne Trennzeichen zurückgegeben.

Mit diesem Parameter können Sie eine große Datei in kleinere Dateien aufteilen, indem Sie ein Trennzeichen als Begrenzung angeben. Das Trennzeichen wird beibehalten (nicht verworfen) und wird zum letzten Element in jedem Dateiabschnitt.

Delimiter ist ein dynamischer Parameter, den der Anbieter FileSystem dem Cmdlet Get-Content hinzufügt. Dieser Parameter funktioniert nur auf Dateisystemlaufwerken.

Parametereigenschaften

Parametersätze

-Encoding

Gibt den Typ der Codierung für die Zieldatei an. Der Standardwert ist Default.

Die zulässigen Werte für diesen Parameter sind wie folgt:

• ASCII Verwendet den ASCII-Zeichensatz (7-Bit).
• BigEndianUnicode Verwendet UTF-16 mit der Big-Endian-Bytereihenfolge.
• BigEndianUTF32 Verwendet UTF-32 mit der Big-Endian-Bytereihenfolge.
• Byte Codiert einen Satz von Zeichen in eine Sequenz von Bytes.
• Vorgabe Verwendet die Codierung, die der aktiven Codepage des Systems entspricht (in der Regel ANSI).
• OEM Verwendet die Codierung, die der aktuellen OEM-Codepage des Systems entspricht.
• Schnur Identisch mit Unicode.
• Unicode Verwendet UTF-16 mit der Little-Endian-Byte-Reihenfolge.
• Unbekannt Identisch mit Unicode.
• UTF7 (Englisch ) Verwendet UTF-7.
• UTF8-Datei Verwendet UTF-8.
• UTF32 Verwendet UTF-32 mit der Little-Endian-Byte-Reihenfolge.

Die Codierung ist ein dynamischer Parameter, den der FileSystem--Anbieter dem cmdlet Get-Content hinzufügt. Dieser Parameter funktioniert nur auf Dateisystemlaufwerken.

Verwenden Sie beim Lesen und Schreiben in Binärdateien einen Wert von Byte- für den dynamischen Parameter Encoding dynamischen Parameter und den Wert 0 für den ReadCount-Parameter. Ein ReadCount- Wert von 0 liest die gesamte Datei in einem einzelnen Lesevorgang und konvertiert sie in ein einzelnes Objekt (PSObject). Der Standardwert ReadCount- Wert 1 liest in jedem Lesevorgang ein Byte und konvertiert jedes Byte in ein separates Objekt. Dies führt zu Fehlern, wenn Sie das Cmdlet Set-Content verwenden, um die Bytes in eine Datei zu schreiben.

Parametereigenschaften

Parametersätze

-Exclude

Gibt als Array von Zeichenfolgen ein Element oder 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.

Parametereigenschaften

Parametersätze

-Filter

Gibt einen Filter an, der den parameter Path qualifizieren soll. Der FileSystem--Anbieter ist der einzige installierte PowerShell-Anbieter, der die Verwendung von Filtern unterstützt. Sie finden die Syntax für die FileSystem Filtersprache in über_Wildcards. Filter sind effizienter als andere Parameter, da der Anbieter sie anwendet, wenn das Cmdlet die Objekte abruft, anstatt dass PowerShell die Objekte nach dem Abrufen filtert.

Parametereigenschaften

Parametersätze

-Force

Force überschreibt ein schreibgeschütztes Attribut oder erstellt Verzeichnisse, um einen Dateipfad zu vervollständigen. Der Parameter Force versucht nicht, Dateiberechtigungen zu ändern oder Sicherheitseinschränkungen außer Kraft zu setzen.

Parametereigenschaften

Parametersätze

-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. Der Include Parameter ist nur wirksam, wenn der Befehl den Inhalt eines Elements einbezieht, wie zum Beispiel C:\Windows\*, wobei das Wildcard-Zeichen den Inhalt des C:\Windows-Verzeichnisses angibt.

Parametereigenschaften

Parametersätze

-LiteralPath

Gibt einen Pfad zu einem oder mehreren Speicherorten an. Der Wert von LiteralPath wird genau so verwendet, wie es geschrieben ist. Es werden keine Zeichen als Wildcards interpretiert. Wenn der Pfad Escapezeichen enthält, müssen Sie ihn in einfache Anführungszeichen einschließen. Einfache Anführungszeichen signalisieren PowerShell, dass keine Zeichen als Escapesequenzen interpretiert werden sollen.

Weitere Informationen finden Sie unter über_Zitierregeln.

Parametereigenschaften

Parametersätze

-Path

Gibt den Pfad zu einem Element an, von dem Get-Content den Inhalt erhält. Platzhalterzeichen sind zulässig. Die Pfade müssen Pfade zu Elementen und nicht zu Containern sein. Sie müssen z. B. einen Pfad zu einer oder mehreren Dateien angeben, nicht einen Pfad zu einem Verzeichnis.

Parametereigenschaften

Parametersätze

-Raw

Ignoriert Neuzeilenzeichen und gibt den gesamten Inhalt einer Datei in einer Zeichenfolge zurück, wobei die Newlines beibehalten werden. Standardmäßig werden Zeilenumbrüche in einer Datei als Trennzeichen verwendet, um die Eingabe in eine Reihe von Zeichenfolgen aufzuteilen. Dieser Parameter wurde in PowerShell 3.0 eingeführt.

Raw- ist ein dynamischer Parameter, den der FileSystem-Anbieter dem cmdlet Get-Content Hinzufügt. Dieser Parameter funktioniert nur auf Dateisystemlaufwerken.

Parametereigenschaften

Parametersätze

-ReadCount

Gibt an, wie viele Inhaltszeilen gleichzeitig über die Pipeline gesendet werden. Der Standardwert ist 1. Bei einem Wert von 0 (null) wird der gesamte Inhalt gleichzeitig gesendet.

Dieser Parameter ändert nicht den angezeigten Inhalt, wirkt sich jedoch auf die Zeit aus, die zum Anzeigen des Inhalts benötigt wird. Da der Wert von ReadCount zunimmt, nimmt die Zeit, die zum Zurückgeben der ersten Zeile benötigt wird, aber die Gesamtzeit für den Vorgang sinkt. Dies kann einen spürbaren Unterschied bei großen Objekten machen.

Parametereigenschaften

Parametersätze

-Stream

Ruft den Inhalt des angegebenen alternativen NTFS-Dateidatenstroms aus der Datei ab. Geben Sie den Datenstromnamen ein. Wildcards werden nicht unterstützt.

Stream ist ein dynamischer Parameter, den der FileSystem-Anbieter dem Cmdlet Get-Content hinzufügt. Dieser Parameter funktioniert nur auf Dateisystemlaufwerken auf Windows-Systemen. Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.

Parametereigenschaften

Parametersätze

-Tail

Gibt die Anzahl der Zeilen vom Ende einer Datei oder eines anderen Elements an. Sie können den Parameternamen Tail oder dessen Alias, Last, verwenden. Dieser Parameter wurde in PowerShell 3.0 eingeführt.

Parametereigenschaften

Parametersätze

-TotalCount

Gibt die Anzahl der Zeilen vom Anfang einer Datei oder eines anderen Elements an. Der Standardwert ist -1 (alle Zeilen).

Sie können den Parameternamen TotalCount oder seine Aliasnamen First oder Head verwenden.

Parametereigenschaften

Parametersätze

-UseTransaction

Enthält den Befehl in der aktiven Transaktion. Dieser Parameter ist nur gültig, wenn eine Transaktion ausgeführt wird. Weitere Informationen finden Sie unter about_Transactions.

Parametereigenschaften

Parametersätze

-Wait

Lässt die Datei geöffnet, nachdem alle vorhandenen Zeilen ausgegeben wurden. Während des Wartens Get-Content wird die Datei einmal pro Sekunde überprüft und neue Zeilen ausgegeben, falls vorhanden. Sie können Wait unterbrechen, indem Sie STRG+C drücken. Das Warten endet auch, wenn die Datei gelöscht wird, in diesem Fall wird ein nicht beendender Fehler gemeldet.

Wait ist ein dynamischer Parameter, den der FileSystem-Anbieter dem Cmdlet Get-Content hinzufügt. Dieser Parameter funktioniert nur auf Dateisystemlaufwerken. Wait kann nicht mit Raw kombiniert werden.

Parametereigenschaften

Parametersätze

CommonParameters

Eingaben

System.Int64, System.String

Ausgaben

System.Byte, System.String

Hinweise

Ähnliche Themen

• Über_Automatische_Variablen
• Über_Anbieter
• Add-Content (Inhalt hinzufügen)
• Inhalt löschen
• ForEach-Object
• Get-PSProvider
• Set-Content