Out-Host

  • Ссылка
Модуль:
Microsoft.PowerShell.Core

Отправляет вывод в командную строку.

Синтаксис

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 , чтобы выйти.

Разбиение по страницам аналогично большей команде.

Примечание.

Параметр разбиения по страницам не поддерживается узлом среды сценариев 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-HostGet-Member сообщает, Get-Member что объекты не были указаны.