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 quitGet-Process возвращает системные процессы и отправляет объекты по конвейеру. Out-Host использует параметр разбиения по страницам для отображения одной страницы данных за раз.
Пример 2. Использование переменной в качестве входных данных
В этом примере объекты, хранящиеся в переменной, используются в качестве входных данных для Out-Host.
$io = Get-History
Out-Host -InputObject $ioGet-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 , чтобы выйти.
Разбиение по страницаманалогично большей команде.
Примечание
Параметр разбиения по страницам не поддерживается узлом isE PowerShell.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Входные данные
Объекты можно отправлять по конвейеру Out-Host.
Выходные данные
None
Out-Host не создает выходные данные. Он отправляет объекты на узел для отображения.
Примечания
Параметр разбиения по страницам не поддерживается всеми узлами PowerShell. Например, если вы используете параметр разбиения по страницам в isE PowerShell, отображается следующая ошибка: out-lineoutput : The method or operation is not implemented.
Командлеты, содержащие команду Out , Out-не форматируйте объекты. Они отрисовывают объекты и отправляют их в указанное место назначения отображения. При отправке неформатированного объекта Out- командлету командлет отправляет его командлету форматирования перед отрисовкой.
Командлеты Out- не имеют параметров для имен или путей к файлам. Чтобы отправить данные в командлет, используйте конвейер для отправки выходных данных Out- команды PowerShell в командлет. Кроме того, можно хранить данные в переменной и использовать параметр InputObject для передачи данных командлету.
Out-Host отправляет данные, но не создает выходные объекты. При конвейере выходных данных командлета Out-HostGet-Member сообщает, Get-Member что объекты не указаны.