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

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

Указывает объекты, записанные в консоль. Введите переменную, содержащую объекты, или введите команду или выражение, которое получает объекты.

Тип:PSObject
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Paging

Указывает, что Out-Host отображается одна страница выходных данных одновременно. Размер страницы определяется характеристиками узла.

После вывода первой страницы команда ожидает ввода пользователем до отображения оставшихся страниц. Нажмите пробел , чтобы отобразить следующую страницу выходных данных или клавишу ВВОД , чтобы просмотреть следующую строку выходных данных. Нажмите Q, чтобы выйти.

Использование разбиения по страницам аналогично использованию большей команды.

Заметка

Параметр по страницам не поддерживается узлом среды сценариев PowerShell.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

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

PSObject

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

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

None

Этот командлет не возвращает выходные данные. Он отправляет объекты на узел для отображения.

Примечания

PowerShell включает следующие псевдонимы для Out-Host:

  • Все платформы:
    • oh

Не все узлы PowerShell поддерживают параметр разбиения по страницам . Например, если вы используете параметр разбиения по страницам в среде сценариев Windows PowerShell, отображается следующая ошибка:

out-lineoutput: метод или операция не реализованы.

Командлеты, содержащие команду Out, Out-, не форматировать объекты. Они отрисовывают объекты и отправляют их в указанное назначение отображения. Если вы отправляете неформатируемый объект в командлет Out-, командлет отправляет его командлету форматирования перед отрисовкой.

Командлеты Out- не считывают входные данные из файлов. Чтобы отправить данные командлету Out- , используйте конвейер для отправки данных командлету. Кроме того, можно хранить данные в переменной и использовать параметр InputObject для передачи данных командлету.

Out-Host отправляет данные только на узел. Tt не создает выходные объекты в конвейере. Если вы передаете выходные данные Out-Host командлету Get-Member, Get-Member сообщает, что объекты не были указаны.