about_Redirection

업데이트 날짜: 2014년 5월

적용 대상: Windows PowerShell 2.0, Windows PowerShell 3.0, Windows PowerShell 4.0, Windows PowerShell 5.0

항목

about_Redirection

간단한 설명

출력을 Windows PowerShell®에서 텍스트 파일로 리디렉션하는 방법을 설명합니다.

자세한 설명

기본적으로 Windows PowerShell는 명령 출력을 Windows PowerShell 콘솔에 보냅니다. 그러나 출력을 텍스트 파일로 지정하고 오류 출력을 일반 출력 스트림으로 리디렉션할 수 있습니다.

다음과 같은 방법을 사용하여 출력을 리디렉션할 수 있습니다.

  • - 명령 출력을 텍스트 파일로 보내는 Out-File cmdlet을 사용합니다. 일반적으로 Out-File cmdlet은 해당 매개 변수(예: Encoding, Force, Width 또는 NoClobber)를 사용해야 할 때 사용합니다.

  • - 명령 출력을 텍스트 파일로 보낸 다음 파이프라인에 보내는 Tee-Object cmdlet을 사용합니다.

  • - 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>)는 파일의 현재 내용을 경고 없이 덮어씁니다. 그러나 파일이 읽기 전용, 숨겨진 또는 시스템 파일인 경우 리디렉션이 실패합니다. 추가 리디렉션 연산자(>> 및 >>)는 읽기 전용 파일에 쓰지 않고 내용을 시스템 또는 숨겨진 file.Insert 섹션 본문에 추가합니다.

내용을 읽기 전용, 숨겨진 또는 시스템 파일로 강제로 리디렉션하려면 Force 매개 변수를 지정하고 Out-File cmdlet을 사용합니다. 파일에 쓰는 경우 리디렉션 연산자는 Unicode 인코딩을 사용합니다. 파일의 인코딩이 다르면 출력이 올바르게 서식 설정되지 않습니다. 내용을 Unicode가 아닌 파일로 리디렉션하려면 Encoding 매개 변수를 지정하여 Out-File cmdlet을 사용합니다.

참고 항목

Out-File

Tee-Object

about_Operators

about_Command_Syntax

about_Path_Syntax

커뮤니티 추가 항목

추가
표시: