Out-File

Módulo:: Microsoft.PowerShell.Utility Module

Envía los resultados a un archivo.

Sintaxis

ByPath (Es el valor predeterminado).

Out-File
    [-FilePath] <string>
    [[-Encoding] <Encoding>]
    [-Append]
    [-Force]
    [-NoClobber]
    [-Width <int>]
    [-NoNewline]
    [-InputObject <psobject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByLiteralPath

Out-File
    [[-Encoding] <Encoding>]
    -LiteralPath <string>
    [-Append]
    [-Force]
    [-NoClobber]
    [-Width <int>]
    [-NoNewline]
    [-InputObject <psobject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

El cmdlet Out-File envía la salida a un archivo. Usa implícitamente el sistema de formato de PowerShell para escribir en el archivo. El archivo recibe la misma representación de presentación que el terminal. Esto significa que la salida puede no ser ideal para el procesamiento mediante programación a menos que todos los objetos de entrada sean cadenas.

Redirigir la salida de un comando de PowerShell (cmdlet, función, script) mediante el operador de redirección (>) es funcionalmente equivalente a canalizar a Out-File sin parámetros adicionales. PowerShell 7.4 cambió el comportamiento del operador de redirección cuando se usa para redirigir la secuencia stdout de un comando nativo. Para obtener más información sobre el redireccionamiento, consulte about_Redirection.

Ejemplos

Ejemplo 1: Enviar salida y crear un archivo

En este ejemplo se muestra cómo enviar una lista de los procesos del equipo local a un archivo. Si el archivo no existe, Out-File crea el archivo en la ruta de acceso especificada.

Get-Process | Out-File -FilePath .\Process.txt
Get-Content -Path .\Process.txt

 NPM(K)    PM(M)      WS(M)     CPU(s)      Id  SI ProcessName
 ------    -----      -----     ------      --  -- -----------
     29    22.39      35.40      10.98   42764   9 Application
     53    99.04     113.96       0.00   32664   0 CcmExec
     27    96.62     112.43     113.00   17720   9 Code

El cmdlet Get-Process obtiene la lista de procesos que se ejecutan en el equipo local. Los objetos Process se envían a la canalización al cmdlet Out-File. Out-File usa el parámetro FilePath y crea un archivo en el directorio actual denominado Process.txt. El comando Get-Content obtiene contenido del archivo y lo muestra en la consola de PowerShell.

Ejemplo 2: Impedir que se sobrescriba un archivo existente

En este ejemplo se impide que se sobrescriba un archivo existente. De forma predeterminada, Out-File sobrescribe los archivos existentes.

Get-Process | Out-File -FilePath .\Process.txt -NoClobber

Out-File : The file 'C:\Test\Process.txt' already exists.
At line:1 char:15
+ Get-Process | Out-File -FilePath .\Process.txt -NoClobber
+               ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

El cmdlet Get-Process obtiene la lista de procesos que se ejecutan en el equipo local. Los objetos Process se envían a la canalización al cmdlet Out-File. Out-File usa el parámetro FilePath e intenta escribir en un archivo en el directorio actual denominado Process.txt. El parámetro NoClobber impide que el archivo se sobrescriba y muestre un mensaje que indica que el archivo ya existe.

Ejemplo 3: Envío de salida a un archivo en formato ASCII

En este ejemplo se muestra cómo codificar la salida con un tipo de codificación específico.

$Procs = Get-Process
Out-File -FilePath .\Process.txt -InputObject $Procs -Encoding ascii -Width 50

El cmdlet Get-Process obtiene la lista de procesos que se ejecutan en el equipo local. Los objetos Process de se almacenan en la variable , $Procs. Out-File usa el parámetro FilePath y crea un archivo en el directorio actual denominado Process.txt. El parámetro InputObject pasa los objetos de proceso de $Procs al archivo Process.txt. El parámetro de codificación convierte la salida en formato de ASCII. El parámetro Width limita cada línea del archivo a 50 caracteres para que algunos datos se puedan truncar.

Ejemplo 4: Uso de un proveedor y envío de salida a un archivo

En este ejemplo se muestra cómo usar el cmdlet Out-File cuando no se encuentra en una unidad de proveedor de FileSystem. Use el cmdlet Get-PSProvider para ver los proveedores en el equipo local. Para obtener más información, consulte about_Providers.

PS> Set-Location -Path Alias:

PS> Get-Location

Path
----
Alias:\

PS> Get-ChildItem | Out-File -FilePath C:\TestDir\AliasNames.txt

PS> Get-Content -Path C:\TestDir\AliasNames.txt

CommandType     Name
-----------     ----
Alias           % -> ForEach-Object
Alias           ? -> Where-Object
Alias           ac -> Add-Content
Alias           cat -> Get-Content

El comando Set-Location usa el parámetro Path de para establecer la ubicación actual en el proveedor del registro Alias:. El cmdlet Get-Location muestra la ruta de acceso completa para Alias:. Get-ChildItem envía objetos a la canalización al cmdlet Out-File. Out-File usa el parámetro FilePath para especificar la ruta de acceso completa y el nombre de archivo de la salida, C:\TestDir\AliasNames.txt. El cmdlet Get-Content usa el parámetro path de y muestra el contenido del archivo en la consola de PowerShell.

Ejemplo 5: Establecer el ancho de salida del archivo para todo el ámbito

En este ejemplo se usa $PSDefaultParameterValues para establecer el parámetro Width para todas las invocaciones de Out-File y los operadores de redirección (> y >>) en 2000. Esto garantiza que en todas partes del ámbito actual se generan datos con formato de tabla en el archivo, PowerShell usa un ancho de línea de 2000 en lugar de un ancho de línea determinado por el ancho de consola del host de PowerShell.

function DemoDefaultOutFileWidth() {
    try {
        $PSDefaultParameterValues['Out-File:Width'] = 2000

        $logFile = "$PWD\logfile.txt"

        Get-ChildItem Env:\ > $logFile

        Get-Service -ErrorAction Ignore |
            Format-Table -AutoSize |
            Out-File $logFile -Append

        Get-Process | Format-Table Id,SI,Name,Path,MainWindowTitle >> $logFile
    }
    finally {
        $PSDefaultParameterValues.Remove('Out-File:Width')
    }
}

DemoDefaultOutFileWidth

Para obtener más información sobre $PSDefaultParameterValues, vea about_Preference_Variables.

Parámetros

-Append

Agrega la salida al final de un archivo existente.

Propiedades del parámetro

Tipo:	SwitchParameter
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Mandatory:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Propiedades del parámetro

Tipo:	SwitchParameter
Valor predeterminado:	False
Admite caracteres comodín:	False
DontShow:	False
Alias:	cf

Conjuntos de parámetros

(All)

Posición:	Named
Mandatory:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-Encoding

Especifica el tipo de codificación para el archivo de destino. El valor predeterminado es utf8NoBOM.

Los valores aceptables para este parámetro son los siguientes:

ascii: Utiliza la codificación para el conjunto de caracteres ASCII (7 bits).
ansi: utiliza la codificación para la página de códigos ANSI de la cultura actual. Esta opción se agregó en PowerShell 7.4.
bigendianunicode: codifica en formato UTF-16 utilizando el orden de bytes big-endian.
bigendianutf32: codifica en formato UTF-32 utilizando el orden de bytes big-endian.
oem: usa la codificación predeterminada para MS-DOS y programas de consola.
unicode: codifica en formato UTF-16 utilizando el orden de bytes little-endian.
utf7: codifica en formato UTF-7.
utf8: codifica en formato UTF-8.
utf8BOM: codifica en formato UTF-8 con Byte Order Mark (BOM)
utf8NoBOM: codifica en formato UTF-8 sin marca de orden de bytes (BOM)
utf32: codifica en formato UTF-32.

A partir de PowerShell 6.2, el parámetro Codificación también permite identificadores numéricos de páginas de códigos registradas (como -Encoding 1251) o nombres de cadena de páginas de códigos registradas (como -Encoding "windows-1251"). Para obtener más información, consulte la documentación de .NET para Encoding.CodePage.

A partir de PowerShell 7.4, puede utilizar el valor Ansi para el parámetro de Codificación para pasar el identificador numérico de la página de códigos ANSI de la cultura actual sin tener que especificarlo manualmente.

Nota:

UTF-7* ya no se recomienda usar. A partir de PowerShell 7.1, se escribe una advertencia si especifica utf7 para el parámetro Encoding.

Propiedades del parámetro

Tipo:	Encoding
Valor predeterminado:	UTF8NoBOM
Valores aceptados:	ASCII, BigEndianUnicode, BigEndianUTF32, OEM, Unicode, UTF7, UTF8, UTF8BOM, UTF8NoBOM, UTF32
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	1
Mandatory:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-FilePath

Especifica la ruta de acceso al archivo de salida.

Propiedades del parámetro

Tipo:	String
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False
Alias:	Ruta

Conjuntos de parámetros

ByPath

Posición:	0
Mandatory:	True
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-Force

Invalida el atributo de solo lectura y sobrescribe un archivo de solo lectura existente. El parámetro Force no invalida las restricciones de seguridad.

Propiedades del parámetro

Tipo:	SwitchParameter
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Mandatory:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-InputObject

Especifica los objetos que se van a escribir en el archivo. Escriba una variable que contenga los objetos o escriba un comando o expresión que obtenga los objetos.

Propiedades del parámetro

Tipo:	PSObject
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Mandatory:	False
Valor de la canalización:	True
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-LiteralPath

Especifica la ruta de acceso al archivo de salida. El parámetro LiteralPath se usa exactamente como se escribe. No se aceptan caracteres comodín. Si la ruta de acceso incluye caracteres de escape, escríbala entre comillas simples. Las comillas simples indican a PowerShell que no interprete ningún carácter como secuencias de escape. Para obtener más información, consulte sobre_las_normas_de_citación.

Propiedades del parámetro

Tipo:	String
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False
Alias:	PSPath, LP

Conjuntos de parámetros

ByLiteralPath

Posición:	Named
Mandatory:	True
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	True
Valor de los argumentos restantes:	False

-NoClobber

noClobber impide que se sobrescriba un archivo existente y muestre un mensaje que indica que el archivo ya existe. De forma predeterminada, si existe un archivo en la ruta de acceso especificada, Out-File sobrescribe el archivo sin advertencia.

Propiedades del parámetro

Tipo:	SwitchParameter
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False
Alias:	NoOverwrite

Conjuntos de parámetros

(All)

Posición:	Named
Mandatory:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-NoNewline

Especifica que el contenido escrito en el archivo no termina con un carácter de nueva línea. Las representaciones de cadena de los objetos de entrada se concatenan para formar la salida. No se insertan espacios ni nuevas líneas entre las cadenas de salida. No se agrega ninguna nueva línea después de la última cadena de salida.

Propiedades del parámetro

Tipo:	SwitchParameter
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Mandatory:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Propiedades del parámetro

Tipo:	SwitchParameter
Valor predeterminado:	False
Admite caracteres comodín:	False
DontShow:	False
Alias:	Wi

Conjuntos de parámetros

(All)

Posición:	Named
Mandatory:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-Width

Especifica el número máximo de caracteres en cada línea de salida. Los caracteres adicionales se truncan, no se encapsulan. Si no se usa este parámetro, el ancho viene determinado por las características del host. El valor predeterminado de la consola de PowerShell es de 80 caracteres. Si desea controlar el ancho de todas las invocaciones de Out-File, así como los operadores de redireccionamiento (> y >>), establezca $PSDefaultParameterValues['Out-File:Width'] = 2000 antes de usar Out-File.

Propiedades del parámetro

Tipo:	Int32
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Mandatory:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

PSObject

Puede canalizar cualquier objeto a este cmdlet.

Salidas

None

Este cmdlet no devuelve ninguna salida.

Notas

Los objetos de entrada tienen el formato automático como lo harían en el terminal, pero puede usar un cmdlet Format-* para controlar explícitamente el formato de la salida en el archivo. Por ejemplo: Get-Date | Format-List | Out-File out.txt

Para enviar la salida de un comando de PowerShell al cmdlet Out-File, use la canalización. Como alternativa, puede almacenar datos en una variable y usar el parámetro InputObject para pasar datos al cmdlet Out-File.

Out-File guarda los datos en un archivo, pero no genera ningún objeto de salida en la canalización.

PowerShell 7.2 agregó la capacidad de controlar cómo se representan las secuencias de escape ANSI. La salida decorada con ANSI que se pasa a Out-File se puede cambiar en función del valor de la propiedad $PSStyle.OutputRendering. Para obtener más información, vea about_ANSI_Terminals.

Comentarios

¿Le resultó útil esta página?

Compartir vía

Out-File

Sintaxis

ByPath (Es el valor predeterminado).

ByLiteralPath

Description

Ejemplos

Ejemplo 1: Enviar salida y crear un archivo

Ejemplo 2: Impedir que se sobrescriba un archivo existente

Ejemplo 3: Envío de salida a un archivo en formato ASCII

Ejemplo 4: Uso de un proveedor y envío de salida a un archivo

Ejemplo 5: Establecer el ancho de salida del archivo para todo el ámbito

Parámetros

-Append

Propiedades del parámetro

Conjuntos de parámetros

-Confirm

Propiedades del parámetro

Conjuntos de parámetros

-Encoding

Propiedades del parámetro

Conjuntos de parámetros

-FilePath

Propiedades del parámetro

Conjuntos de parámetros

-Force

Propiedades del parámetro

Conjuntos de parámetros

-InputObject

Propiedades del parámetro

Conjuntos de parámetros

-LiteralPath

Propiedades del parámetro

Conjuntos de parámetros

-NoClobber

Propiedades del parámetro

Conjuntos de parámetros

-NoNewline

Propiedades del parámetro

Conjuntos de parámetros

-WhatIf

Propiedades del parámetro

Conjuntos de parámetros

-Width

Propiedades del parámetro

Conjuntos de parámetros

CommonParameters

Entradas

PSObject

Salidas

None

Notas

Vínculos relacionados

Comentarios