РАЗДЕЛ
about_Redirection
КРАТКОЕ ОПИСАНИЕ
Описывает порядок перенаправления вывода из Windows PowerShell
в текстовые файлы.
ПОЛНОЕ ОПИСАНИЕ
По умолчанию Windows PowerShell передает выходные данные команды
в консоль Windows PowerShell. Однако можно направить вывод в
текстовый файл, а также перенаправить выходную информацию об ошибках
в постоянный выходной поток.
Перенаправление выходных данных можно выполнить следующими способами.
- Использование командлета Out-File, который передает
выходные данные команды в текстовый файл. Как правило,
командлет Out-File применяется, если необходимо использовать
его параметры, такие как Encoding, Force, Width и NoClobber.
- Использование командлета Tee-Object, который выполняет передачу
выходных данных команды в текстовый файл с последующей передачей
этого файла по конвейеру.
- Использование операторов перенаправления Windows PowerShell.
Существуют следующие операторы перенаправления Windows PowerShell.
Оператор Описание Пример
-------- ---------------------- ------------------------------
> Передает выходные данные get-process > process.txt
в указанный файл.
>> Добавляет выходные данные dir *.ps1 >> scripts.txt
к содержимому указанного
файла.
2> Передает информацию об get-process none 2> errors.txt
ошибках в указанный файл.
2>> Добавляет информацию об get-process none 2>> save-errors.txt
ошибках к содержимому
указанного файла.
2>&1 Передает информацию об get-process none, powershell 2>&1
ошибках в выходной поток.
Операторы перенаправления используются со следующим синтаксисом:
<входные_данные> <оператор> [<путь>\]<файл>
Если указанный файл уже существует, операторы перенаправления,
которые не добавляют данные (> и 2>), перезаписывают текущее
содержимое файла без предупреждения. Однако если файл является
доступным только для чтения, скрытым, или системным файлом,
перенаправление выполнить не удастся. Операторы перенаправления
с добавлением (>> и 2>>) не записывают данные в файл,
доступный только для чтения, но добавляют содержимое в
системный или скрытый файл.
Для принудительного перенаправления содержимого в доступный только для
чтения, скрытый или системный файл используйте командлет Out-File с
параметром Force. При записи данных в файлы операторы перенаправления
используют кодировку Юникод. Если файл имеет другую кодировку,
выходные данные могут быть представлены в неверном формате. Для
перенаправления содержимого в файлы, которые имеют кодировку,
отличную от Юникода, используйте командлет Out-File с параметром Encoding.
СМ. ТАКЖЕ
Out-File
Tee-Object
about_Operators
about_Command_Syntax
about_Path_Syntax