Envía la salida a un archivo.
sintaxis
Descripción
el cmdlet Out-File envía la salida a un archivo. Utiliza implícitamente el sistema de formato de PowerShell para escribir en el archivo. El archivo recibe la misma representación de pantalla que el terminal. Esto significa que la salida puede no ser ideal para el procesamiento programático a menos que todos los objetos de entrada sean cadenas.,Cuando necesite especificar parámetros para la salida, use Out-File en lugar del operador de redirección (>). Para obtener más información sobre la redirección, consulte about_Redirection.
ejemplos
ejemplo 1: Enviar salida y crear un archivo
este ejemplo 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 especificada.
el cmdlet Get-Process obtiene la lista de procesos que se ejecutan en el equipo local., Los Processobjects se envían por la canalización al cmdlet Out-File. Out-File utiliza el FilePathparameter y crea un archivo en el directorio actual llamado Process.txt. El comando Get-Content obtiene el contenido del archivo y lo muestra en la consola de PowerShell.
Ejemplo 2: evitar que se sobrescriba un archivo existente
este ejemplo evita que se sobrescriba un archivo existente. De forma predeterminada, Out-File sobrescribe los archivos existentes.,
el cmdlet Get-Process obtiene la lista de procesos que se ejecutan en el equipo local. Los Processobjects se envían por la canalización al cmdlet Out-File. Out-File utiliza el FilePathparameter e intenta escribir en un archivo en el directorio actual llamado Process.txt. El parámetro clobber evita que el archivo se sobrescriba y muestra un mensaje de que el archivo ya existe.
Ejemplo 3: Enviar salida a un archivo en formato ASCII
este ejemplo muestra cómo codificar la salida con un tipo de codificación específico.,
$Procs = Get-ProcessOut-File -FilePath .\Process.txt -InputObject $Procs -Encoding ASCII -Width 50El Get-Process cmdlet obtiene la lista de procesos que se ejecutan en el equipo local. Los Processobjects se almacenan en la variable, $Procs. Out-File utiliza el parámetro FilePath y crea un archivo en el directorio actual llamado Proceso.txt. El parámetro InputObject pasa los objetosprocess en $Procs al proceso de archivo.txt. El parámetro Encoding convierte la salida a formato ASCII. El parámetro Width limita cada línea en el archivo a 50 caracteres los datos de sosome podrían truncarse.,
Ejemplo 4: Usar un proveedor y enviar resultados a un archivo
este ejemplo muestra cómo usar el cmdlet Out-File cuando no está en un providerdrive de sistema de archivos. Utilice el cmdlet Get-PSProvider para ver los proveedores en el equipo local. Para más información, vea about_Providers.
el comando Set-Location utiliza el parámetro Path para establecer la ubicación actual en el registryprovider Alias:. El cmdlet Get-Location muestra la ruta completa de Alias:.,Get-ChildItemenvía objetos por la canalización al cmdlet Out-File. Out-File utiliza el parámetro filepath para especificar la ruta completa y el nombre de archivo para la salida,C:\TestDir\AliasNames.txt. El cmdlet Get-Content utiliza el parámetro Path y muestra el contenido del archivo en la consola de PowerShell.
Parameters
añade la salida al final de un archivo existente.,
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Prompts you for confirmation before running the cmdlet.,
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies the type of encoding for the target file. The default value is utf8NoBOM.,
los valores aceptables para este parámetro son los siguientes:
-
ascii: utiliza la codificación para el conjunto de caracteres ASCII (7 bits). -
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: utiliza la codificación predeterminada para MS-DOS y programas de consola. -
unicode: codifica en formato UTF-16 usando 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 Marca de Orden de Bytes (BOM) -
utf8NoBOM: Codifica en formato UTF-8 sin Marca de Orden de Bytes (BOM) -
utf32: codificación en UTF-32 formato.
a partir de PowerShell 6.,2, el parámetro de codificación también permite identificaciones numéricas de páginas de código registradas (como -Encoding 1251) o nombres de cadena de páginas de código registradas (como-Encoding "windows-1251"). Para obtener más información, consulte la documentación de. NET paraencoding.CodePage.
Nota
UTF-7 * ya no se recomienda su uso. En PowerShell 7.1, se escribe una advertencia si especifica utf7 para el parámetro Encoding.,
| Type: | Encoding |
| Accepted values: | ASCII, BigEndianUnicode, BigEndianUTF32, OEM, Unicode, UTF7, UTF8, UTF8BOM, UTF8NoBOM, UTF32 |
| Position: | 1 |
| Default value: | UTF8NoBOM |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies the path to the output file.,
| Type: | String |
| Aliases: | Path |
| Position: | 0 |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Overrides the read-only attribute and overwrites an existing read-only file. The Force parameterdoes not override security restrictions.,
| Tipo: | SwitchParameter |
| Cargo: | Nombre |
| valor Predeterminado: | Ninguno |
| Aceptar tubería de entrada: | False |
| Aceptar caracteres comodín: | False |
Especifica los objetos que se escriben en el archivo. Escriba una variable que contenga los objetos o el comando o la expresión typea que obtiene los objetos.,
| Tipo: | PSObject |
| Cargo: | Nombre |
| valor Predeterminado: | Ninguno |
| Aceptar tubería de entrada: | Sí |
| Aceptar caracteres comodín: | False |
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, enciérrela en marcas singlequotation., Las comillas simples indican a PowerShell que no interprete ningún carácter como consecuencia de escape. Para obtener más información, consulte about_Quoting_Rules.,
| Type: | String |
| Aliases: | PSPath, LP |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
NoClobber prevents an existing file from being overwritten and displays a message that the filealready exists., De forma predeterminada, si existe un archivo en la ruta especificada, Out-File sobrescribe la advertencia filewithout.,
| Tipo: | SwitchParameter |
| Alias: | NoOverwrite |
| Cargo: | Nombre |
| valor por Defecto: | Ninguno |
| Aceptar tubería de entrada: | False |
| Aceptar caracteres comodín: | False |
Especifica que el contenido escrito en el archivo no termina con un carácter de nueva línea. Las stringrepresentations de los objetos de entrada se concatenan para formar la salida., No se insertan espacios ni líneas nuevas entre las cadenas de salida. No se añade una nueva línea después de la última cadena de salida.
| Tipo: | SwitchParameter |
| Cargo: | Nombre |
| valor Predeterminado: | Ninguno |
| Aceptar tubería de entrada: | False |
| Aceptar caracteres comodín: | False |
Muestra lo que pasaría si se ejecuta el cmdlet. El cmdlet no se ejecuta.,
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies the number of characters in each line of output. Any additional characters are truncated,not wrapped., Si no se utiliza este parámetro, el ancho está determinado por las características del host. El valor predeterminado de la consola de PowerShell es de 80 caracteres.
| Tipo: | Int32 |
| Cargo: | Nombre |
| valor Predeterminado: | Ninguno |
| Aceptar tubería de entrada: | False |
| Aceptar caracteres comodín: | False |
Entradas
PSObject
Se puede canalizar cualquier objeto a Out-File.,
Outputs
None
Out-File no genera ninguna salida.
notas
los objetos de entrada se formatean automáticamente como lo harían en el terminal, pero puede usar un cmdletFormat-* para controlar explícitamente el formato de la salida del archivo. Por ejemplo,Get-Date | Format-List | Out-File out.txt
para enviar la salida de un comando PowerShell al cmdlet Out-File, utilice la canalización. También puede almacenar datos en una variable y usar el parámetro InputObject para pasar datos al cmdlet Out-File.,
Out-File guarda datos en un archivo pero no produce ningún objeto de salida en la canalización.
- about_Providers
- about_Quoting_Rules
- Salida Predeterminada
- Out-Host
- Salida-Null
- Salida de Cadena
- Tee-Objeto
Deja una respuesta