Export-CSV
Convierte los objetos de Microsoft .NET Framework en una serie de cadenas CSV (valores separados por comas) de longitud variable y guarda las cadenas en un archivo CSV.
Sintaxis
Export-CSV [[-Delimiter] <char>] [-Path] <string> -InputObject <psobject> [-Encoding <string>] [-Force] [-NoClobber] [-NoTypeInformation] [-Confirm] [-WhatIf] [<CommonParameters>]
Export-CSV [-UseCulture] [-Path] <string> -InputObject <psobject> [-Encoding <string>] [-Force] [-NoClobber] [-NoTypeInformation] [-Confirm] [-WhatIf] [<CommonParameters>]
Descripción
El cmdlet Export-CSV crea un archivo CSV de longitud variable que representa los objetos que se envían.
A continuación, puede usar el cmdlet Import-CSV para volver a crear objetos a partir de las cadenas CSV del archivo. Los objetos resultantes son versiones CSV de los objetos originales que se componen de representaciones de cadena de los valores de propiedad y ningún método.
También puede utilizar los cmdlets ConvertTo-CSV y ConvertFrom-CSV para convertir los objetos de .NET Framework en cadenas CSV (y viceversa). Export-CSV es igual que ConvertTo-CSV, salvo en que guarda las cadenas CSV en un archivo.
Puede utilizar los parámetros del cmdlet Export-CSV para especificar un delimitador que no sea una coma o para indicar a Export-CSV que use el delimitador predeterminado de la actual referencia cultural.
Cuando se envían varios objetos a Export-CSV, Export-CSV organiza el archivo según las propiedades del primer objeto que se envía. Si los objetos restantes no tienen una de las propiedades especificadas, el valor de propiedad de ese objeto es NULL, lo cual se representa mediante dos comas consecutivas. Si los objetos restantes tienen propiedades adicionales, esos valores de propiedad no se incluyen en el archivo.
Para obtener más información, vea Export-CSV y la sección Notas.
Parámetros
-Delimiter <char>
Especifica un delimitador para separar los valores de propiedad. El delimitador predeterminado es una coma (,). Escriba un carácter, como un signo de dos puntos (:). Para especificar un signo de punto y coma (;), escríbalo entre comillas.
¿Requerido? |
false |
¿Posición? |
2 |
Valor predeterminado |
, (comma) |
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-Encoding <string>
Especifica la codificación para el archivo CSV exportado. Los valores válidos son Unicode, UTF7, UTF8, ASCII, UTF32, BigEndianUnicode, Default y OEM. El valor predeterminado es ASCII.
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
ASCII |
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-Force
Sobrescribe el archivo especificado en la ruta de acceso sin pedir confirmación.
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
|
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-InputObject <psobject>
Especifica los objetos que se van a exportar como cadenas CSV. Especifique la variable que contiene los objetos o escriba un comando o una expresión que los obtenga. También puede canalizar los objetos a Export-CSV.
¿Requerido? |
true |
¿Posición? |
named |
Valor predeterminado |
|
¿Aceptar canalización? |
true (ByValue, ByPropertyName) |
¿Aceptar caracteres comodín? |
false |
-NoClobber
No sobrescribe un archivo existente (es decir, no remplaza su contenido). De forma predeterminada, si existe un archivo en la ruta de acceso especificada, Export-CSV lo sobrescribe sin avisar.
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
|
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-NoTypeInformation
Omite la información de tipo del archivo CSV. De forma predeterminada, la primera línea del archivo CSV contiene "#TYPE" seguido del nombre completo del tipo del objeto de .NET Framework.
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
|
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-Path <string>
Especifica la ruta de acceso al archivo de salida CSV. Este parámetro es obligatorio.
¿Requerido? |
true |
¿Posición? |
1 |
Valor predeterminado |
|
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-UseCulture
Utilice como delimitador de elementos el separador de lista de la actual referencia cultural. El delimitador predeterminado es una coma (,).
Este parámetro es muy útil en scripts que se distribuyen a usuarios por todo el mundo. Para obtener el separador de lista de una referencia cultural, utilice el siguiente comando: (Get-Culture).TextInfo.ListSeparator.
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
Comma |
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-Confirm
Solicita confirmación antes de ejecutar el comando.
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
|
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-WhatIf
Describe lo que ocurriría si ejecutara el comando sin ejecutarlo realmente.
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
|
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
<CommonParameters>
Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.
Entradas y salidas
El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.
Entradas |
System.Management.Automation.PSObject Puede canalizar cualquier objeto de .NET Framework a Export-CSV. |
Salidas |
System.String La lista CSV se envía al archivo especificado en el parámetro Path. |
Notas
El cmdlet Export-CSV convierte los objetos enviados en una serie de cadenas CSV de longitud variable y las guarda en el archivo de texto especificado. Puede utilizar Export-CSV para guardar los objetos en un archivo CSV y, a continuación, usar el cmdlet Import-CSV para crear objetos a partir del texto en el archivo CSV.
En el archivo CSV, cada objeto viene representado por una lista delimitada por comas de los valores de propiedad del objeto. Los valores de propiedad se convierten en cadenas (mediante el método ToString() del objeto) de modo que se representan de manera general mediante el nombre del valor de propiedad. Export-CSV no exporta los métodos del objeto.
Este es el formato de un archivo exportado:
-- La primera línea del archivo CSV contiene la cadena '#TYPE' seguida del nombre completo del tipo de .NET Framework del objeto, como #TYPE System.Diagnostics.Process. Para suprimir esta línea, utilice el parámetro NoTypeInformation.
-- La siguiente línea del archivo CSV representa los encabezados de columna. Contiene una lista delimitada por comas con los nombres de todas las propiedades del primer objeto.
-- Las líneas adicionales del archivo se componen de listas delimitadas por comas de los valores de propiedad de cada objeto.
Ejemplo 1
C:\PS>get-process wmiprvse | select-object basePriority,ID,SessionID,WorkingSet | export-csv -path data.csv
Descripción
-----------
Este comando selecciona algunas propiedades del proceso wmiprvse y las exporta a un archivo con el formato CSV denominado data.csv.
Ejemplo 2
C:\PS>get-process | export-csv processes.csv
C:\PS> get-process | export-csv processes.csv
# In processes.csv
#TYPE System.Diagnostics.Process
__NounName,Name,Handles,VM,WS,PM,NPM,Path,Company,CPU,FileVersion,...
Process,powershell,626,201666560,76058624,61943808,11960,C:\WINDOWS...
Process,powershell,257,151920640,38322176,37052416,7836,C:\WINDOWS\...
Descripción
-----------
Este comando exporta los objetos que representan los procesos del equipo al archivo Processes.csv en el directorio actual. Dado que no especifica un delimitador, se usa una coma (,) para separar los campos del archivo.
Ejemplo 3
C:\PS>get-process | export-csv processes.csv -Delimiter ";"
# In processes.csv
#TYPE System.Diagnostics.Process
__NounName;Name;Handles;VM;WS;PM;NPM;Path;Company;CPU;FileVersion;...
Process;powershell;626;201666560;76058624;61943808;11960;C:\WINDOWS...
Process;powershell;257;151920640;38322176;37052416;7836;C:\WINDOWS\...
Descripción
-----------
Este comando exporta los objetos que representan los procesos del equipo al archivo Processes.csv en el directorio actual. Utiliza el parámetro Delimiter para especificar el signo de punto y coma (;) como delimitador. Como resultado, los campos del archivo están separados por signos de punto y coma.
Ejemplo 4
C:\PS>get-process | export-csv processes.csv -UseCulture
Descripción
-----------
Este comando exporta los objetos que representan los procesos del equipo al archivo Processes.csv en el directorio actual. Utiliza el parámetro UseCulture para indicar a Export-CSV que use el delimitador especificado por la propiedad ListSeparator de la actual referencia cultural.
Ejemplo 5
C:\PS>get-process | export-csv processes.csv -NoTypeInformation
C:\PS> get-process | export-csv processes.csv -NoTypeInformation
# In processes.csv
__NounName,Name,Handles,VM,WS,PM,NPM,Path,Company,CPU,FileVersion,...
Process,powershell,626,201666560,76058624,61943808,11960,C:\WINDOWS...
Process,powershell,257,151920640,38322176,37052416,7836,C:\WINDOWS\...
Descripción
-----------
Este comando exporta los objetos que representan los procesos del equipo al archivo Processes.csv en el directorio actual. Utiliza el parámetro NoTypeInformation para suprimir del archivo la información de tipo.