Извлекает содержимое элемента, находящегося в заданном местоположении.
Синтаксис
Get-Content [-LiteralPath] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-ReadCount <Int64>] [-TotalCount <Int64>] [-UseTransaction] [<CommonParameters>] Get-Content [-Path] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-ReadCount <Int64>] [-TotalCount <Int64>] [-UseTransaction] [<CommonParameters>]
Описание
Командлет Get-Content возвращает содержимое элемента, находящегося в заданном путем местоположении, например текст из файла. Командлет построчно считывает содержимое и возвращает объект для каждой строки.
Параметры
-Credential <PSCredential>
Задает учетную запись пользователя, который располагает разрешением для выполнения этого действия. По умолчанию используется значение "Текущий пользователь".
Введите имя пользователя, например "User01" или "Domain01\User01", или введите объект PSCredential, например объект, создаваемый командлетом Get-Credential. При вводе имени пользователя система запросит пароль.
Этот параметр не поддерживается ни одним из установленных с Windows PowerShell поставщиков.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
true (ByPropertyName) |
|
Принимать подстановочные знаки? |
false |
-Exclude <string[]>
Исключает указанные элементы. Значение этого параметра определяет значение параметра Path. Введите элемент пути или шаблон, например "*.txt". Подстановочные знаки разрешены.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-Filter <string>
Задает фильтр с использованием формата или языка поставщика. Значение этого параметра определяет значение параметра Path. Синтаксис фильтра, в том числе использование подстановочных знаков, зависит от поставщика. Фильтры эффективнее других параметров, потому что поставщик применяет их при извлечении объектов (вместо использования Windows PowerShell для фильтрации извлеченных объектов).
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-Force
Переопределяет ограничения, препятствующие выполнению команды, не ставя под угрозу безопасность. Например, параметр Force позволяет переопределить атрибут "только чтение" или создать дополнительные каталоги в пути к файлу без изменения разрешений на доступ к файлам.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-Include <string[]>
Извлекает только указанные элементы. Значение этого параметра определяет значение параметра Path. Введите элемент пути или шаблон, например "*.txt". Подстановочные знаки разрешены.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-LiteralPath <string[]>
Задает путь к элементу. В отличие от значения параметра Path, значение параметра LiteralPath используется точно в том виде, в котором оно введено. Никакие символы не интерпретируются как подстановочные знаки. Если путь включает escape-символы, его нужно заключить в одиночные кавычки. Одиночные кавычки указывают оболочке Windows PowerShell, что никакие символы не следует интерпретировать как escape-символы.
|
Обязательно? |
true |
|
Позиция? |
1 |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
true (ByPropertyName) |
|
Принимать подстановочные знаки? |
false |
-Path <string[]>
Specifies the path to an item. Get-Content retrieves the content of the item. Подстановочные знаки разрешены. Имя параметра ("Path" или "FilePath") указывать необязательно.
|
Обязательно? |
true |
|
Позиция? |
1 |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
true (ByPropertyName) |
|
Принимать подстановочные знаки? |
false |
-ReadCount <Int64>
Задает количество строк содержимого, передаваемых по конвейеру за один раз. По умолчанию используется значение 1. Если задать значение 0, все содержимое будет передано за один раз.
Этот параметр не изменяет отображаемое содержимое, но влияет на время его отображения. При увеличении значения параметра ReadCount время, необходимое для возврата первой строки, возрастает, но общее время выполнения операции сокращается. В случае очень больших элементов разница может оказаться довольно значительной.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
true (ByPropertyName) |
|
Принимать подстановочные знаки? |
false |
-TotalCount <Int64>
Задает количество извлекаемых строк содержимого. По умолчанию используется значение -1 (все строки).
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
true (ByPropertyName) |
|
Принимать подстановочные знаки? |
false |
-UseTransaction
Включает команду в активную транзакцию. Этот параметр допустим, только если транзакция выполняется. Дополнительные сведения см. в разделе about_Transactions.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
<CommonParameters>
Данный командлет поддерживает общие параметры -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_Commonparameters.
Ввод и вывод
Входным типом является тип объектов, которые можно передавать командлету по конвейеру. Возвращаемым типом является тип объектов, возвращаемых командлетом.
|
Входные данные |
Нет Данные невозможно передать командлету Get-Content по конвейеру. |
|
Выходные данные |
Object Командлет Get-Content возвращает объекты, представляющие получаемое им содержимое. Тип объекта зависит от типа содержимого. |
Примечания
Командлет Get-Content также можно вызвать с помощью его псевдонимов "cat", "type" и "gc". Дополнительные сведения см. в разделе About_Aliases.
Командлет Get-Content предназначен для работы с данными, предоставляемыми любым поставщиком. Чтобы получить список поставщиков, доступных в текущем сеансе, введите команду "Get-PsProvider". Дополнительные сведения см. в разделе About_Providers.
Пример 1
C:\PS>get-content -Path C:\Chapters\chapter1.txt Описание ----------- Эта команда отображает содержимое файла Chapter1.txt в консоли. Для задания имени элемента используется параметр Path. Командлет Get-Content фактически передает содержимое дальше по конвейеру, однако из-за отсутствия в конвейере других элементов данные форматируются и отображаются на консоли.
Пример 2
C:\PS>get-content c:\Logs\Log060912.txt -totalcount 50 | set-content sample.txt Описание ----------- Эта команда извлекает первые 50 строк файла Log060912.txt и сохраняет их в файле sample.txt. Для извлечения текста из файла в данной команде используется командлет Get-Content. (Имя параметра Path является необязательным и опущено.) Извлечение данных останавливается после считывания первых 50 строк, как задано значением параметра TotalCount. Оператор конвейера (|) пересылает результат командлету Set-Content, который помещает его в файл sample.txt.
Пример 3
C:\PS>(get-content cmdlets.txt -totalcount 5)[-1] Описание ----------- Эта команда получает пятую строку текстового файла Cmdlets.txt. Параметр TotalCount используется для получения первых пяти строк; затем используется индекс массива "-1" для получения результирующего набора.