Compartir a través de

Write-Output

  • Referencia
Módulo:
Microsoft.PowerShell.Utility

Envía los objetos especificados al siguiente comando en la canalización. Si el comando es el último comando en la canalización, los objetos se muestran en la consola.

Syntax

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

Description

El cmdlet Write-Output envía el objeto especificado a la canalización al siguiente comando. Si el comando es el último comando en la canalización, el objeto se muestra en la consola.

Write-Output envía objetos a la canalización principal, también conocido como "flujo de salida" o "canalización correcta". Para enviar objetos de error a la canalización de errores, use Write-Error.

Este cmdlet se usa normalmente en scripts para mostrar cadenas y otros objetos en la consola. Sin embargo, dado que es el comportamiento predeterminado es mostrar los objetos al final de una canalización, generalmente no es necesario usar el cmdlet. Por ejemplo, Get-Process | Write-Output es equivalente a Get-Process.

Ejemplos

Ejemplo 1: Obtener objetos y escribirlos en la consola

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

El primer comando obtiene los procesos que se ejecutan en el equipo y los almacena en la variable $P.

Los comandos segundo y tercero muestran los objetos de proceso en $P en la consola.

Ejemplo 2: Pasar la salida a otro cmdlet

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

Este comando canaliza la cadena "test output" al cmdlet Get-Member, que muestra los miembros de la clase System.String , lo que demuestra que la cadena se pasó a lo largo de la canalización.

Ejemplo 3: Suprimir la enumeración en la salida

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

Count    : 3
...

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

Count    : 1

Este comando agrega el parámetro NoEnumerate para tratar una colección o matriz como un único objeto a través de la canalización.

Parámetros

-InputObject

Especifica los objetos que se van a enviar a través de la canalización. Especifique una variable que contenga los objetos o escriba un comando o una expresión que obtenga los objetos.

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

-NoEnumerate

De forma predeterminada, el cmdlet Write-Output siempre enumera su salida. El parámetro NoEnumerate suprime el comportamiento predeterminado y evita que Write-Output enumere la salida. El parámetro NoEnumerate no tiene ningún efecto en las colecciones creadas mediante el ajuste de comandos entre paréntesis, porque los paréntesis fuerzan la enumeración.

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

Entradas

PSObject

Puede canalizar objetos a Write-Output.

Salidas

PSObject

Write-Output devuelve los objetos que se envían como entrada.