Get-Content

Syntax

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

Get-Content
   [-ReadCount <Int64>]
   [-TotalCount <Int64>]
   [-Tail <Int32>]
   -LiteralPath <String[]>
   [-Filter <String>]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Force]
   [-Credential <PSCredential>]
   [-UseTransaction]
   [-Delimiter <String>]
   [-Wait]
   [-Raw]
   [-Encoding <FileSystemCmdletProviderEncoding>]
   [-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 Get-Content kan du också hämta 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åt i pipelinen. Cmdleten Get-Content använder parametern Path för att ange LineNumbers.txt filen och visar innehållet i PowerShell-konsolen.

Exempel 2: Begränsa antalet rader som 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 referensen LineNumbers.txt 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 filen LineNumbers.txt 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 index notationen efter parentesen för att hämta ett specifikt radnummer. I det här fallet anger indexet [-1] 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 LineNumbers.txt här exemplet används filen 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. Tail-parametern 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 index notationen [-1] .

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

I det här exemplet beskrivs hur du använder Stream-parametern 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

Stream-parametern är en dynamisk parameter för FileSystem-providern. Som standard Get-Content hämtar endast data från standardvärdet eller :$DATA dataströmmen. Strömmar kan användas för att lagra dolda data, till exempel attribut, säkerhetsinställningar eller andra data.

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 raw-parametern returneras som standard innehållet som en matris med newline-avgränsade strängar. I det här exemplet används filen LineNumbers.txt 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 sökvägsparametern 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 C:\Temp katalogen.

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 ett [byte[]] enda objekt.

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

Det första kommandot använder kodningsparametern för att hämta strömmen med byte från filen. Raw-parametern säkerställer 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

-Credential

-Delimiter

-Encoding

-Exclude

-Filter

-Force

-Include

-LiteralPath

-Path

-Raw

-ReadCount

-Stream

-Tail

-TotalCount

-UseTransaction

-Wait

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 raw-parametern returneras en enskild sträng som innehåller varje rad i filen.

Kommentarer

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

• cat
• gc
• type

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

Relaterade länkar

• about_Automatic_Variables
• about_Providers
• Add-Content
• Clear-Content
• ForEach-Object
• Get-PSProvider
• Set-Content