Import-Csv

參考

模組:: Microsoft.PowerShell.Utility

從字元分隔值（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>]

Description

Import-Csv Cmdlet 會從 CSV 檔案中的專案建立類似數據表的自定義物件。 CSV 檔案中的每個資料行都會成為自定義物件的屬性，而數據列中的專案會變成屬性值。 Import-Csv 適用於任何 CSV 檔案，包括由 Export-Csv Cmdlet 產生的檔案。

您可以使用 Import-Csv Cmdlet 的參數來指定資料行行首列和專案分隔符，或直接 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

Get-Process Cmdlet 會將行程物件向下傳送至 Export-Csv。 Export-Csv Cmdlet 會將進程物件轉換成 CSV 字串，並將字串儲存在 Processes.csv 檔案中。 Import-Csv Cmdlet 會從 Processes.csv 檔案匯入 CSV 字串。字串會儲存在 $P 變數中。 $P 變數會向下傳送至 Get-Member Cmdlet，以顯示匯入 CSV 字串的屬性。 $P 變數會向下傳送至 Format-Table Cmdlet，並顯示物件。

範例 2：指定分隔符

此範例示範如何使用 Import-Csv Cmdlet 的 Delimiter 參數。

Get-Process | Export-Csv -Path .\Processes.csv -Delimiter :
$P = Import-Csv -Path .\Processes.csv -Delimiter :
$P | Format-Table

Get-Process Cmdlet 會將行程物件傳送至管線，以 Export-Csv。 Export-Csv Cmdlet 會將進程物件轉換成 CSV 字串，並將字串儲存在 Processes.csv 檔案中。 Delimiter 參數可用來指定冒號分隔符。 Import-Csv Cmdlet 會從 Processes.csv 檔案匯入 CSV 字串。字串會儲存在 $P 變數中。若要 $P 變數，會將管線向下傳送至 Format-Table Cmdlet。

範例 3：指定分隔符的目前文化特性

此範例示範如何使用 Import-Csv Cmdlet 搭配 UseCulture 參數。

(Get-Culture).TextInfo.ListSeparator
Get-Process | Export-Csv -Path .\Processes.csv -UseCulture
Import-Csv -Path .\Processes.csv -UseCulture

Get-Culture Cmdlet 會使用 TextInfo 和 ListSeparator 的巢狀 屬性來取得目前文化特性的預設清單分隔符。 Get-Process Cmdlet 會將行程物件傳送至管線，以 Export-Csv。 Export-Csv Cmdlet 會將進程物件轉換成 CSV 字串，並將字串儲存在 Processes.csv 檔案中。 UseCulture 參數會使用目前文化特性的預設清單分隔符。 Import-Csv Cmdlet 會從 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]

Start-Job Cmdlet 會啟動執行 Get-Process的背景作業。作業物件會將管線向下傳送至 Export-Csv Cmdlet，並轉換成 CSV 字串。 NoTypeInformation 參數會從 CSV 輸出中移除類型資訊標頭，而且在 PowerShell v6 和更新版本中是選擇性的。 $Header 變數包含取代下列預設值的自定義標頭：HasMoreData、JobStateInfo、PSBeginTime、PSEndTime和 PSJobTypeName。 $A 變數會使用 Get-Content Cmdlet 從 Jobs.csv 檔案取得 CSV 字串。 $A 變數可用來從檔案中移除預設標頭。 Out-File Cmdlet 會將新版本的 Jobs.csv 檔案儲存在 $A 變數中。 Import-Csv Cmdlet 會匯入 Jobs.csv 檔案，並使用 Header 參數來套用 $Header 變數。 $J 變數包含匯入 PSCustomObject，並在 PowerShell 控制台中顯示物件。

範例 5：使用 CSV 檔案建立自定義物件

此範例示範如何使用 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 輸出中顯示的值。

Get-Content Cmdlet 會顯示 Links.csv 檔案。 Import-Csv Cmdlet 會匯入 Links.csv 檔案。 Header 參數會指定 LinkId 和 TopicTitle的屬性 名稱。物件會儲存在 $A 變數中。 Get-Member Cmdlet 會顯示來自 Header 參數的屬性名稱。 Where-Object Cmdlet 會使用包含別名的 TopicTitle 屬性來選取物件。

範例 6：匯入遺漏值的 CSV

此範例示範當 CSV 檔案中的標頭數據列包含 Null 或空白值時，PowerShell 中的 Import-Csv 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 weren't 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

Get-Content Cmdlet 會顯示 Projects.csv 檔案。標頭數據列遺漏了 ProjectName 與 Completed 之間的值。 Import-Csv Cmdlet 會匯入 Projects.csv 檔案，並顯示警告訊息，因為 H1 是預設標頭名稱。

參數

-Delimiter

指定分隔符，分隔 CSV 檔案中的屬性值。預設值為逗號（,）。

輸入字元，例如冒號（:）。若要指定分號（;），請以單引弧括住它。若要指定逸出的特殊字元，例如製表元（`t），請以雙引弧括住它。

如果您指定檔案中實際字串分隔符以外的字元，Import-Csv 無法從 CSV 字串建立物件，並傳回完整的 CSV 字串串。

類型:	Char
Position:	1
預設值:	comma (,)
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Encoding

指定目標檔案的編碼類型。預設值為 Default。

此參數可接受的值如下：

ASCII 使用 ASCII （7 位）字元集。
BigEndianUnicode 使用 UTF-16 與 big-endian 位元節順序。
Default 使用對應至系統使用中代碼頁的編碼方式（通常是 ANSI）。
OEM 使用對應至系統目前 OEM 代碼頁的編碼方式。
Unicode 使用UTF-16搭配位元組順序。
UTF7 使用UTF-7。
UTF8 使用UTF-8。
UTF32 使用UTF-32搭配位元組順序。

類型:	String
接受的值:	ASCII, BigEndianUnicode, Default, OEM, Unicode, UTF7, UTF8, UTF32
Position:	Named
預設值:	Default
必要:	False
接受管線輸入:	False
接受萬用字元:	False

指定匯入檔案的替代數據行行首數據列。數據行標頭會決定 Import-Csv所建立之物件的屬性名稱。

輸入數據行標頭做為字元分隔清單。請勿以引號括住標頭字串。以單引弧括住每個數據行標頭。

如果您輸入的數據行標頭比有數據行少，則會捨棄其餘的數據行。如果您輸入的數據行標頭數目超過數據行，則會使用空白數據行來建立其他數據行標頭。

使用 Header 參數時，請從 CSV 檔案中刪除原始標頭數據列。否則，Import-Csv 會從標頭數據列中的專案建立額外的物件。

類型:	String[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-LiteralPath

指定要匯入的 CSV 檔案路徑。與 Path不同，LiteralPath 參數的值會與類型完全相同。不會將任何字元解譯為通配符。如果路徑包含逸出字元，請以單引弧括住它。單引號會告知PowerShell不要將任何字元解譯為逸出序列。

類型:	String[]
別名:	PSPath
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-Path

指定要匯入的 CSV 檔案路徑。您也可以使用管線將路徑傳送至 Import-Csv。

類型:	String[]
Position:	0
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-UseCulture

使用目前文化特性的清單分隔符做為專案分隔符。若要尋找文化特性的清單分隔符，請使用下列命令：(Get-Culture).TextInfo.ListSeparator。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

輸入

String

您可以使用管線傳送包含此 Cmdlet 路徑的字串。

輸出

Object

此 Cmdlet 會傳回 CSV 檔案中內容所描述的物件。

備註

Windows PowerShell 包含下列 Import-Csv別名：

ipcsv

因為匯入的對像是物件類型的 CSV 版本，所以無法辨識這些物件，而且無法由格式化非 CSV 物件類型的 PowerShell 類型格式化專案格式化。

Import-Csv 命令的結果是構成類似數據表的自定義物件的字串集合。每個數據列都是個別的字串，因此您可以使用物件的 Count 屬性來計算數據表數據列。數據行是對象的屬性，而數據列中的專案是屬性值。

數據行行首數據列會決定數據行數目和數據行名稱。數據行名稱也是物件屬性的名稱。除非您使用 Header 參數來指定數據行標頭，否則第一個數據列會解譯為數據行標頭。如果有任何數據列的值超過標頭數據列，則會忽略其他值。

如果數據行標頭數據列遺漏值或包含 null 或空白值，Import-Csv 會使用 H 後面接著遺漏數據行標頭和屬性名稱的數位。

在 CSV 檔案中，每個物件都會以物件屬性值的字元分隔清單來表示。屬性值會使用物件的 ToString（） 方法轉換成字串，因此會以屬性值的名稱表示。 Export-Csv 不會匯出物件的方法。

共用方式為

Import-Csv

語法

Description

範例

範例 1：匯入進程物件

範例 2：指定分隔符

範例 3：指定分隔符的目前文化特性

範例 4：變更匯入物件中的屬性名稱

範例 5：使用 CSV 檔案建立自定義物件

範例 6：匯入遺漏值的 CSV

參數

-Delimiter

-Encoding

-Header

-LiteralPath

-Path

-UseCulture

輸入

輸出

備註

其他資源

共用方式為

Import-Csv

語法

Description

範例

範例 1：匯入進程物件

範例 2：指定分隔符

範例 3：指定分隔符的目前文化特性

範例 4：變更匯入物件中的屬性名稱

範例 5：使用 CSV 檔案建立自定義物件

範例 6：匯入遺漏值的 CSV

參數

-Delimiter

-Encoding

-Header

-LiteralPath

-Path

-UseCulture

輸入

輸出

備註

相關連結

其他資源