Export-Csv 帮助信息

如下说明是翻译 : help Export-Csv 产生的帮助信息 .

译者 : Edengundam( 马涛 )

 

Export-Csv

 

摘要

创建一个用于表示输入对象的逗号分隔值文件 (CSV 文件 ).

 

语法

Export-Csv [-path] <string> -inputObject <psobject> [-force] [-encoding <string>] [-noTypeInformation] [-noClobber] [-whatIf] [-confirm] [<CommonParameters>]

 

详细描述

创建一个用于表示输入对象的逗号分隔值文件 (CSV 文件 ).

 

除非你指定 NoTypeInformation 参数 , 否则 CSV 文件的第一行将会以 '#TYPE ' 开头 , 并跟随表示数据类型的完全限定名的类型 . 例如 : #TYPE System.Diagnostics.Process.

 

CSV 文件中的下一行用来表示列名 , 它是包含逗号分隔的第一个输入对象的属性名称列表 .

 

文件中剩余的行包含了每个输入对象上在列名中指出的属性值 , 并使用逗号进行分隔 .

 

第一个对象建立列头信息 . 列头信息不会根据后续输入对象进行修改 . 如果对象不包含列头行中指定的属性 , 将不会输出任何关于此属性的值 . 相反 , 将会使用两个逗号来表示缺少此属性信息 , 并且会自动进行对齐处理来保证数值与列头中属性名称的对齐 .

 

如果属性值中包含逗号 , 双引号 , 前导或尾随空格或者分行符 , 它们将会在存储到 CSV 文件中之前 , 被放入双引号中 . 属性值中的任何的双引号都会使用连续两个双引号来表示其字面意义 .

 

你可以使用 Import-CSV cmdlet 命令利用 CSV 文件中的信息重新创建输入对象 .

 

参数

 

-path <string>

指定 CVS 文件的创建路径 .

 

强制参数 ?	true
参数位置 ?	1
默认值	Null
允许从管道绑定输入 ?	false
允许通配符扩展 ?	true

 

-inputObject <psobject>

接受将会表示 CSV 文件的对象 . 输入一个包含对象的变量 , 或者一个能够产生对象的命令或表达式 .

 

强制参数 ?	true
参数位置 ?	named
默认值
允许从管道绑定输入 ?	true ( 根据值 )
允许通配符扩展 ?	false

 

-force <SwitchParameter>

覆盖指定路径上已经存在的文件时 , 不进行任何提示 .

 

强制参数 ?	false
参数位置 ?	named
默认值	False
允许从管道绑定输入 ?	false
允许通配符扩展 ?	false

 

-encoding <string>

为导出的 CSV 文件设置编码类型 . 允许值为 : Unicode, UTF7, UTF8, ASCII.

 

强制参数 ?	false
参数位置 ?	named
默认值	ASCII
允许从管道绑定输入 ?	false
允许通配符扩展 ?	false

 

-noTypeInformation <SwitchParameter>

忽略 CSV 文件的 #TYPE 头 ( 类型信息 ). 如果没有指定此参数 , CSV 文件的第一行将会以 '#TYPE ' 开头 , 并跟随表示数据类型的完全限定名的类型 . 如果指定此参数 , CSV 文件中将不会包含任何类型信息 .

 

强制参数 ?	false
参数位置 ?	named
默认值	False
允许从管道绑定输入 ?	false
允许通配符扩展 ?	false

 

-noClobber <SwitchParameter>

不覆盖 ( 替换原有内容 ) 已经存在的文件 . 默认情况下 , 如果文件已经在指定路径存在 , Export-Csv 在 不提示任何警告的情况下覆盖此文件 .

 

强制参数 ?	alse
参数位置 ?	named
默认值	False
允许从管道绑定输入 ?	false
允许通配符扩展 ?	false

 

-whatIf

描述执行此命令将会发生的现象 , 不会真正执行此命令 .

 

强制参数 ?	false
参数位置 ?	named
默认值
允许从管道绑定输入 ?	false
允许通配符扩展 ?	false

 

-confirm

执行命令前提示你进行确认 .

 

强制参数 ?	false
参数位置 ?	named
默认值
允许从管道绑定输入 ?	false
允许通配符扩展 ?	false

 

< 公共参数 >

此命令支持公共参数 : -Verbose, -Debug, -ErrorAction, -ErrorVariable, and -OutVariable. 更多信息 , 输入 , "get-help about_commonparameters".

 

输入类型

Any object(s)

 

返回类型

CSV list

 

注意

 

通过调用输入对象的每个属性上的 ToString 方法来获得字符串版本属性值 .

 

更多信息 , 输入 "Get-Help Export-Csv -detailed". 需要技术信息 , 输入 "Get-Help Export-Csv -full".

 

如果需要为该命令提供多个参数 , 请使用逗号进行分隔 . 例如 , "<parameter-name> <value1>, <value2>".

 

例 1

 

C:/PS>get-process wmiprvse | select-object basePriority,ID,SessionID,WorkingSet | export-csv -path data.csv

 

此命令从 wmiprvse 进程中选择少数几个属性 , 并将它们导出到名叫 data.csv 的 CSV 格式中 .

 

相关链接

Import-Csv

Export-Clixml

ConvertTo-Html