TÓPICO
about_Redirection
DESCRIÇÃO RESUMIDA
Descreve como redirecionar a saída do Windows PowerShell para
arquivos de texto.
DESCRIÇÃO LONGA
Por padrão, o Windows PowerShell envia sua saída de comando para
o console do Windows PowerShell. Porém, você pode direcionar a
saída para um arquivo de texto e redirecionar a saída de erro
para o fluxo de saída normal.
Você pode usar os seguintes métodos para redirecionar a saída:
- Use o cmdlet Out-File que envia a saída do comando para um
arquivo de texto. Normalmente, você usa o cmdlet Out-File quando
precisa usar seus parâmetros, como Encoding, Force, Width ou NoClobber.
- Use o cmdlet Tee-Object que envia a saída do comando para
um arquivo de texto e depois o envia ao pipeline.
- Use os operadores de redirecionamento do Windows PowerShell.
Os operadores de redirecionamento do Windows PowerShell são
como a seguir.
Operador Descrição Exemplo
-------- ---------------------- ------------------------------
> Envia a saída para o get-process > process.txt
arquivo especificado.
>> Anexa as saídas ao dir *.ps1 >> scripts.txt
conteúdo do arquivo
especificado.
2> Envia erros para o get-process none 2> errors.txt
arquivo especificado.
2>> Anexa os erros ao get-process none 2>> save-errors.txt
conteúdo do arquivo
especificado.
2>&1 Envia erros para o get-process none, powershell 2>&1
fluxo de saída com êxito.
A sintaxe dos operadores de redirecionamento tem o seguinte formato:
<entrada> <operador> [<caminho>\]<arquivo>
Se o arquivo especificado já existir, os operadores de
redirecionamento que não acrescentam dados (> and 2>) substituirão os
conteúdos atuais do arquivo sem avisar. No entanto, se o arquivo for
somente leitura, oculto ou arquivo de sistema, o redirecionamento
falhará. Os operadores de redirecionamento de anexo (>> and 2>>) não
escrevem em um arquivo somente leitura, mas eles acrescentam conteúdo
a um arquivo de sistema ou arquivo oculto.
Para forçar o redirecionamento de conteúdo para um arquivo
somente leitura, oculto ou arquivo do sistema, use o cmdlet
Out-File com seu parâmetro Force. Quando você estiver gravando em
arquivos, os operadores de redirecionamento usarão a codificação
Unicode. Se o arquivo tiver outra codificação, a saída poderá não ser
formatada corretamente. Para redirecionar o conteúdo para arquivos
não-Unicode, use o cmdlet Out-File com seu parâmetro Encoding.
CONSULTE TAMBÉM
Out-File
Tee-Object
about_Operators
about_Command_Syntax
about_Path_Syntax