ConvertTo-Csv

模块:: Microsoft.PowerShell.Utility

将对象转换为一系列逗号分隔值（CSV）字符串。

语法

ConvertTo-Csv
              [-InputObject] <psobject>
              [[-Delimiter] <char>]
              [-NoTypeInformation]
              [<CommonParameters>]

ConvertTo-Csv
              [-InputObject] <psobject>
              [-UseCulture]
              [-NoTypeInformation]
              [<CommonParameters>]

说明

该 ConvertTo-CSV cmdlet 返回一系列逗号分隔值（CSV）字符串，这些字符串表示您提交的对象。然后，可以使用 ConvertFrom-Csv cmdlet 从 CSV 字符串重新创建对象。从 CSV 转换的对象是包含属性值和无方法的原始对象的字符串值。

可以使用 Export-Csv cmdlet 将对象转换为 CSV 字符串。 Export-CSV 类似于 ConvertTo-CSV，只不过将 CSV 字符串保存到文件中。

ConvertTo-CSV cmdlet 具有参数来指定逗号以外的分隔符，或使用当前区域性作为分隔符。

示例

示例 1：将对象转换为 CSV

此示例将 Process 对象转换为 CSV 字符串。

Get-Process -Name 'PowerShell' | ConvertTo-Csv -NoTypeInformation

"Name","SI","Handles","VM","WS","PM","NPM","Path","Company","CPU","FileVersion", ...
"powershell","11","691","2204036739072","175943680","132665344","33312", ...

Get-Process cmdlet 获取 Process 对象，并使用 Name 参数指定 PowerShell 进程。进程对象将管道向下发送到 ConvertTo-CSV cmdlet。 ConvertTo-CSV cmdlet 将对象转换为 CSV 字符串。 NoTypeInformation 参数从 CSV 输出中删除 #TYPE 信息标头。

示例 2：将 DateTime 对象转换为 CSV

此示例将 DateTime 对象转换为 CSV 字符串。

$Date = Get-Date
ConvertTo-Csv -InputObject $Date -Delimiter ';' -NoTypeInformation

"DisplayHint";"DateTime";"Date";"Day";"DayOfWeek";"DayOfYear";"Hour";"Kind";"Millisecond";"Minute";"Month";"Second";"Ticks";"TimeOfDay";"Year"
"DateTime";"Friday, January 4, 2019 14:40:51";"1/4/2019 00:00:00";"4";"Friday";"4";"14";"Local";"711";"40";"1";"51";"636822096517114991";"14:40:51.7114991";"2019"

Get-Date cmdlet 获取 DateTime 对象，并将其保存在 $Date 变量中。 ConvertTo-Csv cmdlet 将 DateTime 对象转换为字符串。 InputObject 参数使用存储在变量中的 $Date 对象。 分隔符 参数指定分隔字符串值的分号。 NoTypeInformation 参数从 CSV 输出中删除 #TYPE 信息标头。

示例 3：将 PowerShell 事件日志转换为 CSV

此示例将 PowerShell 的 Windows 事件日志转换为一系列 CSV 字符串。

(Get-Culture).TextInfo.ListSeparator
Get-WinEvent -LogName 'Windows PowerShell' | ConvertTo-Csv -UseCulture -NoTypeInformation

,
"Message","Id","Version","Qualifiers","Level","Task","Opcode","Keywords","RecordId", ...
"Error Message = System error","403",,"0","4","4",,"36028797018963968","46891","PowerShell", ...

Get-Culture cmdlet 使用 TextInfo 嵌套属性，ListSeparator 并显示当前区域性的默认列表分隔符。 Get-WinEvent cmdlet 获取事件日志对象，并使用 LogName 参数指定日志文件名称。事件日志对象将管道向下发送到 ConvertTo-Csv cmdlet。 ConvertTo-Csv cmdlet 将事件日志对象转换为一系列 CSV 字符串。 UseCulture 参数使用当前区域性的默认列表分隔符作为分隔符。 NoTypeInformation 参数从 CSV 输出中删除 #TYPE 信息标头。

参数

-Delimiter

指定分隔符以分隔 CSV 字符串中的属性值。默认值为逗号（,）。输入字符，如冒号（:）。若要指定分号（;），请将它括在单引号中。

类型:	Char
Position:	1
默认值:	comma (,)
必需:	False
接受管道输入:	False
接受通配符:	False

-InputObject

指定转换为 CSV 字符串的对象。输入一个包含对象的变量，或键入一个获取对象的命令或表达式。还可以通过管道将对象传递给 ConvertTo-CSV。

类型:	PSObject
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-NoTypeInformation

从输出中删除 #TYPE 信息标头。此参数在 PowerShell 6.0 中成为默认值，并包含在后向兼容性中。

类型:	SwitchParameter
别名:	NTI
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-UseCulture

将当前区域性的列表分隔符用作项分隔符。若要查找特定文化的列表分隔符，请使用以下命令：(Get-Culture).TextInfo.ListSeparator。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输入

PSObject

您可以通过管道将具有扩展类型系统（ETS）适配器的任何对象传递给 ConvertTo-CSV。

输出

String

CSV 输出作为字符串集合返回。

备注

在 CSV 格式中，每个对象都由其属性值的逗号分隔列表表示。属性值使用对象的 ToString（） 方法转换为字符串。字符串由属性值名称表示。 ConvertTo-CSV 不导出对象的方法。

CSV 字符串输出如下：

默认情况下，第一个字符串包含 #TYPE 信息标头，后跟对象类型的完全限定名称。例如，#TYPE System.Diagnostics.Process。
如果使用 NoTypeInformation，则第一个字符串包括列标题。标头包含第一个对象的属性名称作为逗号分隔的列表。
其余字符串包含每个对象的属性值的逗号分隔列表。

将多个对象提交到 ConvertTo-CSV时，ConvertTo-CSV 根据提交的第一个对象的属性对字符串进行排序。如果其余对象没有指定属性之一，则该对象的属性值为 Null，由两个连续逗号表示。如果其余对象具有其他属性，则忽略这些属性值。

通过