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

Out-Host

Модуль:
Microsoft.PowerShell.Core Module

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

Синтаксис

All 

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
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Paging

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

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

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

Замечание

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

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

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

PSObject

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

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

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