Out-Host
Отправляет вывод в командную строку.
Синтаксис
Out-Host
[-Paging]
[-InputObject <PSObject>]
[<CommonParameters>]
Описание
Командлет Out-Host
отправляет выходные данные на узел PowerShell для отображения. Основное приложение отображает вывод в командной строке. Так как Out-Host
является значением по умолчанию, указывать его не нужно, если вы не хотите использовать его параметры.
Out-Host
автоматически добавляется к каждой выполняемой команде. Он передает выходные данные конвейера в узел, выполняющий команду . Out-Host
игнорирует escape-последовательности ANSI. Escape-последовательности обрабатываются узлом. Out-Host
передает escape-последовательности ANSI на узел, не пытаясь интерпретировать или изменять их.
Примеры
Пример 1. Отображение выходных данных по одной странице за раз
В этом примере система обрабатывает по одной странице за раз.
Get-Process | Out-Host -Paging
NPM(K) PM(M) WS(M) CPU(s) Id SI ProcessName
------ ----- ----- ------ -- -- -----------
30 24.12 36.95 15.86 21004 14 ApplicationFrameHost
55 24.33 60.48 10.80 12904 14 BCompare
<SPACE> next page; <CR> next line; Q quit
9 4.71 8.94 0.00 16864 14 explorer
<SPACE> next page; <CR> next line; Q quit
Get-Process
получает системные процессы и отправляет объекты по конвейеру. Out-Host
использует параметр разбиения на страницы для отображения одной страницы данных за раз.
Пример 2. Использование переменной в качестве входных данных
В этом примере в качестве входных данных для Out-Host
используются объекты, хранящиеся в переменной .
$io = Get-History
Out-Host -InputObject $io
Get-History
получает журнал сеанса PowerShell и сохраняет объекты в переменной $io
.
Out-Host
использует параметр InputObject для указания переменной $io
и отображает журнал.
Параметры
-InputObject
Задает объекты, которые будут выведены на консоль. Введите переменную, которая содержит объекты, или команду или выражение, которое возвращает объекты.
Type: | PSObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Paging
Указывает, что Out-Host
отображает одну страницу выходных данных одновременно и ожидает ввода пользователем, прежде чем будут отображены остальные страницы. По умолчанию все выходные данные отображаются на одной странице. Размер страницы определяется характеристиками основного приложения.
Нажмите клавишу ПРОБЕЛ , чтобы отобразить следующую страницу выходных данных, или клавишу ВВОД , чтобы просмотреть следующую строку выходных данных. Нажмите клавишу Q , чтобы завершить работу.
Разбиение по страницам аналогично команде more .
Примечание
Параметр разбиения по страницам не поддерживается узлом интегрированной среды сценариев PowerShell.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Входные данные
Вы можете передать любой объект в этот командлет.
Выходные данные
None
Этот командлет не возвращает выходные данные. Он отправляет объекты на узел для отображения.
Примечания
PowerShell включает следующие псевдонимы для Out-Host
:
- Для всех платформ.
oh
Параметр разбиения по страницам поддерживается не всеми узлами PowerShell. Например, при использовании параметра разбиения по страницам в интегрированной среде сценариев PowerShell отображается следующая ошибка: out-lineoutput : The method or operation is not implemented.
Командлеты, содержащие команду Out , Out-
не форматировать объекты. Они отрисовывают объекты и отправляют их в указанное место назначения отображения. Если вы отправляете неформатированные объекты командлету Out-
, командлет отправляет его командлету форматирования перед отрисовкой.
Командлеты Out-
не имеют параметров для имен или путей к файлам. Чтобы отправить данные в Out-
командлет, используйте конвейер для отправки выходных данных команды PowerShell командлету . Кроме того, можно сохранить данные в переменной и использовать параметр InputObject для передачи данных командлету .
Out-Host
отправляет данные, но не создает выходные объекты. При конвейере выходных Out-Host
данных в Get-Member
командлет сообщает, Get-Member
что объекты не указаны.