Compartilhar via


about_Redirection

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