Write-Output
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
Puede canalizar objetos a Write-Output.
Salidas
Write-Output devuelve los objetos que se envían como entrada.