Get-Content

Referenz

Modul:: Microsoft.PowerShell.Management

Ruft den Inhalt des Elements an der angegebenen Position ab.

Syntax

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

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

Beschreibung

Das Cmdlet Get-Content ruft den Inhalt des Elements an der durch den Pfad angegebenen Position ab, z. B. den Text in einer Datei oder den Inhalt einer Funktion. Bei Dateien wird der Inhalt jeweils eine Zeile gelesen und gibt eine Auflistung von Objekten zurück, die jeweils eine Inhaltszeile darstellen.

Ab PowerShell 3.0 kann Get-Content auch eine angegebene Anzahl von Zeilen vom Anfang oder Ende eines Elements abrufen.

Beispiele

Beispiel 1: Abrufen des Inhalts einer Textdatei

In diesem Beispiel wird der Inhalt einer Datei im aktuellen Verzeichnis angezeigt. Die datei LineNumbers.txt enthält 100 Zeilen im Format, Dies ist Zeile X und wird in mehreren Beispielen verwendet.

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.

Die Arraywerte 1-100 werden an das Cmdlet ForEach-Object weitergeleitet. ForEach-Object verwendet einen Skriptblock mit dem Cmdlet Add-Content zum Erstellen der LineNumbers.txt-Datei. Die Variable $_ stellt die Arraywerte dar, da jedes Objekt an die Pipeline gesendet wird. Das Cmdlet Get-Content verwendet den Parameter Path, um die LineNumbers.txt Datei anzugeben und den Inhalt in der PowerShell-Konsole anzuzeigen.

Beispiel 2: Einschränken der Anzahl von Zeilen Get-Content Rückgaben

Dieser Befehl ruft die ersten fünf Zeilen einer Datei ab. Der parameter TotalCount ruft die ersten fünf Inhaltszeilen ab. In diesem Beispiel wird die LineNumbers.txt verwendet, auf die in Beispiel 1 verwiesen wird.

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

Dieser Befehl ruft eine bestimmte Anzahl von Zeilen aus einer Datei ab und zeigt dann nur die letzte Zeile dieses Inhalts an. Der parameter TotalCount ruft die ersten 25 Inhaltszeilen ab. In diesem Beispiel wird die LineNumbers.txt Datei verwendet, auf die in Beispiel 1 verwiesen wird.

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

This is Line 25

Der Befehl Get-Content wird in Klammern eingeschlossen, sodass der Befehl abgeschlossen wird, bevor er zum nächsten Schritt geht. Get-Contentein Array von Zeilen zurückgibt, können Sie die Indexnotation nach der Klammer hinzufügen, um eine bestimmte Zeilennummer abzurufen. In diesem Fall gibt der [-1] Index den letzten Index im zurückgegebenen Array von 25 abgerufenen Zeilen an.

Beispiel 4: Abrufen der letzten Zeile einer Textdatei

Dieser Befehl ruft die letzte Inhaltszeile aus einer Datei ab. In diesem Beispiel wird die LineNumbers.txt Datei verwendet, die in Beispiel 1 erstellt wurde.

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

This is Line 100

In diesem Beispiel wird das Cmdlet Get-Item verwendet, um zu veranschaulichen, dass Sie Dateien an Get-Contentweiterleiten können. Der parameter Tail ruft die letzte Zeile der Datei ab. Diese Methode ist schneller als das Abrufen aller Zeilen in einer Variablen und die Verwendung der [-1] Indexnotation.

Beispiel 5: Abrufen des Inhalts eines alternativen Datenstroms

In diesem Beispiel wird beschrieben, wie Sie den Parameter Stream verwenden, um den Inhalt eines alternativen Datenstroms für Dateien abzurufen, die auf einem Windows NTFS-Volume gespeichert sind. In diesem Beispiel wird das Cmdlet Set-Content verwendet, um Beispielinhalte in einer Datei namens Stream.txtzu erstellen.

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

Der parameter Stream ist ein dynamischer Parameter des FileSystem-Anbieters. Standardmäßig Get-Content nur Daten aus dem Standarddatenstrom oder :$DATA Datenstrom abrufen. Streams können verwendet werden, um ausgeblendete Daten wie Attribute, Sicherheitseinstellungen oder andere Daten zu speichern. Sie können auch in Verzeichnissen gespeichert werden, ohne untergeordnete Elemente zu sein.

Beispiel 6: Abrufen von unformatierten Inhalten

Die Befehle in diesem Beispiel rufen den Inhalt einer Datei als eine Zeichenfolge anstelle eines Arrays von Zeichenfolgen ab. Standardmäßig wird der Inhalt ohne den Raw- dynamischen Parameter als Array von durch Zeilentrennzeichen getrennten Zeichenfolgen zurückgegeben. In diesem Beispiel wird die LineNumbers.txt Datei verwendet, auf die in Beispiel 1 verwiesen wird.

$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

Sie können einen Filter für das Cmdlet Get-Content angeben. Wenn Sie Filter verwenden, um den parameter Path zu qualifizieren, müssen Sie ein nachfolgendes Sternchen (*) einschließen, um den Inhalt des Pfads anzugeben.

Der folgende Befehl ruft den Inhalt aller *.log Dateien im verzeichnis C:\Temp ab.

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

Beispiel 8: Abrufen von Dateiinhalten als Bytearray

In diesem Beispiel wird veranschaulicht, wie der Inhalt einer Datei als [byte[]] als einzelnes Objekt abgerufen wird.

$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)

Der erste Befehl verwendet den AsByteStream Parameter, um den Datenstrom von Bytes aus der Datei abzurufen. Der parameter Raw stellt sicher, dass die Bytes als [System.Byte[]]zurückgegeben werden. Wenn der parameter Raw nicht vorhanden war, handelt es sich beim Rückgabewert um einen Bytestrom, der von PowerShell als [System.Object[]]interpretiert wird.

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. Wenn Sie die Single-Byte-Ausgabe an Set-Content übergeben, werden Fehler verursacht, es sei denn, Sie verwenden den AsByteStream Parameter mit Set-Content.

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

-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 als Trennzeichen ein Dateitrennzeichen angeben. Das Trennzeichen wird beibehalten (nicht verworfen) und wird zum letzten Element in jedem Dateiabschnitt.

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

Anmerkung

Wenn der Wert des Delimiter--Parameters eine leere Zeichenfolge ist, gibt Get-Content nichts zurück. Dies ist ein bekanntes Problem. Um zu erzwingen, dass Get-Content die gesamte Datei als einzelne, nicht getrennte Zeichenfolge zurückgeben. Geben Sie einen Wert ein, der in der Datei nicht vorhanden ist.

Typ:	String
Position:	Named
Standardwert:	End-of-line character
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

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

Anmerkung

UTF-7* wird nicht mehr empfohlen zu verwenden. Ab PowerShell 7.1 wird eine Warnung geschrieben, wenn Sie utf7 für den parameter Encoding angeben.

Typ:	Encoding
Zulässige Werte:	ASCII, BigEndianUnicode, BigEndianUTF32, OEM, Unicode, UTF7, UTF8, UTF8BOM, UTF8NoBOM, UTF32
Position:	Named
Standardwert:	UTF8NoBOM
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-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

-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 powerShell nach dem Abrufen der Objekte zu filtern.

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

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

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 über_Zitierregeln.

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, in dem Get-Content den Inhalt abruft. 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.

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

-Raw

Ignoriert Neuzeilenzeichen und gibt den gesamten Inhalt einer Datei in einer Zeichenfolge zurück, wobei die Newlines beibehalten werden. Standardmäßig werden Zeilenumbruchzeichen in einer Datei als Trennzeichen verwendet, um die Eingabe in ein Array von Zeichenfolgen zu trennen. 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.

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

-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 in großen Elementen machen.

Typ:	Int64
Position:	Named
Standardwert:	1
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-Stream

Anmerkung

Dieser Parameter ist nur unter Windows verfügbar.

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.

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

-Tail

Gibt die Anzahl der Zeilen vom Ende einer Datei oder eines anderen Elements an. Sie können den Tail Parameternamen oder dessen Alias Lastverwenden. Ein Wert von 0 gibt keine Zeilen zurück. Negative Werte verursachen einen Fehler.

Dieser Parameter wurde in PowerShell 3.0 eingeführt.

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

-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 TotalCount Parameternamen oder deren Aliase, First oder Headverwenden.

Typ:	Int64
Aliase:	First, Head
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-Wait

Bewirkt, dass das Cmdlet auf unbestimmte Zeit wartet und die Datei geöffnet bleibt, bis sie unterbrochen wurde. 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 enthält, gibt Get-Content jede Zeile beim Eintreffen aus, wartet jedoch, bis die zehnte Zeile vor dem Beenden eingeht.

Sie können Warten 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.

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

Eingaben

Int64

Sie können die Leseanzahl oder die Gesamtanzahl an dieses Cmdlet weiterleiten.

String[]

Sie können Pfade zu diesem Cmdlet weiterleiten.

PSCredential

Sie können Anmeldeinformationen an dieses Cmdlet weiterleiten.

Ausgaben

Byte

Wenn Sie den parameter AsByteStream verwenden, gibt dieses Cmdlet den Inhalt als Bytes zurück.

String

Standardmäßig gibt dieses Cmdlet den Inhalt als Array von Zeichenfolgen zurück, eine pro Zeile. Wenn Sie den Parameter Raw verwenden, wird eine einzelne Zeichenfolge zurückgegeben, die jede Zeile in der Datei enthält.

Hinweise

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

Alle Plattformen:
- gc
- type
Fenster:
- cat

Das Cmdlet Get-Content ist für die Arbeit mit den Daten konzipiert, die von einem beliebigen Anbieter verfügbar gemacht werden. Verwenden Sie das Cmdlet Get-PSProvider, um die Anbieter in Ihrer Sitzung abzurufen. Weitere Informationen finden Sie unter über_Anbieter.

Freigeben über

Get-Content

Syntax

Beschreibung

Beispiele

Beispiel 1: Abrufen des Inhalts einer Textdatei

Beispiel 2: Einschränken der Anzahl von Zeilen Get-Content Rückgaben

Beispiel 3: Abrufen einer bestimmten Inhaltszeile aus einer Textdatei

Beispiel 4: Abrufen der letzten Zeile einer Textdatei

Beispiel 5: Abrufen des Inhalts eines alternativen Datenstroms

Beispiel 6: Abrufen von unformatierten Inhalten

Beispiel 7: Verwenden von Filtern mit Get-Content

Beispiel 8: Abrufen von Dateiinhalten als Bytearray

Parameter

-AsByteStream

-Credential

-Delimiter

-Encoding

-Exclude

-Filter

-Force

-Include

-LiteralPath

-Path

-Raw

-ReadCount

-Stream

-Tail

-TotalCount

-Wait

Eingaben

Ausgaben

Hinweise

Zusätzliche Ressourcen

Freigeben über

Get-Content

Syntax

Beschreibung

Beispiele

Beispiel 1: Abrufen des Inhalts einer Textdatei

Beispiel 2: Einschränken der Anzahl von Zeilen Get-Content Rückgaben

Beispiel 3: Abrufen einer bestimmten Inhaltszeile aus einer Textdatei

Beispiel 4: Abrufen der letzten Zeile einer Textdatei

Beispiel 5: Abrufen des Inhalts eines alternativen Datenstroms

Beispiel 6: Abrufen von unformatierten Inhalten

Beispiel 7: Verwenden von Filtern mit Get-Content

Beispiel 8: Abrufen von Dateiinhalten als Bytearray

Parameter

-AsByteStream

-Credential

-Delimiter

-Encoding

-Exclude

-Filter

-Force

-Include

-LiteralPath

-Path

-Raw

-ReadCount

-Stream

-Tail

-TotalCount

-Wait

Eingaben

Ausgaben

Hinweise

Ähnliche Themen

Zusätzliche Ressourcen