Tee-Object

Guarda el resultado de un comando en un archivo o una variable y lo muestra en la consola.

Sintaxis

Tee-Object [-FilePath] <string> [-InputObject <psobject>] [<CommonParameters>]

Tee-Object -Variable <string> [-InputObject <psobject>] [<CommonParameters>]

Descripción

El cmdlet Tee-Object envía el resultado de un comando en dos direcciones (como la letra "T"). Lo almacena en un archivo o una variable y también lo envía a través de la canalización. Si Tee-Object es el último comando en la canalización, el resultado del comando se muestra en la consola.

Parámetros

-FilePath <string>

Especifica el archivo en el que el cmdlet almacena el objeto. Se permite el uso de caracteres comodín siempre y cuando den lugar a un único archivo.

¿Requerido?

true

¿Posición?

1

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-InputObject <psobject>

Especifica la entrada de objetos para el cmdlet. Especifique la variable que contiene los objetos o escriba un comando o una expresión que los obtenga.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

true (ByValue)

¿Aceptar caracteres comodín?

false

-Variable <string>

Asigna a la variable especificada una referencia de los objetos de entrada.

¿Requerido?

true

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿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 los objetos que se van a redirigir a Tee-Object.

Salidas

System.Management.Automation.PSObject

Tee-Object devuelve el objeto que redirigió.

Notas

También puede utilizar el cmdlet Out-File o el operador de redirección, que guardan el resultado en un archivo pero no lo envían a través de la canalización.

Tee-Object utiliza la codificación Unicode al escribir en archivos. Por consiguiente, puede que el resultado no tenga un formato correcto en los archivos con otra codificación. Para especificar la codificación, utilice el cmdlet Out-File.

Ejemplo 1

C:\PS>get-process | tee-object -filepath C:\Test1\testfile2.txt 

Handles  NPM(K)    PM(K)      WS(K) VM(M)   CPU(s)    Id ProcessName
-------  ------    -----      ----- -----   ------    -- -----------
   83       4     2300       4520    39     0.30    4032 00THotkey
  272       6     1400       3944    34     0.06    3088 alg
   81       3      804       3284    21     2.45     148 ApntEx
   81       4     2008       5808    38     0.75    3684 Apoint
...

Descripción
-----------
Este comando obtiene una lista con los procesos que se ejecutan en el equipo y envía el resultado a un archivo. Dado que no se especifica una segunda ruta, el resultado se mostrará en la consola.





Ejemplo 2

C:\PS>get-process notepad | tee-object -variable proc | select-object processname,handles 

ProcessName                              Handles
-----------                              -------
notepad                                  43
notepad                                  37
notepad                                  38
notepad                                  38

Descripción
-----------
Este comando obtiene una lista de los procesos que se ejecutan en el equipo y envía el resultado a una variable denominada "proc". A continuación, canaliza los objetos resultantes a Select-Object, que selecciona las propiedades ProcessName y Handles. Tenga en cuenta que la variable $proc contiene la información predeterminada devuelta por Get-Process.





Vea también

Conceptos

about_Redirection
Select-Object