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


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

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

PSObject

Вы можете передать любой объект в этот командлет.

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

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 что объекты не указаны.