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

Out-Default

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

Отправляет выходные данные в форматировщик по умолчанию и в командлет выходных данных по умолчанию.

Синтаксис

Out-Default
   [-Transcript]
   [-InputObject <PSObject>]
   [<CommonParameters>]

Описание

PowerShell автоматически добавляет Out-Default в конец каждого конвейера. Out-Default решает, как форматировать и выводить поток объектов. Если поток объектов представляет собой поток строк, Out-Default напрямую передаёт их в Out-Host, вызывая соответствующие API, предоставляемые хостом. Если поток объектов не содержит строк, Out-Default проверяет объект, чтобы определить, что делать. Сначала программа анализирует тип объекта и определяет, существует ли зарегистрированное представление для этого типа объекта.

PowerShell определяет схему XML и механизм (командлет Update-FormatData), где любой пользователь может регистрировать представления для типа объекта. Можно указать широкое, список, таблицуили пользовательские представления для любого типа объекта. Представления указывают, какие свойства должны отображаться и как они должны отображаться. Если представление зарегистрировано, он определяет, какой форматировщик следует использовать. Если зарегистрированное представление является таблицей представления, Out-Default передает объекты в Format-Table | Out-Host. Format-Table преобразует объекты в поток записей форматирования (на основе данных в определении представления) и Out-Host преобразует записи форматирования в вызовы интерфейса Хост.

Этот командлет не предназначен для использования конечным пользователем. Другие командлеты рекомендуется управлять выходными данными, такими как out-Host или использовать командлеты Format-* и файл Format.ps1xml для управления форматированием.

Примеры

Пример 1

Хотя этот командлет не предназначен для запуска непосредственно конечным пользователем, он все-таки может быть запущен.

Get-Process | Select-Object -First 5 | Out-Default

NPM(K)    PM(M)      WS(M)     CPU(s)      Id  SI ProcessName
 ------    -----      -----     ------      --  -- -----------
     12     2.56       5.20       0.00    7376   0 aesm_service
     48    34.32      18.10      26.64    9320  13 AlertusDesktopAlert
     24    13.97      12.74       0.77   12656  13 ApplicationFrameHost
      8     1.79       4.41       0.00    8180   0 AppVShNotify
      9     1.99       5.07       0.19   19320  13 AppVShNotify

Ошибка не возникает при использовании Out-Default, но результат не изменится, если его не вызвать явно.

Параметры

-InputObject

Командлет принимает входные данные.

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

-Transcript

Определяет, следует ли отправлять выходные данные службам транскрибирования PowerShell.

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