Export-Csv
將物件轉換為一系列逗號分隔值 (CSV) 字串,並將這些字串保存到檔案中。
語法
Delimiter (預設值)
Export-Csv
[[-Path] <string>]
[[-Delimiter] <char>]
-InputObject <psobject>
[-LiteralPath <string>]
[-Force]
[-NoClobber]
[-Encoding <string>]
[-Append]
[-NoTypeInformation]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
UseCulture
Export-Csv
[[-Path] <string>]
-InputObject <psobject>
[-LiteralPath <string>]
[-Force]
[-NoClobber]
[-Encoding <string>]
[-Append]
[-UseCulture]
[-NoTypeInformation]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Export-CSV Cmdlet 會建立您所提交物件的 CSV 檔案。 每個物件都是一行,其中包含物件屬性值的逗號分隔清單。 您可以使用 Export-CSV Cmdlet 來建立電子錶格,並與接受 CSV 檔案作為輸入的程式共享數據。
請勿在將對象傳送至 Export-CSV Cmdlet 之前格式化物件。 如果 Export-CSV 收到格式化的物件,CSV 檔案會包含格式屬性,而不是物件屬性。 若要只匯出對象的選取屬性,請使用 Select-Object Cmdlet。
範例
範例 1:將進程屬性匯出至 CSV 檔案
此範例會選取具有特定屬性 Process 物件,並將對象匯出至 CSV 檔案。
Get-Process -Name WmiPrvSE | Select-Object -Property BasePriority,Id,SessionId,WorkingSet |
Export-Csv -Path .\WmiData.csv -NoTypeInformation
Import-Csv -Path .\WmiData.csv
BasePriority Id SessionId WorkingSet
------------ -- --------- ----------
8 976 0 20267008
8 2292 0 36786176
8 3816 0 30351360
8 8604 0 15011840
8 10008 0 8830976
8 11764 0 14237696
8 54632 0 9502720
Get-Process Cmdlet 會取得 Process 物件。
Name 參數會篩選輸出,只包含 WmiPrvSE 進程物件。 進程物件會向下傳送至 Select-Object Cmdlet。
Select-Object 會使用 Property 參數來選取進程物件屬性的子集。 進程物件會向下傳送至 Export-Csv Cmdlet。
Export-Csv 會將進程物件轉換成一系列 CSV 字串。
Path 參數指定 WmiData.csv 檔案儲存在當前目錄中。
NoTypeInformation 參數會從 CSV 輸出中移除 #TYPE 資訊標頭,而且 PowerShell 6 中不需要。
Import-Csv Cmdlet 會使用 Path 參數來顯示位於目前目錄中的檔案。
範例 2:將進程匯出至逗號分隔的檔案
這個範例會取得 Process 物件,並將對象匯出至 CSV 檔案。
Get-Process | Export-Csv -Path .\Processes.csv -NoTypeInformation
Get-Content -Path .\Processes.csv
"Name","SI","Handles","VM","WS","PM","NPM","Path","Parent","Company","CPU","FileVersion", ...
"ApplicationFrameHost","4","511","2203597099008","35364864","21979136","30048", ...
Get-Process Cmdlet 會取得 Process 物件。 進程物件會向下傳送至 Export-Csv Cmdlet。
Export-Csv 會將進程物件轉換成一系列 CSV 字串。
Path 參數指定 Processes.csv 檔案儲存在當前目錄中。
NoTypeInformation 參數會從 CSV 輸出中移除 #TYPE 資訊標頭,而且 PowerShell 6 中不需要。
Get-Content Cmdlet 會使用 Path 參數來顯示位於目前目錄中的檔案。
範例 3:將進程匯出至以分號分隔的檔案
本範例會取得 Process 物件,並將對象匯出至具有分號分隔符的檔案。
Get-Process | Export-Csv -Path .\Processes.csv -Delimiter ';' -NoTypeInformation
Get-Content -Path .\Processes.csv
"Name";"SI";"Handles";"VM";"WS";"PM";"NPM";"Path";"Parent";"Company";"CPU";"FileVersion"; ...
"ApplicationFrameHost";"4";"509";"2203595321344";"34807808";"21770240";"29504"; ...
Get-Process Cmdlet 會取得 Process 物件。 進程物件會向下傳送至 Export-Csv Cmdlet。
Export-Csv 會將進程物件轉換成一系列 CSV 字串。
Path 參數指定 Processes.csv 檔案儲存在當前目錄中。
Delimiter 參數會指定分號來分隔字串值。
NoTypeInformation 參數會從 CSV 輸出中移除 #TYPE 資訊標頭,而且 PowerShell 6 中不需要。
Get-Content Cmdlet 會使用 Path 參數來顯示位於目前目錄中的檔案。
範例 4:使用目前文化特性的清單分隔符匯出進程
這個範例會取得 Process 物件,並將對象匯出至檔案。 分隔符是目前文化特性的清單分隔符。
(Get-Culture).TextInfo.ListSeparator
Get-Process | Export-Csv -Path .\Processes.csv -UseCulture -NoTypeInformation
Get-Content -Path .\Processes.csv
"Name","SI","Handles","VM","WS","PM","NPM","Path","Parent","Company","CPU","FileVersion", ...
"ApplicationFrameHost","4","511","2203597099008","35364864","21979136","30048", ...
Get-Culture Cmdlet 會使用 TextInfo 巢狀屬性 和 ListSeparator,並顯示目前文化特性的預設清單分隔符。
Get-Process Cmdlet 會取得 Process 物件。
進程物件會向下傳送至 Export-Csv Cmdlet。
Export-Csv 會將進程物件轉換成一系列 CSV 字串。
Path 參數指定 Processes.csv 檔案儲存在當前目錄中。
UseCulture 參數會使用目前文化特性的預設清單分隔符作為分隔符。
NoTypeInformation 參數會從 CSV 輸出中移除 #TYPE 資訊標頭,而且 PowerShell 6 中不需要。
Get-Content Cmdlet 會使用 Path 參數來顯示位於目前目錄中的檔案。
範例 5:導出具有類型資訊的處理程式
此範例說明如何在 CSV 檔案中包含 #TYPE 標頭資訊。 #TYPE 標頭是PowerShell 6.0之前版本的預設。
Get-Process | Export-Csv -Path .\Processes.csv
Get-Content -Path .\Processes.csv
#TYPE System.Diagnostics.Process
"Name","SI","Handles","VM","WS","PM","NPM","Path","Company","CPU","FileVersion", ...
"ApplicationFrameHost","4","507","2203595001856","35139584","20934656","29504", ...
Get-Process Cmdlet 會取得 Process 物件。 進程物件會向下傳送至 Export-Csv Cmdlet。
Export-Csv 會將進程物件轉換成一系列 CSV 字串。
Path 參數指定 Processes.csv 檔案儲存在當前目錄中。
Get-Content Cmdlet 會使用 Path 參數來顯示位於目前目錄中的檔案。
範例 6:將物件匯出並附加至 CSV 檔案
此範例說明如何將對象匯出至 CSV 檔案,並使用 Append 參數將物件新增至現有的檔案。
$AppService = (Get-Service -DisplayName *Application* | Select-Object -Property DisplayName, Status)
$AppService | Export-Csv -Path .\Services.Csv -NoTypeInformation
Get-Content -Path .\Services.Csv
$WinService = (Get-Service -DisplayName *Windows* | Select-Object -Property DisplayName, Status)
$WinService | Export-Csv -Path ./Services.csv -NoTypeInformation -Append
Get-Content -Path .\Services.Csv
"DisplayName","Status"
"Application Layer Gateway Service","Stopped"
"Application Identity","Running"
"Windows Audio Endpoint Builder","Running"
"Windows Audio","Running"
"Windows Event Log","Running"
Get-Service Cmdlet 會取得服務物件。
DisplayName 參數會傳回包含 Application 一字的服務。 服務物件會向下傳送至 Select-Object Cmdlet。
Select-Object 會使用 Property 參數來指定 DisplayName 和 Status 属性。
$AppService 變數會儲存物件。
$AppService 物件會從管線向下傳送至 Export-Csv Cmdlet。
Export-Csv 會將服務對象轉換成一系列 CSV 字串。
Path 參數指定 Services.csv 檔案儲存在當前目錄中。
NoTypeInformation 參數會從 CSV 輸出中移除 #TYPE 資訊標頭,而且 PowerShell 6 中不需要。
Get-Content Cmdlet 會使用 Path 參數來顯示位於目前目錄中的檔案。
包含 Windows 字組的服務會重複 Get-Service 和 Select-Object Cmdlet。
$WinService 變數會儲存服務物件。 cmdlet Export-Csv 使用 Append 參數指定 $WinService 將物件添加到現有 Services.csv 檔中。
Get-Content Cmdlet 會重複顯示包含附加資料的更新檔案。
範例 7:在管線內格式化 Cmdlet 會建立非預期的結果
此範例示範為何在管線內不要使用格式 Cmdlet 很重要。 收到非預期的輸出時,請針對管線語法進行疑難解答。
Get-Date | Select-Object -Property DateTime, Day, DayOfWeek, DayOfYear |
Export-Csv -Path .\DateTime.csv -NoTypeInformation
Get-Content -Path .\DateTime.csv
"DateTime","Day","DayOfWeek","DayOfYear"
"Wednesday, January 2, 2019 14:59:34","2","Wednesday","2"
Get-Date | Format-Table -Property DateTime, Day, DayOfWeek, DayOfYear |
Export-Csv -Path .\FTDateTime.csv -NoTypeInformation
Get-Content -Path .\FTDateTime.csv
"ClassId2e4f51ef21dd47e99d3c952918aff9cd","pageHeaderEntry","pageFooterEntry","autosizeInfo", ...
"033ecb2bc07a4d43b5ef94ed5a35d280",,,,"Microsoft.PowerShell.Commands.Internal.Format. ...
"9e210fe47d09416682b841769c78b8a3",,,,,
"27c87ef9bbda4f709f6b4002fa4af63c",,,,,
"4ec4f0187cb04f4cb6973460dfe252df",,,,,
"cf522b78d86c486691226b40aa69e95c",,,,,
Get-Date Cmdlet 會取得 DateTime 物件。 物件會向下傳送至 Select-Object Cmdlet。
Select-Object 使用 Property 參數來選取物件屬性的子集。 物件會向下傳送至 Export-Csv Cmdlet。
Export-Csv 將 物件轉換成 CSV 格式。
Path 參數指定 DateTime.csv 檔案儲存在當前目錄中。
NoTypeInformation 參數會從 CSV 輸出中移除 #TYPE 資訊標頭,而且 PowerShell 6 中不需要。
Get-Content Cmdlet 會使用 Path 參數來顯示位於目前目錄中的 CSV 檔案。
當管線內使用 Format-Table Cmdlet 來選取收到非預期結果的屬性時。
Format-Table 會將數據表格式物件向下傳送至 Export-Csv Cmdlet,而不是 DateTime 物件。
Export-Csv 會將數據表格式物件轉換成一系列 CSV 字串。
Get-Content Cmdlet 會顯示 CSV 檔案,其中包含資料表格式物件。
範例 8:使用 Force 參數覆寫唯讀檔案
此範例會建立空的唯讀檔案,並使用 Force 參數來更新檔案。
New-Item -Path .\ReadOnly.csv -ItemType File
Set-ItemProperty -Path .\ReadOnly.csv -Name IsReadOnly -Value $true
Get-Process | Export-Csv -Path .\ReadOnly.csv -NoTypeInformation
Export-Csv : Access to the path 'C:\ReadOnly.csv' is denied.
At line:1 char:15
+ Get-Process | Export-Csv -Path .\ReadOnly.csv -NoTypeInformation
+ ~~~~~~~~~~~~~~~~~~~~~~~~
+ CategoryInfo : OpenError: (:) [Export-Csv], UnauthorizedAccessException
+ FullyQualifiedErrorId : FileOpenFailure,Microsoft.PowerShell.Commands.ExportCsvCommand
Get-Process | Export-Csv -Path .\ReadOnly.csv -NoTypeInformation -Force
Get-Content -Path .\ReadOnly.csv
"Name";"SI";"Handles";"VM";"WS";"PM";"NPM";"Path";"Parent";"Company";"CPU";"FileVersion"; ...
"ApplicationFrameHost";"4";"509";"2203595321344";"34807808";"21770240";"29504"; ...
cmdlet New-Item 使用 Path 和 ItemType 參數在當前目錄中創建 ReadOnly.csv 檔。
Set-ItemProperty Cmdlet 會使用 Name 和 Value 參數,將檔案的 IsReadOnly 屬性變更為 true。
Get-Process Cmdlet 會取得 Process 物件。 進程物件會向下傳送至 Export-Csv Cmdlet。
Export-Csv 會將進程物件轉換成一系列 CSV 字串。
Path 參數指定 ReadOnly.csv 檔案儲存在當前目錄中。
NoTypeInformation 參數會從 CSV 輸出中移除 #TYPE 資訊標頭,而且 PowerShell 6 中不需要。 輸出顯示檔案未寫入,因為存取遭到拒絕。
Force 參數會新增至 Export-Csv Cmdlet,以強制匯出寫入檔案。
Get-Content Cmdlet 會使用 Path 參數來顯示位於目前目錄中的檔案。
範例 9:搭配 Append 使用 Force 參數
此範例示範如何使用 Force 和 Append 參數。 結合這些參數時,可以將不相符的物件屬性寫入 CSV 檔案。
$Content = [PSCustomObject]@{Name = 'PowerShell Core'; Version = '6.0'}
$Content | Export-Csv -Path .\ParmFile.csv -NoTypeInformation
$AdditionalContent = [PSCustomObject]@{Name = 'Windows PowerShell'; Edition = 'Desktop'}
$AdditionalContent | Export-Csv -Path .\ParmFile.csv -NoTypeInformation -Append
Export-Csv : Cannot append CSV content to the following file: ParmFile.csv.
The appended object does not have a property that corresponds to the following column:
Version. To continue with mismatched properties, add the -Force parameter, and then retry
the command.
At line:1 char:22
+ $AdditionalContent | Export-Csv -Path .\ParmFile.csv -NoTypeInformation -Append
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ CategoryInfo : InvalidData: (Version:String) [Export-Csv], InvalidOperationException
+ FullyQualifiedErrorId : CannotAppendCsvWithMismatchedPropertyNames,Microsoft.PowerShell. ...
$AdditionalContent | Export-Csv -Path .\ParmFile.csv -NoTypeInformation -Append -Force
Import-Csv -Path .\ParmFile.csv
Name Version
---- -------
PowerShell Core 6.0
Windows PowerShell
表達式會使用 Name 和 Version 屬性,建立 PSCustomObject。 這些值會儲存在 $Content 變數中。
$Content 變數會向下傳送至 Export-Csv Cmdlet。
Export-Csv 使用 Path 參數並將 ParmFile.csv 檔案儲存在當前目錄中。
NoTypeInformation 參數會從 CSV 輸出中移除 #TYPE 資訊標頭,而且 PowerShell 6 中不需要。
另一個表達式會使用 Name 和 Edition 屬性來建立 PSCustomObject。 這些值會儲存在 $AdditionalContent 變數中。
$AdditionalContent 變數會向下傳送至 Export-Csv Cmdlet。
Append 參數可用來將數據新增至檔案。 附加失敗,因為 Version 與 Edition之間有屬性名稱不符。
Export-Csv Cmdlet Force 參數是用來強制匯出寫入檔案。 會捨棄 Edition 屬性。
Import-Csv Cmdlet 會使用 Path 參數來顯示位於目前目錄中的檔案。
參數
-Append
使用此參數,Export-CSV 將 CSV 輸出新增至指定檔案的結尾。 如果沒有此參數,Export-CSV 會取代檔案內容而不發出警告。
此參數是在 Windows PowerShell 3.0 中引進的。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Confirm
在執行 Cmdlet 之前,提示您進行確認。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | cf |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Delimiter
指定要分隔屬性值的分隔符。 預設值為逗號 (,)。 輸入字元,例如冒號(:)。 若要指定分號 (;),請以引弧括住它。
參數屬性
| 類型: | Char |
| 預設值: | comma (,) |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Delimiter
| Position: | 1 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Encoding
指定目標檔案的編碼類型。 預設值為 ASCII。
此參數可接受的值如下:
- ASCII 使用 ASCII (7 位) 字元集。
- BigEndianUnicode 使用 UTF-16 與 big-endian 位元組順序。
- 預設 使用對應至系統使用中代碼頁的編碼方式(通常是 ANSI)。
- OEM 使用對應至系統目前 OEM 代碼頁的編碼方式。
- Unicode 使用 UTF-16 搭配位元組順序。
- UTF7 使用 UTF-7。
- UTF8 使用 UTF-8。
- UTF32 使用 UTF-32 搭配位元組順序。
參數屬性
| 類型: | String |
| 預設值: | ASCII |
| 接受的值: | ASCII, BigEndianUnicode, Default, OEM, Unicode, UTF7, UTF8, UTF32 |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Force
此參數允許 Export-Csv 使用 只讀 屬性覆寫檔案。
當 Force 和 Append 參數合併時,包含不相符屬性的物件可以寫入 CSV 檔案。 只有相符的屬性會寫入檔案。 不相符的屬性會被捨棄。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-InputObject
指定要匯出為 CSV 字串的物件。 輸入包含 物件的變數,或輸入取得物件的命令或表達式。 您也可以使用管線將物件傳送至 Export-CSV。
參數屬性
| 類型: | PSObject |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-LiteralPath
指定 CSV 輸出檔案的路徑。 不同於 Path,LiteralPath 參數的值完全按照輸入的方式使用。 不會將任何字元解譯為通配符。 如果路徑包含逸出字元,請使用單引號。 單引號會告知PowerShell不要將任何字元解譯為逸出序列。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | PSPath |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-NoClobber
使用此參數,讓 Export-CSV 不會覆寫現有的檔案。 根據預設,如果檔案存在於指定的路徑中,Export-CSV 會覆寫檔案而不發出警告。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | NoOverwrite |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-NoTypeInformation
從輸出中移除 #TYPE 資訊標頭。 此參數成為 PowerShell 6.0 中的預設值,並包含在回溯相容性中。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | NTI |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Path
必要參數,指定要儲存 CSV 輸出檔案的位置。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 0 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-UseCulture
使用針對目前文化環境的清單分隔符作為項目分隔符。 若要尋找文化特性的清單分隔符,請使用下列命令:(Get-Culture).TextInfo.ListSeparator。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
UseCulture
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-WhatIf
防止 Cmdlet 處理或進行變更。 輸出會顯示執行 Cmdlet 時會發生什麼情況。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 無線 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。
輸入
PSObject
可以使用延伸類型系統 (ETS) 適配器將任何物件通過管道傳輸到 Export-CSV。
輸出
String
CSV 清單將發送到Path參數中指定的檔案。
備註
Export-CSV Cmdlet 會將您送出的物件轉換成一系列 CSV 字串,並將其儲存在指定的文本檔中。 您可以使用 Export-CSV 將物件儲存在 CSV 檔案中,然後使用 Import-Csv Cmdlet 從 CSV 檔案建立物件。
在 CSV 檔中,每個物件都由物件的屬性值的逗號分隔清單表示。 屬性值會使用 ToString() 方法轉換成字串。 字串會以屬性值名稱表示。 'Export-CSV 不會匯出 物件的方法。
CSV 字串會輸出如下:
- 根據預設,第一個字串包含 #TYPE 資訊標頭,後面接著物件類型的完整名稱。 例如,#TYPE System.Diagnostics.Process。
- 如果使用 NoTypeInformation,則第一個字串會包含數據行標頭。 標頭包含第一個物件的屬性名稱做為逗號分隔清單。
- 其餘字串包含每個物件的屬性值逗號分隔清單。
當您將多個物件提交至 Export-CSV時,Export-CSV 會根據您送出之第一個對象的屬性來組織檔案。 如果其餘對象沒有其中一個指定的屬性,該對象的屬性值為 null,以兩個連續逗號表示。 如果其餘物件有其他屬性,這些屬性值就不會包含在檔案中。
您可以使用 Import-Csv Cmdlet,從檔案中的 CSV 字串重新建立物件。 產生的物件是原始物件的 CSV 版本,這些物件是由屬性值的字串表示和沒有方法所組成。
ConvertTo-Csv 和 ConvertFrom-Csv Cmdlet 會將物件轉換成 CSV 字串,以及從 CSV 字串。
Export-CSV 與 ConvertTo-CSV相同,不同之處在於它會將 CSV 字串儲存在檔案中。