Import-Csv
从 CSV) 文件中逗号分隔值 (项创建类似表的自定义对象。
语法
Import-Csv
[[-Path] <string[]>]
[[-Delimiter] <char>]
[-LiteralPath <string[]>]
[-Header <string[]>]
[-Encoding <string>]
[<CommonParameters>]
Import-Csv
[[-Path] <string[]>]
-UseCulture
[-LiteralPath <string[]>]
[-Header <string[]>]
[-Encoding <string>]
[<CommonParameters>]
说明
cmdlet Import-Csv
从 CSV 文件中的项创建类似于表的自定义对象。 CSV 文件中的每个列都成为自定义对象的属性,行中的项将成为属性值。 Import-Csv
适用于任何 CSV 文件,包括 cmdlet Export-Csv
生成的文件。
可以使用 cmdlet 的参数 Import-Csv
来指定列标题行和项分隔符,或直接 Import-Csv
使用当前区域性的列表分隔符作为项分隔符。
还可以使用 ConvertTo-Csv
和 ConvertFrom-Csv
cmdlet 将对象转换为 CSV 字符串, (并返回) 。 这些 cmdlet 与 Export-CSV
和 Import-Csv
cmdlet 相同,只是它们不处理文件。
如果 CSV 文件中的标题行条目包含空值或 null 值,则 PowerShell 将插入默认的标题行名称并显示警告消息。
Import-Csv
使用字节顺序标记 (BOM) 来检测文件的编码格式。 如果文件没有 BOM,则假定编码为 UTF8。
示例
示例 1:导入进程对象
此示例演示如何导出和导入进程对象的 CSV 文件。
Get-Process | Export-Csv -Path .\Processes.csv
$P = Import-Csv -Path .\Processes.csv
$P | Get-Member
TypeName: System.Management.Automation.PSCustomObject
Name MemberType Definition
---- ---------- ----------
Equals Method bool Equals(System.Object obj)
GetHashCode Method int GetHashCode()
GetType Method type GetType()
ToString Method string ToString()
BasePriority NoteProperty string BasePriority=8
Company NoteProperty string Company=Microsoft Corporation
...
$P | Format-Table
Name SI Handles VM WS PM NPM Path
---- -- ------- -- -- -- --- ----
ApplicationFrameHost 4 407 2199293489152 15884288 15151104 23792 C:\WINDOWS\system32\ApplicationFrameHost.exe
...
wininit 0 157 2199112204288 4591616 1630208 10376
winlogon 4 233 2199125549056 7659520 2826240 10992 C:\WINDOWS\System32\WinLogon.exe
WinStore.App 4 846 873435136 33652736 26607616 55432 C:\Program Files\WindowsApps\Microsoft.WindowsStore_11712.1001.13.0_x64__8weky...
WmiPrvSE 0 201 2199100219392 8830976 3297280 10632 C:\WINDOWS\system32\wbem\wmiprvse.exe
WmiPrvSE 0 407 2199157727232 18509824 12922880 16624 C:\WINDOWS\system32\wbem\wmiprvse.exe
WUDFHost 0 834 2199310204928 51945472 87441408 24984 C:\Windows\System32\WUDFHost.exe
cmdlet 将 Get-Process
管道中的进程对象发送到 Export-Csv
。 cmdlet Export-Csv
将进程对象转换为 CSV 字符串,并将字符串保存在 Processes.csv 文件中。 cmdlet Import-Csv
从 Processes.csv 文件导入 CSV 字符串。
字符串保存在 变量中 $P
。 变量 $P
在管道中向下发送到 Get-Member
cmdlet,该 cmdlet 显示导入的 CSV 字符串的属性。 变量 $P
在管道中向下发送到 Format-Table
cmdlet 并显示对象。
示例 2:指定分隔符
此示例演示如何使用 cmdlet 的 Import-Csv
Delimiter 参数。
Get-Process | Export-Csv -Path .\Processes.csv -Delimiter :
$P = Import-Csv -Path .\Processes.csv -Delimiter :
$P | Format-Table
cmdlet 将 Get-Process
管道中的进程对象发送到 Export-Csv
。 cmdlet Export-Csv
将进程对象转换为 CSV 字符串,并将字符串保存在 Processes.csv 文件中。
Delimiter 参数用于指定冒号分隔符。 cmdlet Import-Csv
从 Processes.csv 文件导入 CSV 字符串。 字符串保存在 变量中 $P
。 将 $P
变量向下发送到该 cmdlet 的 Format-Table
管道。
示例 3:指定分隔符的当前区域性
此示例演示如何将 Import-Csv
cmdlet 与 UseCulture 参数配合使用。
(Get-Culture).TextInfo.ListSeparator
Get-Process | Export-Csv -Path .\Processes.csv -UseCulture
Import-Csv -Path .\Processes.csv -UseCulture
cmdlet Get-Culture
使用嵌套属性 TextInfo 和 ListSeparator 获取当前区域性的默认列表分隔符。 cmdlet 将 Get-Process
管道中的进程对象发送到 Export-Csv
。 cmdlet Export-Csv
将进程对象转换为 CSV 字符串,并将字符串保存在 Processes.csv 文件中。 UseCulture 参数使用当前区域性的默认列表分隔符。 cmdlet Import-Csv
从 Processes.csv 文件导入 CSV 字符串。
示例 4:更改导入对象中的属性名称
此示例演示如何使用 的 Import-Csv
Header 参数更改生成的导入对象中的属性名称。
Start-Job -ScriptBlock { Get-Process } | Export-Csv -Path .\Jobs.csv -NoTypeInformation
$Header = 'State', 'MoreData', 'StatusMessage', 'Location', 'Command', 'StateInfo', 'Finished',
'InstanceId', 'Id', 'Name', 'ChildJobs', 'BeginTime', 'EndTime', 'JobType', 'Output', 'Error',
'Progress', 'Verbose', 'Debug', 'Warning', 'Information'
# Delete the default header from file
$A = Get-Content -Path .\Jobs.csv
$A = $A[1..($A.Count - 1)]
$A | Out-File -FilePath .\Jobs.csv
$J = Import-Csv -Path .\Jobs.csv -Header $Header
$J
State : Running
MoreData : True
StatusMessage :
Location : localhost
Command : Get-Process
StateInfo : Running
Finished : System.Threading.ManualResetEvent
InstanceId : a259eb63-6824-4b97-a033-305108ae1c2e
Id : 1
Name : Job1
ChildJobs : System.Collections.Generic.List`1[System.Management.Automation.Job]
BeginTime : 12/20/2018 18:59:57
EndTime :
JobType : BackgroundJob
Output : System.Management.Automation.PSDataCollection`1[System.Management.Automation.PSObject]
Error : System.Management.Automation.PSDataCollection`1[System.Management.Automation.ErrorRecord]
Progress : System.Management.Automation.PSDataCollection`1[System.Management.Automation.ProgressRecord]
Verbose : System.Management.Automation.PSDataCollection`1[System.Management.Automation.VerboseRecord]
Debug : System.Management.Automation.PSDataCollection`1[System.Management.Automation.DebugRecord]
Warning : System.Management.Automation.PSDataCollection`1[System.Management.Automation.WarningRecord]
Information : System.Management.Automation.PSDataCollection`1[System.Management.Automation.InformationRecord]
cmdlet Start-Job
启动运行 Get-Process
的后台作业。 作业对象在管道中向下发送到 Export-Csv
cmdlet,并转换为 CSV 字符串。 NoTypeInformation 参数从 CSV 输出中删除类型信息标头,在 PowerShell Core 中是可选的。
变量 $Header
包含替换以下默认值的自定义标头: HasMoreData、 JobStateInfo、 PSBeginTime、 PSEndTime 和 PSJobTypeName。 变量 $A
使用 Get-Content
cmdlet 从 Jobs.csv 文件获取 CSV 字符串。 变量 $A
用于从文件中删除默认标头。 cmdlet Out-File
将新版本的 Jobs.csv 文件保存在 变量中 $A
。 cmdlet Import-Csv
导入 Jobs.csv 文件,并使用 Header 参数应用变量 $Header
。 变量 $J
包含导入的 PSCustomObject ,并在 PowerShell 控制台中显示 对象。
示例 5:使用 CSV 文件Create自定义对象
此示例演示如何使用 CSV 文件在 PowerShell 中创建自定义对象。
Get-Content -Path .\Links.csv
113207,about_Aliases
113208,about_Arithmetic_Operators
113209,about_Arrays
113210,about_Assignment_Operators
113212,about_Automatic_Variables
113213,about_Break
113214,about_Command_Precedence
113215,about_Command_Syntax
144309,about_Comment_Based_Help
113216,about_CommonParameters
113217,about_Comparison_Operators
113218,about_Continue
113219,about_Core_Commands
113220,about_Data_Section
$A = Import-Csv -Path .\Links.csv -Header 'LinkID', 'TopicTitle'
$A | Get-Member
TypeName: System.Management.Automation.PSCustomObject
Name MemberType Definition
---- ---------- ----------
Equals Method bool Equals(System.Object obj)
GetHashCode Method int GetHashCode()
GetType Method type GetType()
ToString Method string ToString()
LinkID NoteProperty string LinkID=113207
TopicTitle NoteProperty string TopicTitle=about_Aliases
$A | Where-Object -Property TopicTitle -Like '*alias*'
LinkID TopicTitle
------ ----------
113207 about_Aliases
若要创建 Links.csv 文件,请使用输出中显示的 Get-Content
值。
cmdlet Get-Content
显示 Links.csv 文件。 cmdlet Import-Csv
导入 Links.csv 文件。 Header 参数指定属性名称 LinkId 和 TopicTitle。 对象存储在 变量中 $A
。 cmdlet Get-Member
显示 Header 参数中的属性名称。 cmdlet Where-Object
选择包含别名的 TopicTitle 属性的对象。
示例 6:导入缺少值的 CSV
此示例演示当 CSV 文件中的 Import-Csv
标题行包含 null 或空值时,PowerShell 中的 cmdlet 如何响应。 Import-Csv
替换缺少的标题行的默认名称,该行成为返回的对象 Import-Csv
的属性名称。
Get-Content -Path .\Projects.csv
ProjectID,ProjectName,,Completed
13,Inventory,Redmond,True
440,,FarEast,True
469,Marketing,Europe,False
Import-Csv -Path .\Projects.csv
WARNING: One or more headers were not specified. Default names starting with "H" have been used in place of any missing headers.
ProjectID ProjectName H1 Completed
--------- ----------- -- ---------
13 Inventory Redmond True
440 FarEast True
469 Marketing Europe False
(Import-Csv -Path .\Projects.csv).H1
WARNING: One or more headers were not specified. Default names starting with "H" have been used in place of any missing headers.
Redmond
FarEast
Europe
若要创建 Projects.csv 文件,请使用示例 Get-Content
输出中显示的值。
cmdlet Get-Content
显示 Projects.csv 文件。 标题行缺少 ProjectName 和 Completed 之间的值。 cmdlet Import-Csv
导入 Projects.csv 文件并显示一条警告消息,因为 H1 是默认标头名称。 命令 (Import-Csv -Path .\Projects.csv).H1
获取 H1 属性值并显示警告。
参数
-Delimiter
指定用于分隔 CSV 文件中的属性值的分隔符。 默认值为逗号 (,)。
输入一个字符,例如冒号 (:)。 若要指定分号 (;) 将其括在单引号中。
如果指定文件中实际字符串分隔符以外的字符, Import-Csv
则无法从 CSV 字符串创建对象,并且将返回 CSV 字符串。
Type: | Char |
Position: | 1 |
Default value: | comma (,) |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Encoding
指定目标文件的编码类型。 默认值为 Default。
此参数的可接受值如下所示:
- Ascii 使用 ASCII (7 位) 字符集。
- BigEndianUnicode 将 UTF-16 与 big-endian 字节顺序一起使用。
- 默认 使用与系统的活动代码页相对应的编码 (通常为 ANSI) 。
- Oem 使用对应于系统的当前 OEM 代码页的编码。
- Unicode 将 UTF-16 与 little-endian 字节顺序一起使用。
- UTF7 使用 UTF-7。
- UTF8 使用 UTF-8。
- UTF32 将 UTF-32 与 little-endian 字节顺序一起使用。
Type: | Encoding |
Accepted values: | ASCII, BigEndianUnicode, Default, OEM, Unicode, UTF7, UTF8, UTF32 |
Position: | Named |
Default value: | Default |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Header
为导入的文件指定备用列标题行。 列标题确定 由 Import-Csv
创建的 对象的属性名称。
以逗号分隔的列表的形式输入列标题。 不要将标头字符串括在引号内。 将每个列标题括在单引号中。
如果输入的列标题少于数据列,则会丢弃剩余的数据列。 如果输入的列标题多于数据列,则使用空数据列创建其他列标题。
使用 Header 参数时,从 CSV 文件中删除原始标题行。 否则, Import-Csv
从标题行中的项创建额外的 对象。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LiteralPath
指定要导入的 CSV 文件的路径。 与 Path 不同,LiteralPath 参数的值严格按照所键入的形式使用。 不会将任何字符解释为通配符。 如果路径包括转义符,请将其括在单引号中。 单引号告知 PowerShell 不要将任何字符解释为转义序列。
Type: | String[] |
Aliases: | PSPath |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Path
指定要导入的 CSV 文件的路径。
还可以通过管道将路径传递给 Import-Csv
。
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-UseCulture
使用当前区域性的列表分隔符作为项分隔符。 若要查找区域性的列表分隔符,请使用以下命令: (Get-Culture).TextInfo.ListSeparator
。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
输入
可以通过管道将包含路径的字符串传递给 Import-Csv
。
输出
Object
此 cmdlet 返回 CSV 文件中的内容所描述的对象。
备注
由于导入的对象是对象类型的 CSV 版本,因此无法由设置对象类型非 CSV 版本的 PowerShell 类型格式设置项识别和格式化。
命令的结果 Import-Csv
是构成类似表的自定义对象的字符串集合。 每一行都是一个单独的字符串,因此可以使用 对象的 Count 属性对表行进行计数。 这些列是对象的属性,行中的项是属性值。
列标题行确定了列数和列名称。 列名称也是对象的属性的名称。 第一行被解释为列标题,除非使用 Header 参数指定列标题。 如果任何行具有的值多于标题行,则忽略额外的值。
如果列标题行缺少值或包含 null 或空值, Import-Csv
则使用 H 后跟数字作为缺失的列标题和属性名称。
在 CSV 文件中,通过以逗号分隔的对象属性值列表来表示每个对象。 属性值通过使用 对象的 ToString () 方法转换为字符串,因此它们由属性值的名称表示。 Export-Csv
不导出 对象的方法。