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

Write-Output

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

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

Синтаксис

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

Описание

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

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

Этот командлет обычно используется в сценариях для отображения строк и других объектов в консоли. Тем не менее, поскольку поведение по умолчанию — отображение объектов в конце конвейера, как правило, нет необходимости использовать командлет. Например, Get-Process | Write-Output эквивалентно Get-Process.

Примеры

Пример 1. Получение объектов и запись их в консоль

PS C:\> $P = Get-Process
PS C:\> Write-Output $P
PS C:\> $P

Первая команда получает процессы, запущенные на компьютере, и сохраняет их в переменной $P.

Вторая и третья команды отображают объекты процесса в $P консоли.

Пример 2. Передача выходных данных в другой командлет

PS C:\> Write-Output "test output" | Get-Member

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

Пример 3. Подавление перечисления в выходных данных

PS C:\> Write-Output @(1,2,3) | measure

Count    : 3
...

PS C:\> Write-Output @(1,2,3) -NoEnumerate | measure

Count    : 1

Эта команда добавляет параметр NoEnumerate для обработки коллекции или массива как одного объекта через конвейер.

Параметры

-InputObject

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

Type:PSObject[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-NoEnumerate

По умолчанию командлет Write-Output всегда перечисляет свои выходные данные. Параметр NoEnumerate подавляет поведение по умолчанию и запрещает перечисление выходных данных write-output . Параметр NoEnumerate не влияет на коллекции, созданные путем упаковки команд в круглые скобки, поскольку круглые скобки принудительное перечисление.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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

PSObject

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

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

PSObject

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