Get-Content

Синтаксис

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

Описание

Командлет Get-Content получает содержимое элемента в расположении, указанном путем, например текст в файле или содержимом функции. Для файлов содержимое считывается по одной строке и возвращает коллекцию объектов, каждая из которых представляет строку содержимого.

Начиная с PowerShell 3.0, Get-Content можно также получить указанное количество строк с начала или конца элемента.

Примеры

Пример 1. Получение содержимого текстового файла

В этом примере возвращается содержимое файла в текущем каталоге. Файл LineNumbers.txt имеет 100 строк в формате, это Строка X и используется в нескольких примерах.

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.

Значения массива 1–100 отправляются по конвейеру командлету ForEach-Object . ForEach-Object использует блок скрипта с командлетом Add-Content для создания LineNumbers.txt файла. Переменная $_ представляет значения массива, так как каждый объект отправляется по конвейеру. Командлет Get-Content использует параметр Path для указания LineNumbers.txt файла и отображения содержимого в консоли PowerShell.

Пример 2. Ограничение количества строк Get-Content возвращает

Эта команда получает первые пять строк файла. Параметр TotalCount получает первые пять строк содержимого. В этом примере используется LineNumbers.txt ссылка в примере 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

Пример 3. Получение определенной строки содержимого из текстового файла

Эта команда получает определенное количество строк из файла, а затем отображает только последнюю строку этого содержимого. Параметр TotalCount получает первые 25 строк содержимого. В этом примере используется файл, на который ссылается LineNumbers.txt пример 1.

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

This is Line 25

Команда Get-Content упаковывается в скобки, чтобы команда завершилась перед переходом к следующему шагу. Get-Contentвозвращает массив строк, это позволяет добавить нотацию индекса после скобок для получения определенного номера строки. В этом случае [-1] индекс указывает последний индекс в возвращаемом массиве из 25 полученных строк.

Пример 4. Получение последней строки текстового файла

Эта команда получает последнюю строку содержимого из файла. В этом примере используется LineNumbers.txt файл, созданный в примере 1.

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

This is Line 100

В этом примере используется Get-Item командлет для демонстрации передачи файлов Get-Contentв . Параметр Tail получает последнюю строку файла. Этот метод быстрее, чем получение всех строк в переменной и использование [-1] нотации индекса.

Пример 5. Получение содержимого альтернативного потока данных

В этом примере описывается, как использовать параметр Stream для получения содержимого альтернативного потока данных для файлов, хранящихся в томе WINDOWS NTFS. В этом примере Set-Content командлет используется для создания примера содержимого в файле с именем 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 — это динамический параметр поставщика FileSystem. По умолчанию Get-Content извлекает данные только из стандартного или :$DATA потокового потока. Потоки можно использовать для хранения скрытых данных, таких как атрибуты , параметры безопасности или другие данные. Они также могут храниться в каталогах без дочерних элементов.

Пример 6. Получение необработанного содержимого

Команды в этом примере получают содержимое файла как одну строку вместо массива строк. По умолчанию без динамического параметра Raw содержимое возвращается в виде массива строк с разделителями новой строки. В этом примере используется файл, на который ссылается LineNumbers.txt пример 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.

Пример 7. Использование фильтров с получением содержимого

Для командлета Get-Content можно указать фильтр. При использовании фильтров для квалификации параметра Path необходимо включить конечную звездочку (*), чтобы указать содержимое пути.

Следующая команда получает содержимое всех *.log файлов в каталоге C:\Temp .

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

Пример 8. Получение содержимого файла в виде массива байтов

В этом примере показано, как получить содержимое файла в виде [byte[]] одного объекта.

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

Первая команда использует параметр AsByteStream для получения потока байтов из файла. Необработанный параметр гарантирует, что байты возвращаются в виде[System.Byte[]]. Если необработанный параметр отсутствует, возвращаемое значение представляет собой поток байтов, который интерпретируется PowerShell как [System.Object[]].

Параметры

-AsByteStream

-Credential

-Delimiter

-Encoding

-Exclude

-Filter

-Force

-Include

-LiteralPath

-Path

-Raw

-ReadCount

-Stream

-Tail

-TotalCount

-Wait

Входные данные

Int64

Вы можете передать количество или общее количество операций чтения в этот командлет.

String[]

Пути к этому командлету можно передать.

PSCredential

Вы можете передать учетные данные в этот командлет.

Выходные данные

Byte

При использовании параметра AsByteStream этот командлет возвращает содержимое в виде байтов.

String

По умолчанию этот командлет возвращает содержимое в виде массива строк, по одному на строку. При использовании необработанного параметра возвращается одна строка, содержащая каждую строку в файле.

Примечания

PowerShell включает следующие псевдонимы для Get-Content:

• Все платформы:
  • gc
  • type
• Windows:
  • cat

Командлет Get-Content предназначен для работы с данными, предоставляемыми любым поставщиком. Чтобы получить поставщиков в сеансе Get-PSProvider , используйте командлет. Дополнительные сведения см. в about_Providers.

Связанные ссылки

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