Write-Output
Envía los objetos especificados al siguiente comando de la canalización. Si el comando es el último comando de la canalización, los objetos se muestran en la consola.
Sintaxis
Default (valor predeterminado)
Write-Output
[-InputObject] <PSObject[]>
[-NoEnumerate]
[<CommonParameters>]
Description
El Write-Output cmdlet envía el objeto especificado por la canalización al siguiente comando.
Si el comando es el último comando de la canalización, el objeto se muestra en la consola.
Write-Output Envía objetos por la canalización principal, también conocida como "flujo de salida" o "canalización de éxito". Para enviar objetos de error por la canalización de errores, use Write-Error.
Este cmdlet se usa normalmente en scripts para mostrar cadenas y otros objetos en la consola. Uno de los alias integrados para Write-Output is echo y similar a otros shells que usan echo, el comportamiento predeterminado es mostrar la salida al final de una canalización. En PowerShell, generalmente no es necesario usar el cmdlet en instancias en las que se muestra la salida de forma predeterminada. Por ejemplo, Get-Process | Write-Output equivale a Get-Process. O, echo "Home directory: $HOME" se puede escribir, "Home directory: $HOME".
De forma predeterminada, Write-Output enumera las colecciones proporcionadas al cmdlet. Sin embargo, Write-Output también se puede usar para pasar colecciones por la canalización como un solo objeto con el parámetro NoEnumerate .
Ejemplos
Ejemplo 1: Obtener objetos y escribirlos en la consola
$P = Get-Process
Write-Output $P
El primer comando hace que los procesos se ejecuten en la computadora y los almacena en la $P variable.
El segundo y tercer comando muestran los objetos de proceso en $P la consola.
Ejemplo 2: Pasar la salida a otro cmdlet
Write-Output "test output" | Get-Member
Este comando canaliza la cadena "test output" a la Get-Member cmdlet, que muestra los miembros de la clase System.String , demostrando que la cadena se pasó a lo largo de la canalización.
Ejemplo 3: Suprimir la enumeración en la salida
Write-Output 1,2,3 | Measure-Object
Count : 3
...
Write-Output 1,2,3 -NoEnumerate | Measure-Object
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 tubería.
Parámetros
-InputObject
Especifica los objetos que se van a enviar a la canalización. Escriba una variable que contenga los objetos, o escriba un comando o expresión que obtenga los objetos.
Propiedades de parámetro
| Tipo: | PSObject[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 0 |
| Obligatorio: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | 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 si el comando está encapsulado entre paréntesis, porque los paréntesis fuerzan la enumeración. Por ejemplo, (Write-Output 1,2,3) todavía enumera la matriz.
Nota:
Este modificador solo funciona correctamente con PowerShell Core 6.2 y versiones posteriores. En versiones anteriores de PowerShell Core, la colección se sigue enumerando incluso con el uso de este modificador.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.
Entradas
PSObject
Puede canalizar objetos a Write-Output.
Salidas
PSObject
Write-Output Devuelve los objetos que se envían como entrada.