Get-Content

Ссылка

Модуль:: Microsoft.PowerShell.Management

Возвращает содержимое элемента в указанном расположении.

Синтаксис

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

Описание

Командлет 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 использует параметр пути для указания файла 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

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

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

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

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

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

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

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

Параметры

-Credential

Заметка

Этот параметр не поддерживается поставщиками, установленными с помощью PowerShell. Чтобы олицетворить другого пользователя или повысить свои учетные данные при выполнении этого командлета, используйте Invoke-Command.

Тип:	PSCredential
Position:	Named
Default value:	Current user
Обязательно:	False
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-Delimiter

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

Этот параметр можно использовать для разделения большого файла на небольшие файлы, указав разделитель файлов в качестве разделителя. Разделитель сохраняется (не удаляется) и становится последним элементом в каждом разделе файла.

разделителя — это динамический параметр, который поставщик файловой системы добавляет в командлет Get-Content. Этот параметр работает только на дисках файловой системы.

Заметка

В настоящее время, когда значение параметра разделителя является пустой строкой, Get-Content ничего не возвращает. Это известная проблема. Чтобы принудительно Get-Content возвращать весь файл как одну, неустранимую строку. Введите значение, которое не существует в файле.

Тип:	String
Position:	Named
Default value:	End-of-line character
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Encoding

Указывает тип кодирования для целевого файла. Значение по умолчанию — Default.

Допустимые значения для этого параметра приведены следующим образом:

Ascii использует набор символов ASCII (7-разрядный).
BigEndianUnicode использует UTF-16 с порядком байтов большого плана.
BigEndianUTF32 использует UTF-32 с порядком байтов больших байтов.
Byte кодирует набор символов в последовательность байтов.
Default Использует кодировку, соответствующую активной кодовой странице системы (обычно ANSI).
Oem Использует кодировку, соответствующую текущей кодовой странице OEM системы.
String То же, что и Unicode.
Unicode использует UTF-16 с маленьким порядком байтов.
Unknown То же, что и Unicode.
UTF7 использует UTF-7.
UTF8 использует UTF-8.
UTF32 использует UTF-32 с маленьким порядком байтов.

Кодировка — это динамический параметр, который поставщик файловой системы добавляет в командлет Get-Content. Этот параметр работает только на дисках файловой системы.

При чтении и записи в двоичные файлы используйте значение Byte для динамического параметра кодировки и значение 0 для параметра ReadCount. Значение readCount 0 считывает весь файл в одной операции чтения и преобразует его в один объект (PSObject). Значение по умолчанию ReadCount, 1, считывает один байт в каждой операции чтения и преобразует каждый байт в отдельный объект, что приводит к ошибкам при использовании командлета Set-Content для записи байтов в файл.

Тип:	FileSystemCmdletProviderEncoding
Допустимые значения:	ASCII, BigEndianUnicode, BigEndianUTF32, Byte, Default, OEM, String, Unicode, Unknown, UTF7, UTF8, UTF32
Position:	Named
Default value:	Default
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Exclude

Указывает как строковый массив, элемент или элементы, которые этот командлет исключает в операции. Значение этого параметра квалифифициирует параметр Path.

Введите элемент пути или шаблон, например *.txt. Разрешены подстановочные знаки.

Параметр Исключить действует только в том случае, если команда включает содержимое элемента, например C:\Windows\*, где подстановочный знак указывает содержимое каталога C:\Windows.

Тип:	String[]
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	True

-Filter

Указывает фильтр для квалификации параметра Path. Поставщик файловой системы является единственным установленным поставщиком PowerShell, поддерживающим использование фильтров. Синтаксис для языка фильтрации файловой системы можно найти в about_Wildcards. Фильтры более эффективны, чем другие параметры, так как поставщик применяет их, когда командлет получает объекты, а не фильтрует объекты после их получения.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	True

-Force

Force может переопределить атрибут только для чтения или создать каталоги для завершения пути к файлу. Параметр Force не пытается изменить разрешения файла или переопределить ограничения безопасности.

Тип:	SwitchParameter
Position:	Named
Default value:	False
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Include

Указывает, как строковый массив, элемент или элементы, которые этот командлет включает в операцию. Значение этого параметра квалифифициирует параметр Path. Введите элемент пути или шаблон, например "*.txt". Разрешены подстановочные знаки. Параметр Include действует только в том случае, если команда включает содержимое элемента, например C:\Windows\*, где подстановочный знак указывает содержимое каталога C:\Windows.

Тип:	String[]
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	True

-LiteralPath

Указывает путь к одному или нескольким расположениям. Значение LiteralPath используется точно так же, как и типизированный. Символы не интерпретируются как подстановочные знаки. Если путь содержит escape-символы, заключите его в одинарные кавычки. Одинарные кавычки говорят PowerShell не интерпретировать какие-либо символы как escape-последовательности.

Дополнительные сведения см. в about_Quoting_Rules.

Тип:	String[]
Aliases:	PSPath
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-Path

Указывает путь к элементу, в котором Get-Content получает содержимое. Разрешены подстановочные знаки. Пути должны быть путями к элементам, а не к контейнерам. Например, необходимо указать путь к одному или нескольким файлам, а не к каталогу.

Тип:	String[]
Position:	0
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	True

-Raw

Игнорирует символы новой строки и возвращает все содержимое файла в одной строке с сохраненными новыми строками. По умолчанию новые символы в файле используются в качестве разделителей для разделения входных данных в массив строк. Этот параметр появился в PowerShell 3.0.

Необработанные — это динамический параметр, который поставщик FileSystem добавляет в командлет Get-Content Этот параметр работает только на дисках файловой системы.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ReadCount

Указывает, сколько строк содержимого отправляется через конвейер за раз. Значение по умолчанию — 1. Значение 0 (ноль) или отрицательные числа одновременно отправляет все содержимое.

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

Тип:	Int64
Position:	Named
Default value:	1
Обязательно:	False
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-Stream

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

Stream — это динамический параметр, который поставщик fileSystem добавляет в командлет Get-Content. Этот параметр работает только на дисках файловой системы в системах Windows.

Этот параметр появился в Windows PowerShell 3.0.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Tail

Указывает количество строк из конца файла или другого элемента. Можно использовать имя параметра tail или его псевдоним, Last. Отрицательные значения вызывают возврат всего содержимого командлета.

Этот параметр появился в PowerShell 3.0.

Тип:	Int32
Aliases:	Last
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-TotalCount

Указывает количество строк с начала файла или другого элемента. Отрицательные значения вызывают возврат всего содержимого командлета.

Вы можете использовать имя параметра TotalCount или его псевдонимы, First или Head.

Тип:	Int64
Aliases:	First, Head
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-UseTransaction

Включает команду в активную транзакцию. Этот параметр действителен только в том случае, если выполняется транзакция. Дополнительные сведения см. в about_Transactions.

Тип:	SwitchParameter
Aliases:	usetx
Position:	Named
Default value:	False
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Wait

Вызывает ожидание командлета на неопределенный срок, сохраняя файл открытым до прерывания. Во время ожидания Get-Content проверяет файл один раз в секунду и выводит новые строки при наличии. При использовании с параметром TotalCountGet-Content ожидается, пока указанное количество строк не будет доступно в указанном файле. Например, если указать TotalCount 10, а файл уже имеет 10 или более строк, Get-Content возвращает 10 строк и завершает работу. Если файл имеет менее 10 строк, Get-Content выводит каждую строку по мере поступления, но ожидает, пока десятая строка не появится перед выходом.

Вы можете прерывать ожидание, нажав клавиши CTRL +C. При удалении файла возникает несрочная ошибка, которая также прерывает ожидание.

ожидание — это динамический параметр, который поставщик FileSystem добавляет в командлет Get-Content. Этот параметр работает только на дисках файловой системы. ожидания нельзя объединить с необработанных.

Тип:	SwitchParameter
Position:	Named
Default value:	False
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

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

Int64

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

String[]

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

PSCredential

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

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

Byte

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

String

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

Примечания

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

cat
gc
type

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

Поделиться через

Get-Content

Синтаксис

Описание

Примеры

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

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

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

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

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

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

Пример 7. Использование фильтров с Get-Content

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

Параметры

-Credential

-Delimiter

-Encoding

-Exclude

-Filter

-Force

-Include

-LiteralPath

-Path

-Raw

-ReadCount

-Stream

-Tail

-TotalCount

-UseTransaction

-Wait

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

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

Примечания

Дополнительные ресурсы

Поделиться через

Get-Content

Синтаксис

Описание

Примеры

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

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

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

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

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

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

Пример 7. Использование фильтров с Get-Content

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

Параметры

-Credential

-Delimiter

-Encoding

-Exclude

-Filter

-Force

-Include

-LiteralPath

-Path

-Raw

-ReadCount

-Stream

-Tail

-TotalCount

-UseTransaction

-Wait

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

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

Примечания

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

Дополнительные ресурсы