Tee-Object

Artigo
10/30/2009

Salva a saída do comando em um arquivo ou uma variável e a exibe no console.

Sintaxe

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

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

Descrição

O cmdlet Tee-Object envia a saída de um comando em duas direções (como a letra "T"). Ele armazena a saída em um arquivo ou uma variável e também a envia para o pipeline. Se o Tee-Object for o último comando no pipeline, a saída do comando será exibida no console.

Parâmetros

-FilePath <string>

Especifica um arquivo no qual o cmdlet armazena o objeto. Aceita caracteres curinga que resultam em um único arquivo.

Necessário?	true
Posição?	1
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-InputObject <psobject>

Especifica a entrada do objeto para o cmdlet. Insira uma variável que contenha os objetos ou digite um comando ou expressão que obtenha os objetos.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	true (ByValue)
Aceitar caracteres curinga?	false

-Variable <string>

Atribui uma referência aos objetos de entrada para a variável especificada.

Necessário?	true
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

<CommonParameters>

Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.

Entradas e saídas

O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.

Entradas

System.Management.Automation.PSObject

Você pode canalizar objetos a serem redirecionados para Tee-Object.

Saídas

System.Management.Automation.PSObject

Tee-Object retorna o objeto que foi redirecionado.

Observações

Também é possível usar o operador de redirecionamento ou o cmdlet Out-File, que salva a saída em um arquivo, mas não a envia para o pipeline.

O Tee-Object usa codificação Unicode ao gravar em arquivos. Como resultado, a saída talvez não seja formatada corretamente em arquivos com uma codificação diferente. Para especificar a codificação, use o cmdlet Out-File.

Exemplo 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
...

Descrição
-----------
Este comando obtém uma lista dos processos em execução no computador e envia o resultado a um arquivo. Como não há um segundo caminho especificado, o resultado será exibido no console.

Exemplo 2

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

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

Descrição
-----------
Esse comando obtém uma lista dos processos em execução no computador e envia o resultado para uma variável "proc". Em seguida, ele canaliza os objetos resultantes para Select-Object, o qual seleciona as propriedades ProcessName e Handles. Observe que a variável $proc inclui as informações padrão retornadas por Get-Process.

Consulte também

Conceitos

about_Redirection
Select-Object

Compartilhar via