Get-Content

Referens

Modul:: Microsoft.PowerShell.Management

Hämtar innehållet i objektet på den angivna platsen.

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

Description

Cmdleten Get-Content hämtar innehållet i objektet på den plats som anges av sökvägen, till exempel texten i en fil eller innehållet i en funktion. För filer läss innehållet en rad i taget och returnerar en samling objekt som var och en representerar en innehållsrad.

Från och med PowerShell 3.0 kan Get-Content också få ett angivet antal rader från början eller slutet av ett objekt.

Exempel

Exempel 1: Hämta innehållet i en textfil

Det här exemplet hämtar innehållet i en fil i den aktuella katalogen. Filen LineNumbers.txt har 100 rader i formatet, Det här är rad X och används i flera exempel.

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.

Matrisvärdena 1–100 skickas ned i pipelinen till cmdleten ForEach-Object. ForEach-Object använder ett skriptblock med cmdleten Add-Content för att skapa LineNumbers.txt-filen. Variabeln $_ representerar matrisvärdena när varje objekt skickas ned i pipelinen. Cmdleten Get-Content använder parametern Path för att ange LineNumbers.txt-filen och visa innehållet i PowerShell-konsolen.

Exempel 2: Begränsa antalet rader Get-Content returnerar

Det här kommandot hämtar de första fem raderna i en fil. Parametern TotalCount hämtar de fem första innehållsraderna. I det här exemplet används LineNumbers.txt som anges i exempel 1.

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

Exempel 3: Hämta en specifik innehållsrad från en textfil

Det här kommandot hämtar ett visst antal rader från en fil och visar sedan endast den sista raden i innehållet. Parametern TotalCount hämtar de första 25 innehållsraderna. I det här exemplet används den LineNumbers.txt fil som refereras i Exempel 1.

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

This is Line 25

Kommandot Get-Content omsluts av parenteser så att kommandot slutförs innan du går till nästa steg. Get-Contentreturnerar en matris med rader, vilket gör att du kan lägga till indexnotationen efter parentesen för att hämta ett specifikt radnummer. I det här fallet anger [-1] index det sista indexet i den returnerade matrisen med 25 hämtade rader.

Exempel 4: Hämta den sista raden i en textfil

Det här kommandot hämtar den sista innehållsraden från en fil. I det här exemplet används den LineNumbers.txt fil som skapades i exempel 1.

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

This is Line 100

I det här exemplet används cmdleten Get-Item för att visa att du kan skicka filer till Get-Content. Parametern Tail hämtar den sista raden i filen. Den här metoden går snabbare än att hämta alla rader i en variabel och använda [-1] index notation.

Exempel 5: Hämta innehållet i en alternativ dataström

I det här exemplet beskrivs hur du använder parametern Stream för att hämta innehållet i en alternativ dataström för filer som lagras på en Windows NTFS-volym. I det här exemplet används cmdleten Set-Content för att skapa exempelinnehåll i en fil med namnet Stream.txt.

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

Parametern Stream är en dynamisk parameter för FileSystem-providern. Som standardinställning hämtar Get-Content endast data från standardströmmen eller :$DATA. Streams kan användas för att lagra dolda data, till exempel attribut, säkerhetsinställningar eller andra data. De kan också lagras på kataloger utan att vara underordnade objekt.

Exempel 6: Hämta råinnehåll

Kommandona i det här exemplet hämtar innehållet i en fil som en sträng i stället för en matris med strängar. Utan den dynamiska parametern Raw returneras som standard innehåll som en matris med nya, avgränsade strängar. I det här exemplet används den LineNumbers.txt fil som refereras i Exempel 1.

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

Exempel 7: Använd filter med Get-Content

Du kan ange ett filter för cmdleten Get-Content. När du använder filter för att kvalificera parametern Path måste du inkludera en avslutande asterisk (*) för att ange innehållet i sökvägen.

Följande kommando hämtar innehållet i alla *.log filer i katalogen C:\Temp.

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

Exempel 8: Hämta filinnehåll som en bytematris

Det här exemplet visar hur du hämtar innehållet i en fil som en [byte[]] som ett enda objekt.

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

Det första kommandot använder parametern AsByteStream för att hämta strömmen med byte från filen. Parametern Raw ser till att byte returneras som en [System.Byte[]]. Om parametern Raw saknades är returvärdet en ström med byte, vilket tolkas av PowerShell som [System.Object[]].

Parametrar

-AsByteStream

Anger att innehållet ska läsas som en ström med byte. Parametern AsByteStream introducerades i Windows PowerShell 6.0.

En varning inträffar när du använder parametern AsByteStream med parametern Encoding. Parametern AsByteStream ignorerar all kodning och utdata returneras som en ström av byte.

När du läser från och skriver till binära filer använder du parametern AsByteStream och värdet 0 för parametern ReadCount. Ett ReadCount värde 0 läser hela filen i en enda läsoperation. Standardvärdet ReadCount, 1, läser en byte i varje läsåtgärd och konverterar varje byte till ett separat objekt. Att skicka enbytesutdata till Set-Content orsakar fel om du inte använder parametern AsByteStream med Set-Content.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Credential

Obs.

Den här parametern stöds inte av några leverantörer som är installerade med PowerShell. Om du vill personifiera en annan användare eller höja dina autentiseringsuppgifter när du kör den här cmdleten använder du Invoke-Command.

Typ:	PSCredential
Position:	Named
Standardvärde:	Current user
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-Delimiter

Anger avgränsare som Get-Content använder för att dela upp filen i objekt medan den läser. Standardvärdet är \n, radslutstecknet. När du läser en textfil returnerar Get-Content en samling strängobjekt, var och en slutar med ett radslutstecken. När du anger en avgränsare som inte finns i filen returnerar Get-Content hela filen som ett enda, odefinierat objekt.

Du kan använda den här parametern för att dela upp en stor fil i mindre filer genom att ange en filavgränsare som avgränsare. Avgränsare bevaras (tas inte bort) och blir det sista objektet i varje filavsnitt.

Avgränsare är en dynamisk parameter som FileSystem-providern lägger till i cmdleten Get-Content. Den här parametern fungerar bara på filsystemenheter.

Notis

När värdet för parametern Avgränsare är en tom sträng returnerar Get-Content för närvarande ingenting. Det här är ett känt problem. För att tvinga Get-Content att returnera hela filen som en enda, icke-avgränsad sträng. Ange ett värde som inte finns i filen.

Typ:	String
Position:	Named
Standardvärde:	End-of-line character
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Encoding

Anger typen av kodning för målfilen. Standardvärdet är utf8NoBOM.

Godkända värden för den här parametern är följande:

ascii: Använder kodningen för ASCII-teckenuppsättningen (7-bitars).
ansi: Använder kodningen för den aktuella kulturens ANSI-kodsida. Det här alternativet lades till i PowerShell 7.4.
bigendianunicode: Kodar i UTF-16-format med hjälp av storslutsbyteordningen.
bigendianutf32: Kodar i UTF-32-format med hjälp av big-endian-byteordningen.
oem: Använder standardkodning för MS-DOS- och konsolprogram.
unicode: Kodar i UTF-16-format med hjälp av lite endiansk byteordning.
utf7: Kodar i UTF-7-format.
utf8: Kodar i UTF-8-format.
utf8BOM: Kodar i UTF-8-format med Byte Order Mark (BOM)
utf8NoBOM: Kodar i UTF-8-format utan Byte Order Mark (BOM)
utf32: Kodar i UTF-32-format.

Kodning är en dynamisk parameter som FileSystem-providern lägger till i cmdleten Get-Content. Den här parametern är endast tillgänglig på filsystemenheter.

Från och med PowerShell 6.2 tillåter parametern Kodning även numeriska ID:n för registrerade kodsidor (till exempel -Encoding 1251) eller strängnamn för registrerade kodsidor (till exempel -Encoding "windows-1251"). Mer information finns i .NET-dokumentationen för Encoding.CodePage.

Från och med PowerShell 7.4 kan du använda värdet Ansi för parametern Kodning för att skicka det numeriska ID:t för den aktuella kulturens ANSI-kodsida utan att behöva ange det manuellt.

Not

UTF-7* rekommenderas inte längre att användas. Från och med PowerShell 7.1 skrivs en varning om du anger utf7 för parametern Kodning.

Typ:	Encoding
Godkända värden:	ASCII, BigEndianUnicode, BigEndianUTF32, OEM, Unicode, UTF7, UTF8, UTF8BOM, UTF8NoBOM, UTF32
Position:	Named
Standardvärde:	UTF8NoBOM
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Exclude

Anger, som en strängmatris, ett objekt eller objekt som den här cmdleten exkluderar i åtgärden. Värdet för den här parametern kvalificerar parametern Path.

Ange ett sökvägselement eller mönster, till exempel *.txt. Jokertecken tillåts.

Parametern Exclude gäller endast när kommandot innehåller innehållet i ett objekt, till exempel C:\Windows\*, där jokertecknet anger innehållet i katalogen C:\Windows.

Typ:	String[]
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	True

-Filter

Anger ett filter för att kvalificera parametern Path. FileSystem-providern är den enda installerade PowerShell-providern som stöder användning av filter. Du hittar syntaxen för FileSystem filterspråk i about_Wildcards. Filter är effektivare än andra parametrar eftersom providern tillämpar dem när cmdleten hämtar objekten i stället för att PowerShell filtrerar objekten när de har hämtats.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	True

-Force

Force kan åsidosätta ett skrivskyddat attribut eller skapa kataloger för att slutföra en filsökväg. Parametern Force försöker inte ändra filbehörigheter eller åsidosätta säkerhetsbegränsningar.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	False
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Include

Anger, som en strängmatris, ett objekt eller objekt som den här cmdleten innehåller i åtgärden. Värdet för den här parametern kvalificerar parametern Path. Ange ett sökvägselement eller mönster, till exempel "*.txt". Jokertecken tillåts. Parametern Include gäller endast när kommandot innehåller innehållet i ett objekt, till exempel C:\Windows\*, där jokertecknet anger innehållet i katalogen C:\Windows.

Typ:	String[]
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	True

-LiteralPath

Anger en sökväg till en eller flera platser. Värdet för LiteralPath- används exakt som det skrivs. Inga tecken tolkas som wildcards. Om sökvägen innehåller escape-tecken omger du den med enkla citattecken. Enkla citattecken gör att PowerShell inte tolkar några tecken som escape-sekvenser.

Mer information finns i about_Quoting_Rules.

Typ:	String[]
Alias:	PSPath, LP
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-Path

Anger sökvägen till ett objekt där Get-Content hämtar innehållet. Jokertecken tillåts. Sökvägarna måste vara sökvägar till objekt, inte till containrar. Du måste till exempel ange en sökväg till en eller flera filer, inte en sökväg till en katalog.

Typ:	String[]
Position:	0
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	True

-Raw

Ignorerar nya radtecken och returnerar hela innehållet i en fil i en sträng med de nya raderna bevarade. Som standard används nya radtecken i en fil som avgränsare för att separera indata i en matris med strängar. Den här parametern introducerades i PowerShell 3.0.

Raw är en dynamisk parameter som FileSystem-providern lägger till i cmdleten Get-Content Den här parametern fungerar bara på filsystemenheter.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-ReadCount

Anger hur många rader innehåll som skickas via pipelinen i taget. Standardvärdet är 1. Ett värde på 0 (noll) eller negativa tal skickar allt innehåll samtidigt.

Den här parametern ändrar inte innehållet som visas, men det påverkar den tid det tar att visa innehållet. När värdet för ReadCount ökar ökar den tid det tar att returnera den första raden, men den totala tiden för åtgärden minskar. Detta kan göra en märkbar skillnad i stora objekt.

Typ:	Int64
Position:	Named
Standardvärde:	1
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-Stream

Anteckning

Den här parametern är endast tillgänglig i Windows.

Hämtar innehållet i den angivna alternativa NTFS-filströmmen från filen. Ange namnet på streamen. Jokertecken stöds inte.

Stream är en dynamisk parameter som FileSystem-providern lägger till i cmdleten Get-Content. Den här parametern fungerar endast på filsystemenheter i Windows-system.

Den här parametern introducerades i Windows PowerShell 3.0. I PowerShell 7.2 kan Get-Content hämta innehållet i alternativa dataströmmar från kataloger och filer.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Tail

Anger antalet rader från slutet av en fil eller ett annat objekt. Du kan använda parameternamnet Tail eller dess alias Last. Värdet 0 returnerar inga rader. Negativa värden orsakar ett fel.

Den här parametern introducerades i PowerShell 3.0.

Typ:	Int32
Alias:	Last
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-TotalCount

Anger antalet rader från början av en fil eller ett annat objekt. Värdet 0 returnerar inga rader. Negativa värden orsakar ett fel.

Du kan använda parameternamnet TotalCount eller dess alias, First eller Head.

Typ:	Int64
Alias:	First, Head
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-Wait

Gör att cmdleten väntar på obestämd tid och håller filen öppen tills den avbryts. I väntan kontrollerar Get-Content filen en gång per sekund och matar ut nya rader om de finns. När den används med parametern TotalCount väntar Get-Content tills det angivna antalet rader är tillgängliga i den angivna filen. Om du till exempel anger en TotalCount- på 10 och filen redan har 10 eller fler rader, returnerar Get-Content de 10 raderna och utgångarna. Om filen har färre än 10 rader matar Get-Content ut varje rad när den tas emot, men väntar tills den tionde raden kommer innan den avslutas.

Du kan avbryta Vänta genom att trycka på Ctrl+C. Om du tar bort filen uppstår ett fel som inte avslutas och som också avbryter väntetiden.

Wait är en dynamisk parameter som FileSystem-providern lägger till i cmdleten Get-Content. Den här parametern fungerar bara på filsystemenheter. Vänta kan inte kombineras med Raw.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	False
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

Indata

Int64

Du kan skicka läsantalet eller det totala antalet till den här cmdleten.

String[]

Du kan skicka sökvägar till den här cmdleten.

PSCredential

Du kan skicka autentiseringsuppgifter till den här cmdleten.

Utdata

Byte

När du använder parametern AsByteStream returnerar den här cmdleten innehållet som byte.

String

Som standard returnerar den här cmdleten innehållet som en matris med strängar, en per rad. När du använder parametern Raw returneras en enskild sträng som innehåller varje rad i filen.

Kommentarer

PowerShell innehåller följande alias för Get-Content:

Alla plattformar:
- gc
- type
Windows:
- cat

Cmdleten Get-Content är utformad för att fungera med data som exponeras av alla leverantörer. Om du vill hämta leverantörerna i sessionen använder du cmdleten Get-PSProvider. Mer information finns i about_Providers.

Dela via

Get-Content

Syntax

Description

Exempel

Exempel 1: Hämta innehållet i en textfil

Exempel 2: Begränsa antalet rader Get-Content returnerar

Exempel 3: Hämta en specifik innehållsrad från en textfil

Exempel 4: Hämta den sista raden i en textfil

Exempel 5: Hämta innehållet i en alternativ dataström

Exempel 6: Hämta råinnehåll

Exempel 7: Använd filter med Get-Content

Exempel 8: Hämta filinnehåll som en bytematris

Parametrar

-AsByteStream

-Credential

-Delimiter

-Encoding

-Exclude

-Filter

-Force

-Include

-LiteralPath

-Path

-Raw

-ReadCount

-Stream

-Tail

-TotalCount

-Wait

Indata

Utdata

Kommentarer

Ytterligare resurser

Dela via

Get-Content

Syntax

Description

Exempel

Exempel 1: Hämta innehållet i en textfil

Exempel 2: Begränsa antalet rader Get-Content returnerar

Exempel 3: Hämta en specifik innehållsrad från en textfil

Exempel 4: Hämta den sista raden i en textfil

Exempel 5: Hämta innehållet i en alternativ dataström

Exempel 6: Hämta råinnehåll

Exempel 7: Använd filter med Get-Content

Exempel 8: Hämta filinnehåll som en bytematris

Parametrar

-AsByteStream

-Credential

-Delimiter

-Encoding

-Exclude

-Filter

-Force

-Include

-LiteralPath

-Path

-Raw

-ReadCount

-Stream

-Tail

-TotalCount

-Wait

Indata

Utdata

Kommentarer

Relaterade länkar

Ytterligare resurser