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.
Sintaxis
Descripción
El cmdlet Write-Output 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 el canal principal, también conocido como «flujo de salida» o «canal 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 es echo y es 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 donde la salida se muestra de forma predeterminada. Por ejemplo, Get-Process | Write-Output es equivalente a Get-Process. O echo "Home directory: $HOME" puede escribirse "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
El primer comando hace que los procesos se ejecuten en la computadora y los almacena en $P variable.
El segundo y tercer comando muestran los objetos de proceso en $P en la consola.
Ejemplo 2: Pasar salida a otro cmdlet
Este comando canaliza la cadena de «salida de prueba» al cmdlet Get-Member, que muestra el 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
Este comando agrega el parámetro NoEnumerate para tratar una colección o matriz como un solo objeto a través de la canalización.
Parámetros
Especifica los objetos que se enviarán por la canalización. Ingrese una variable que contenga los objetos, o escriba un comando o expresión que obtenga los objetos.
| Escriba: | PSObject |
| Posición: | 0 |
| Valor predeterminado: | Ninguno |
| Aceptar entrada de canalización: | Verdadero |
| Aceptar caracteres comodín: | Falso |
De forma predeterminada, el Write-Output cmdlet 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á entre paréntesis, porque los paréntesis fuerzan la enumeración. Por ejemplo, (Write-Output 1,2,3) aún 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 todavía se enumera incluso con el uso de este modificador.
| Tipo: | SwitchParameter |
| Posición: | Con nombre |
| Valor predeterminado: | Ninguno |
| Aceptar entrada de canalización: | Falso |
| Aceptar caracteres comodín: | Falso |
Entradas
PSObject
Puede canalizar objetos a Write-Output.
Salidas
PSObject
Write-Output devuelve los objetos que se envían como entrada.
- about_Output_Streams
- about_Redirection
- Tee-Object
- Write-Debug
- Write-Error
- Write-Host
- Write-Information
- Write-Progress
- Write-Verbose
- Advertencia por escrito