Get-Content

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

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

Polecenie cmdlet Get-Content pobiera zawartość elementu w lokalizacji określonej przez ścieżkę, taką jak tekst w pliku lub zawartość funkcji. W przypadku plików zawartość jest odczytywana pojedynczo i zwraca kolekcję obiektów, z których każda reprezentuje wiersz zawartości.

Począwszy od programu PowerShell 3.0, Get-Content może również uzyskać określoną liczbę wierszy od początku lub końca elementu.

Ten przykład pobiera zawartość pliku w bieżącym katalogu. Plik LineNumbers.txt ma 100 wierszy w formacie, Jest to wiersz X i jest używany w kilku przykładach.

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.

Wartości tablicy 1–100 są wysyłane w dół potoku do polecenia cmdlet ForEach-Object. ForEach-Object używa bloku skryptu z poleceniem cmdlet Add-Content do utworzenia pliku LineNumbers.txt. Zmienna $_ reprezentuje wartości tablicy w miarę jak każdy obiekt jest wysyłany w dół potoku. Polecenie cmdlet Get-Content używa parametru path, aby określić plik LineNumbers.txt i wyświetlić zawartość w konsoli programu PowerShell.

To polecenie pobiera pierwsze pięć wierszy pliku. Parametr TotalCount pobiera pięć pierwszych wierszy zawartości. Ten przykład wykorzystuje LineNumbers.txt, o którym mowa w przykładzie 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

To polecenie pobiera określoną liczbę wierszy z pliku, a następnie wyświetla tylko ostatni wiersz tej zawartości. Parametr TotalCount pobiera pierwsze 25 wierszy zawartości. W tym przykładzie użyto pliku LineNumbers.txt, do którego odnosi się przykład 1.

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

This is Line 25

Polecenie Get-Content jest opakowane w nawiasy, aby polecenie zostało ukończone przed przejściem do następnego kroku. Get-Contentzwraca tablicę wierszy, dzięki czemu można dodać notację indeksu po nawiasie w celu pobrania określonego numeru wiersza. W tym przypadku indeks [-1] określa ostatni indeks w zwracanej tablicy 25 pobranych wierszy.

To polecenie pobiera ostatni wiersz zawartości z pliku. W tym przykładzie użyto pliku LineNumbers.txt utworzonego w przykładzie 1.

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

This is Line 100

W tym przykładzie użyto polecenia cmdlet Get-Item, aby zademonstrować, że można przesyłać pliki do Get-Content. Parametr Tail pobiera ostatni wiersz pliku. Ta metoda jest szybsza niż pobieranie wszystkich wierszy w zmiennej i używanie notacji indeksu [-1].

W tym przykładzie opisano sposób użycia parametru Stream w celu pobrania zawartości alternatywnego strumienia danych dla plików przechowywanych na woluminie NTFS systemu Windows. W tym przykładzie polecenie cmdlet Set-Content służy do tworzenia przykładowej zawartości w pliku o nazwie 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

Parametr Stream jest parametrem dynamicznym dostawcy systemu plików . Domyślnie Get-Content pobiera tylko dane z domyślnego lub :$DATA strumienia. Strumienie mogą służyć do przechowywania ukrytych danych, takich jak atrybuty, ustawienia zabezpieczeń lub inne dane.

Polecenia w tym przykładzie pobierają zawartość pliku jako jeden ciąg zamiast tablicy ciągów. Domyślnie, bez nieprzetworzonego parametru dynamicznego , zawartość jest zwracana jako tablica ciągów oddzielonych nowymi wierszami. W tym przykładzie użyto pliku LineNumbers.txt, do którego odnosi się przykład 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.

Możesz określić filtr dla polecenia cmdlet Get-Content. W przypadku używania filtrów do kwalifikowania parametru ścieżki , należy dołączyć gwiazdkę na końcu (*), aby wskazać zawartość ścieżki.

Następujące polecenie pobiera zawartość wszystkich plików *.log w katalogu C:\Temp.

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

W tym przykładzie pokazano, jak pobrać zawartość pliku jako [byte[]] jako pojedynczy obiekt.

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

Pierwsze polecenie używa parametru Encoding w celu pobrania strumienia bajtów z pliku. Parametr Raw gwarantuje, że bajty są zwracane jako [System.Byte[]]. Jeśli parametr Raw był nieobecny, zwracana wartość jest strumieniem bajtów, który jest interpretowany przez program PowerShell jako [System.Object[]].

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Można przekierować liczbę odczytów lub całkowitą liczbę do tego cmdletu.

Możesz przekierować ścieżki do tego cmdletu za pomocą potoku.

Możesz przekazać poświadczenia do tego polecenia cmdlet.

Jeśli używasz parametru AsByteStream, to polecenie cmdlet zwraca zawartość jako bajty.

Domyślnie to polecenie cmdlet zwraca zawartość jako tablicę ciągów— jedną na wiersz. Gdy używasz parametru Raw, zwraca on pojedynczy ciąg zawierający każdy wiersz w pliku.

Program Windows PowerShell zawiera następujące aliasy dla Get-Content:

• cat
• gc
• type

Polecenie cmdlet Get-Content jest zaprojektowane do pracy z danymi udostępnianymi przez dowolnego providera. Aby uzyskać dostawców w swojej sesji, użyj cmdletu Get-PSProvider. Aby uzyskać więcej informacji, zobacz about_Providers.