共用方式為


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 參數來指定 DisplayNameStatus 属性。 $AppService 變數會儲存物件。

$AppService 物件會從管線向下傳送至 Export-Csv Cmdlet。 Export-Csv 會將服務對象轉換成一系列 CSV 字串。 Path 參數指定 Services.csv 檔案儲存在當前目錄中。 NoTypeInformation 參數會從 CSV 輸出中移除 #TYPE 資訊標頭,而且 PowerShell 6 中不需要。 Get-Content Cmdlet 會使用 Path 參數來顯示位於目前目錄中的檔案。

包含 Windows 字組的服務會重複 Get-ServiceSelect-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 使用 PathItemType 參數在當前目錄中創建 ReadOnly.csv 檔。 Set-ItemProperty Cmdlet 會使用 NameValue 參數,將檔案的 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 參數

此範例示範如何使用 ForceAppend 參數。 結合這些參數時,可以將不相符的物件屬性寫入 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

表達式會使用 NameVersion 屬性,建立 PSCustomObject。 這些值會儲存在 $Content 變數中。 $Content 變數會向下傳送至 Export-Csv Cmdlet。 Export-Csv 使用 Path 參數並將 ParmFile.csv 檔案儲存在當前目錄中。 NoTypeInformation 參數會從 CSV 輸出中移除 #TYPE 資訊標頭,而且 PowerShell 6 中不需要。

另一個表達式會使用 NameEdition 屬性來建立 PSCustomObject。 這些值會儲存在 $AdditionalContent 變數中。 $AdditionalContent 變數會向下傳送至 Export-Csv Cmdlet。 Append 參數可用來將數據新增至檔案。 附加失敗,因為 VersionEdition之間有屬性名稱不符。

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 使用 只讀 屬性覆寫檔案。

ForceAppend 參數合併時,包含不相符屬性的物件可以寫入 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 輸出檔案的路徑。 不同於 PathLiteralPath 參數的值完全按照輸入的方式使用。 不會將任何字元解譯為通配符。 如果路徑包含逸出字元,請使用單引號。 單引號會告知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-CsvConvertFrom-Csv Cmdlet 會將物件轉換成 CSV 字串,以及從 CSV 字串。 Export-CSVConvertTo-CSV相同,不同之處在於它會將 CSV 字串儲存在檔案中。