about_Redirection
Se aplica a: Windows PowerShell 2.0, Windows PowerShell 3.0, Windows PowerShell 4.0
TEMA
about_Redirection
DESCRIPCIÓN BREVE
Explica cómo redirigir la salida de Windows PowerShell® a archivos de texto.
DESCRIPCIÓN LARGA
De forma predeterminada, Windows PowerShell envía la salida del comando a la consola de Windows PowerShell. Sin embargo, puede dirigir la salida a un archivo de texto y puede redirigir la salida de error al flujo de salida normal.
Puede utilizar los métodos siguientes para redirigir la salida:
- Usar el cmdlet Out-File, que envía la salida del comando a un archivo de texto. Normalmente, se usa el cmdlet Out-File cuando se necesitan utilizar sus parámetros, como los parámetros Encoding, Force, Width o NoClobber.
- Usar el cmdlet Tee-Object, que envía la salida del comando a un archivo de texto y, después, la envía a la canalización.
- Usar los operadores de redirección de Windows PowerShell.
OPERADORES DE REDIRECCIÓN DE WINDOWS POWERSHELL
Los operadores de redirección le permiten enviar tipos de salida determinados a los archivos y al flujo de salida de procesos correctos.
Los operadores de redirección de Windows PowerShell utilizan los siguientes caracteres para representar cada tipo de salida:
* All output
1 Success output
2 Errors
3 Warning messages
4 Verbose output
5 Debug messages
NOTA: los operadores de redirección All (*), Warning (3), Verbose (4) y Debug (5) se introdujeron en Windows PowerShell 3.0. No funcionan en versiones anteriores de Windows PowerShell.
Los operadores de redirección de Windows PowerShell son los siguientes.
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.
La sintaxis de los operadores de redirección es la siguiente:
<input> <operator> [<path>\]<file>
Si el archivo especificado ya existe, los operadores de redirección que no anexan datos (> y n>) sobrescriben el contenido actual del archivo sin ninguna advertencia previa. Sin embargo, si el archivo es de solo lectura, está oculto, o se trata de un archivo del sistema, la redirección producirá un error. Los operadores de redirección de anexión (>> y n>>) no escriben en un archivo de solo lectura, pero anexan contenido en un archivo oculto o de sistema.Insert section body here.
Para forzar la redirección del contenido a un archivo de solo lectura, oculto o del sistema, use el cmdlet Out-File con el parámetro Force. Cuando se escribe en archivos, los operadores de redirección utilizan codificación Unicode. Si el archivo tiene una codificación diferente, puede que el resultado no tenga un formato correcto. Para redirigir contenido a archivos que no sean Unicode, utilice el cmdlet Out-File con el parámetro Encoding.
VEA TAMBIÉN
Out-File
Tee-Object
about_Operators
about_Command_Syntax
about_Path_Syntax