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