Convert .NET Framework objects into Comma-Separated Value (CSV) variable-length strings.
Syntax
ConvertTo-CSV [[-Delimiter] char]
[-InputObject] psobject [-NoTypeInformation] [CommonParameters]
ConvertTo-CSV [-UseCulture]
[-InputObject] psobject [-NoTypeInformation] [CommonParameters]
key
-Delimiter char
The delimiter to separate property values. Default = comma (,).
Enter a character, such as a colon (:).
To specify a semicolon (;), enclose it in quotation marks. Otherwise, it
will be interpreted as the command delimiter.
-InputObject psobject
The objects to export as CSV strings. Enter a variable that contains the
objects or type an expression that returns the objects.
You can also pipe objects to ConvertTo-CSV.
-NoTypeInformation
Omit the type information header from the output.
By default, the string in the output contains "#TYPE " followed
by the fully-qualified name of the type of the .NET Framework object.
-UseCulture
Use the list separator for the current culture as the data delimiter.
Default = comma (,)
This parameter is very useful in scripts that are being distributed to
users worldwide. To find the list separator for a culture, use the following:
(Get-Culture).TextInfo.ListSeparator.
CommonParameters:
-Verbose, -Debug, -ErrorAction, -ErrorVariable, -WarningAction, -WarningVariable,
-OutBuffer -OutVariable.
ConvertTo-CSV returns a series of comma-separated, variable-length (CSV) strings that represents the objects that you submit.
You can then use ConvertFrom-CSV to re-create objects from the CSV strings.
Export-CSV is the same as ConvertTo-CSV, except that it saves to a file.
Examples
Convert a date object to CSV format:
C:\PS> $date = get-date
C:\PS> convertto-csv -inputobject $date -delimiter ";" -notypeinformation
Convert a process object to CSV format:
C:\PS> get-process powershell | convertto-csv
Convert an event log object to CSV format:
C:\PS> get-eventlog -log "application" | convertto-csv -useculture
“Drunk with power isn't the same as being drunk with booze” - Craig Ferguson
Related PowerShell Cmdlets:
Export-Csv - Export to Comma Separated Values (spreadsheet)