Write-Output
Envía los objetos especificados al siguiente comando en la canalización. Si es el último comando en la canalización, los objetos se mostrarán en la consola.
Sintaxis
Write-Output [-InputObject] <PSObject[]> [<CommonParameters>]
Descripción
El cmdlet Write-Output envía el objeto especificado al siguiente comando en la canalización. Si es el último comando en la canalización, el objeto se mostrará en la consola.
Write-Output envía los objetos a través de la canalización primaria, también denominada "flujo de salida" o "canalización de salida". Para enviar objetos de error a través de la canalización de errores, utilice Write-Error.
Este cmdlet se suele utilizar en scripts para mostrar cadenas y otros objetos en la consola. Sin embargo, como el comportamiento predeterminado consiste en mostrar los objetos al final de una canalización, normalmente no es necesario usar este cmdlet. Por ejemplo, "Get-Process | write-output" equivale a "Get-Process".
Parámetros
-InputObject <PSObject[]>
Especifica los objetos que se van a enviar a través de la canalización. Especifique la variable que contiene los objetos, o bien, escriba un comando o una expresión que obtenga los objetos.
¿Requerido? |
true |
¿Posición? |
1 |
Valor predeterminado |
|
¿Aceptar canalización? |
true (ByValue) |
¿Aceptar caracteres comodín? |
false |
<CommonParameters>
Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.
Entradas y salidas
El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.
Entradas |
System.Management.Automation.PSObject Puede canalizar objetos a Write-Output. |
Salidas |
System.Management.Automation.PSObject Write-Output devuelve los objetos que se envían como entrada. |
Ejemplo 1
C:\PS>$p = get-process
c:\PS> write-output $p
c:\PS> $p
Descripción
-----------
Estos comandos obtienen objetos que representan los procesos que se ejecutan en el equipo y los muestran en la consola.
Ejemplo 2
C:\PS>write-output "test output" | get-member
Descripción
-----------
Este comando canaliza la cadena "test output" al cmdlet Get-Member, que muestra los miembros de la clase String, lo que pone de manifiesto que la cadena se ha pasado a través de la canalización.
Vea también
Conceptos
Write-Debug
Write-Verbose
Write-Error
Write-Progress
Write-Host
Write-Warning
Tee-Object