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 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 a través de 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.
Sin embargo, dado que 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 hace que los procesos se ejecuten en el equipo y los almacena en la variable $P.
El segundo y el tercer comando 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 de "salida de prueba" 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 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 e impide que Write-Output enumere la salida. El parámetro NoEnumerate no tiene ningún efecto en las colecciones que se crearon encapsulando comandos entre paréntesis, ya que los paréntesis fuerzan la enumeración.
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.