Write-Output

Статья
10/30/2009

Отправляет заданные объекты очередной команде в конвейере. Если команда является последней командой в конвейере, объекты отображаются на консоли.

Синтаксис

Write-Output [-InputObject] <PSObject[]> [<CommonParameters>]

Описание

Командлет Write-Output отправляет заданный объект очередной команде в конвейере. Если команда является последней командой в конвейере, то объект отображается на консоли.

Командлет Write-Output передает объекты по основному конвейеру, который также называют "потоком вывода" или "конвейером успешного выполнения". Чтобы передать объекты ошибок по конвейеру ошибок, используйте командлет Write-Error.

Этот командлет обычно используется в скриптах для вывода на консоль строк и других объектов. Но поскольку по умолчанию последние объекты конвейера обычно выводятся на экран, чаще всего необходимость в использовании этого командлета отсутствует. Например, команда "Get-Process | write-output" эквивалентна команде "Get-Process".

Параметры

-InputObject <PSObject[]>

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

Обязательно?	true
Позиция?	1
Значение по умолчанию
Принимать входные данные из конвейера?	true (ByValue)
Принимать подстановочные знаки?	false

<CommonParameters>

Данный командлет поддерживает общие параметры -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_Commonparameters.

Ввод и вывод

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

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

System.Management.Automation.PSObject

Объекты можно передать командлету Write-Output по конвейеру.

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

System.Management.Automation.PSObject

Командлет Write-Output возвращает объекты, переданные ему на вход.

Пример 1

C:\PS>$p = get-process

c:\PS> write-output $p

c:\PS> $p

Описание
-----------
Первая команда получает объекты, которые представляют выполняющиеся на компьютере процессы, и отображает эти объекты на консоли.

Пример 2

C:\PS>write-output "test output" | get-member

Описание
-----------
Эта команда по конвейеру передает строку "test output" командлету Get-Member, который отображает элементы класса String, демонстрируя, что строка была передана по конвейеру.

См. также

Концепции

Write-Debug
Write-Verbose
Write-Error
Write-Progress
Write-Host
Write-Warning
Tee-Object

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