Get-Content

Syntax

Path (Standardwert)

Get-Content
    [-Path] <String[]>
    [-ReadCount <Int64>]
    [-TotalCount <Int64>]
    [-Tail <Int32>]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-Force]
    [-Credential <PSCredential>]
    [-Delimiter <String>]
    [-Wait]
    [-Raw]
    [-Encoding <Encoding>]
    [-AsByteStream]
    [-Stream <String>]
    [<CommonParameters>]

LiteralPath

Get-Content
    -LiteralPath <String[]>
    [-ReadCount <Int64>]
    [-TotalCount <Int64>]
    [-Tail <Int32>]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-Force]
    [-Credential <PSCredential>]
    [-Delimiter <String>]
    [-Wait]
    [-Raw]
    [-Encoding <Encoding>]
    [-AsByteStream]
    [-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 stream.
# Note the single quotes to prevent variable substitution.
Get-Content -Path .\Stream.txt -Stream ':$DATA'

This is the content of the Stream.txt file

# Alternative way to get the same content.
Get-Content -Path .\Stream.txt -Stream ""
# The primary stream doesn't need to be specified to get the primary stream of the file.
# This gets the same data as the prior two examples.
Get-Content -Path .\Stream.txt

This is the content of the Stream.txt file

# Use the Stream parameter of Add-Content to create a new Stream containing sample
# content.
$addContentSplat = @{
    Path = '.\Stream.txt'
    Stream = 'NewStream'
    Value = 'Added a stream named NewStream to Stream.txt'
}
Add-Content @addContentSplat

# 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 -AsByteStream -Raw
Get-Member -InputObject $byteArray

   TypeName: System.Byte[]

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

Parameter

-AsByteStream

Gibt an, dass der Inhalt als Bytedatenstrom gelesen werden soll. Der AsByteStream--Parameter wurde in Windows PowerShell 6.0 eingeführt.

Eine Warnung tritt auf, wenn Sie den AsByteStream Parameter mit dem parameter Encoding verwenden. Der AsByteStream Parameter ignoriert jede Codierung, und die Ausgabe wird als Bytedatenstrom zurückgegeben.

Verwenden Sie beim Lesen und Schreiben in Binärdateien den parameter AsByteStream und den Wert 0 für den parameter ReadCount. Ein ReadCount- Wert von 0 liest die gesamte Datei in einem einzelnen Lesevorgang. Der Standardwert ReadCount Wert 1 liest in jedem Lesevorgang ein Byte und konvertiert jedes Byte in ein separates Objekt. Die Weiterleitung von Single-Byte-Ausgaben an Set-Content führt zu Fehlern, es sei denn, Sie verwenden den Parameter AsByteStream mit Set-Content.

Parametereigenschaften

Parametersätze

-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. Beim Lesen einer Textdatei gibt 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, gibt Get-Content die gesamte Datei als einzelnes, nicht getrenntes Objekt zurück.

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 utf8NoBOM.

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

• ascii: Verwendet die Codierung für den ASCII-Zeichensatz (7-Bit).
• ansi: Verwendet die Kodierung für die ANSI-Codepage der aktuellen Kultur. Diese Option wurde in PowerShell 7.4 hinzugefügt.
• bigendianunicode: Codiert im UTF-16-Format mithilfe der Big-Endian-Byte-Reihenfolge.
• bigendianutf32: Codiert im UTF-32-Format unter Verwendung der Big-Endian-Byte-Reihenfolge.
• oem: Verwendet die Standardcodierung für MS-DOS- und Konsolenprogramme.
• unicode: Codiert im UTF-16-Format unter Verwendung der "little-endian"-Bytereihenfolge.
• utf7: Codiert im UTF-7-Format.
• utf8: Codiert im UTF-8-Format.
• utf8BOM: Codiert im UTF-8-Format mit Byte Order Mark (BOM)
• utf8NoBOM: Codiert im UTF-8-Format ohne Byte Order Mark (BOM)
• utf32: Codiert im UTF-32-Format.

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

Ab PowerShell 6.2 ermöglicht der parameter Encoding auch numerische IDs registrierter Codeseiten (z. B. -Encoding 1251) oder Zeichenfolgennamen registrierter Codeseiten (z. B. -Encoding "windows-1251"). Weitere Informationen finden Sie in der .NET-Dokumentation für Encoding.CodePage-.

Ab PowerShell 7.4 können Sie den Ansi Wert für den parameter Encoding verwenden, um die numerische ID für die ANSI-Codeseite der aktuellen Kultur zu übergeben, ohne sie manuell angeben zu müssen.

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 kann ein schreibgeschütztes Attribut überschreiben oder Verzeichnisse erstellen, um einen Dateipfad abzuschließen. 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 LiteralPath- wird genau so verwendet, wie er eingegeben wird. 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. Ein Wert von 0 (Null) oder negativen Zahlen sendet gleichzeitig den gesamten Inhalt.

Dieser Parameter ändert den angezeigten Inhalt nicht, 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. In PowerShell 7.2 können Get-Content den Inhalt alternativer Datenströme aus Verzeichnissen und Dateien abrufen.

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. Ein Wert von 0 gibt keine Zeilen zurück. Negative Werte verursachen einen Fehler.

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. Ein Wert von 0 gibt keine Zeilen zurück. Negative Werte verursachen einen Fehler.

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

Parametereigenschaften

Parametersätze

-Wait

Bewirkt, dass das Cmdlet unbegrenzt wartet und die Datei geöffnet bleibt, bis es unterbrochen wird. Während des Wartens überprüft Get-Content die Datei einmal pro Sekunde und gibt neue Zeilen aus, falls vorhanden. Bei Verwendung mit dem parameter TotalCount wartet Get-Content, bis die angegebene Anzahl von Zeilen in der angegebenen Datei verfügbar ist. Wenn Sie beispielsweise eine TotalCount- von 10 angeben und die Datei bereits über 10 oder mehr Zeilen verfügt, gibt Get-Content die 10 Zeilen und Ausgänge zurück. Wenn die Datei weniger als 10 Zeilen hat, gibt Get-Content jede Zeile aus, wenn sie eintrifft, wartet aber, bis die zehnte Zeile eintrifft, bevor es beendet wird.

Sie können Wait unterbrechen, indem Sie Strg+C drücken. Durch das Löschen der Datei wird ein nicht beendeter Fehler verursacht, der auch das Warten unterbricht.

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

Int64

String

PSCredential

Ausgaben

Byte

String

Hinweise

Ähnliche Themen

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