Поделиться через

about_Redirection

Назначение: Windows PowerShell 2.0, Windows PowerShell 3.0

РАЗДЕЛ

about_Redirection

КРАТКОЕ ОПИСАНИЕ

Сведения о том, как перенаправлять выходные данные Windows PowerShell® в текстовые файлы.

ПОДРОБНОЕ ОПИСАНИЕ

По умолчанию Windows PowerShell отправляет выходные данные команд в консоль Windows PowerShell. Тем не менее вы можете направить выходные данные в текстовый файл, а данные об ошибках — в обычный поток выходных данных.

Перенаправлять выходные данные можно следующими способами:

  • - с помощью командлета Out-File, который отправляет выходные данные команд в текстовый файл. Как правило, командлет Out-File используется, если необходимо применить его параметры, например Encoding, Force, Width или NoClobber;

  • - с помощью командлета Tee-Object, который отправляет выходные данных в текстовый файл, а затем — в конвейер;

  • - с помощью операторов перенаправления Windows PowerShell.

ОПЕРАТОРЫ ПЕРЕНАПРАВЛЕНИЯ WINDOWS POWERSHELL

Операторы перенаправления позволяют отправлять выходные данные определенных типов в файлы и выходной поток успешных команд.

Операторы перенаправления Windows PowerShell представляют типы выходных данных следующими символами:

        *   All output
        1   Success output
        2   Errors
        3   Warning messages
        4   Verbose output
        5   Debug messages

ПРИМЕЧАНИЕ. Операторы перенаправления All (*), Warning (3), Verbose (4) и Debug (5) появились в Windows PowerShell 3.0. Они не работают в более ранних версиях Windows PowerShell.

Ниже представлены операторы перенаправления Windows PowerShell.

      Operator  Description                Example  
      --------  ----------------------     ------------------------------
      >         Sends output to the        Get-Process > Process.txt
                specified file.

      >>        Appends the output to      dir *.ps1 >> Scripts.txt
                the contents of the  
                specified file.

      2>        Sends errors to the        Get-Process none 2> Errors.txt
                specified file.
 
      2>>       Appends errors to          Get-Process none 2>> Save-Errors.txt
                the contents of the 
                specified file.
 
      2>&1      Sends errors (2) and       Get-Process none, Powershell 2>&1
                success output (1) 
                to the success 
                output stream.

      3>        Sends warnings to the      Write-Warning "Test!" 3> Warnings.txt
                specified file.

      3>>       Appends warnings to        Write-Warning "Test!" 3>> Save-Warnings.txt
                the contents of the 
                specified file.

      3>&1      Sends warnings (3) and     function Test-Warning 
                success output (1)         {  Get-Process PowerShell; 
                to the success                Write-Warning "Test!" }
                output stream.             Test-Warning 3>&1

      4>        Sends verbose output to    Import-Module * -Verbose 4> Verbose.txt
                the specified file.

      4>>       Appends verbose output     Import-Module * -Verbose 4>> Save-Verbose.txt
                to the contents of the 
                specified file.

      4>&1      Sends verbose output (4)   Import-Module * -Verbose 4>&1
                and success output (1)    
                to the success output
                stream.              
 
      5>        Sends debug messages to    Write-Debug "Starting" 5> Debug.txt
                the specified file.

      5>>       Appends debug messages     Write-Debug "Saving" 5>> Save-Debug.txt
                to the contents of the 
                specified file.

      5>&1      Sends debug messages (5)   function Test-Debug 
                and success output (1)     { Get-Process PowerShell 
                to the success output        Write-Debug "PS" }
                stream.                    Test-Debug 5>&1

      *>        Sends all output types     function Test-Output
                to the specified file.     { Get-Process PowerShell, none  
                                             Write-Warning "Test!"
      *>>       Appends all output types     Write-Verbose "Test Verbose"
                to the contents of the       Write-Debug "Test Debug" } 
                specified file.            
                                           Test-Output *> Test-Output.txt
      *>&1      Sends all output types     Test-Output *>> Test-Output.txt
                (*) to the success output  Test-Output *>&1      
                stream.

Синтаксис операторов перенаправления выглядит следующим образом:

       <input> <operator> [<path>\]<file>

Если указанный файл уже существует, операторы перенаправления, которые не добавляют данные (> и n>) перезаписывают текущее содержимое файла без предупреждения. Тем не менее, если файл доступен только для чтения, скрыт или является системным, перенаправление не выполняется. Операторы перенаправления с добавлением (>> и n>>) не записывают данные в файлы, доступные только для чтения, но добавляют содержимое в систему и скрытые файлы.

Чтобы принудительно перенаправлять содержимое в доступные только для чтения, скрытые и системные файлы, используйте командлет Out-File с параметром Force. При записи данных в файлы операторы перенаправления используют кодировку Юникод. Если в файле используется другая кодировка, выходные данные могут быть отформатированы неправильно. Чтобы перенаправлять содержимое в файлы с другой кодировкой, используйте командлет Out-File с параметром Encoding.

СМ. ТАКЖЕ

Out-File

Tee-Object

about_Operators

about_Command_Syntax

about_Path_Syntax