Export-Csv

參考

模組:: Microsoft.PowerShell.Utility

將物件轉換成一系列的字元分隔值， (CSV) 字串，並將字串儲存至檔案。

Syntax

Export-Csv
      -InputObject <PSObject>
      [[-Path] <String>]
      [-LiteralPath <String>]
      [-Force]
      [-NoClobber]
      [-Encoding <Encoding>]
      [-Append]
      [[-Delimiter] <Char>]
      [-IncludeTypeInformation]
      [-NoTypeInformation]
      [-QuoteFields <String[]>]
      [-UseQuotes <QuoteKind>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Export-Csv
      -InputObject <PSObject>
      [[-Path] <String>]
      [-LiteralPath <String>]
      [-Force]
      [-NoClobber]
      [-Encoding <Encoding>]
      [-Append]
      [-UseCulture]
      [-IncludeTypeInformation]
      [-NoTypeInformation]
      [-QuoteFields <String[]>]
      [-UseQuotes <QuoteKind>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Cmdlet Export-CSV 會建立您所提交物件的 CSV 檔案。每個物件都是一個數據列，其中包含物件屬性值的字元分隔清單。您可以使用 Export-CSV Cmdlet 來建立電子錶格，並與接受 CSV 檔案作為輸入的程式共享數據。

不要在將對象傳送至 Export-CSV Cmdlet 之前格式化物件。如果 Export-CSV 收到格式化的物件，則 CSV 檔案會包含格式屬性，而不是物件屬性。若要只匯出對象的選取屬性，請使用 Select-Object Cmdlet。

範例

範例 1：將進程屬性匯出至 CSV 檔案

本範例會選取 [ 處理具有特定屬性的物件]，將對象匯出至 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

Cmdlet Get-Process 會取得 Process 物件。 Name 參數會篩選輸出，只包含 WmiPrvSE 進程物件。進程物件會從管線向下傳送至 Select-Object Cmdlet。 Select-Object 會使用 Property 參數來選取進程物件屬性的子集。進程物件會從管線向下傳送至 Export-Csv Cmdlet。 Export-Csv 將進程物件轉換成一系列的 CSV 字串。 Path 參數會指定檔案WmiData.csv儲存在目前目錄中。 NoTypeInformation 參數會從 CSV 輸出中移除 #TYPE 資訊標頭，而且 PowerShell 6 中不需要。 Cmdlet Import-Csv 會使用 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", ...

Cmdlet Get-Process 會取得 Process 物件。進程物件會從管線向下傳送至 Export-Csv Cmdlet。 Export-Csv 將進程物件轉換成一系列的 CSV 字串。 Path 參數會指定檔案Processes.csv儲存在目前目錄中。 NoTypeInformation 參數會從 CSV 輸出中移除 #TYPE 資訊標頭，而且 PowerShell 6 中不需要。 Cmdlet Get-Content 會使用 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"; ...

Cmdlet Get-Process 會取得 Process 物件。進程物件會從管線向下傳送至 Export-Csv Cmdlet。 Export-Csv 將進程物件轉換成一系列的 CSV 字串。 Path 參數會指定檔案Processes.csv儲存在目前目錄中。 分隔符參數會指定要分隔字串值的分號。 NoTypeInformation 參數會從 CSV 輸出中移除 #TYPE 資訊標頭，而且 PowerShell 6 中不需要。 Cmdlet Get-Content 會使用 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", ...

Cmdlet Get-Culture 會使用巢狀屬性 TextInfo 和 ListSeparator ，並顯示目前文化特性的預設清單分隔符。 Cmdlet Get-Process 會取得 Process 物件。進程物件會從管線向下傳送至 Export-Csv Cmdlet。 Export-Csv 將進程物件轉換成一系列的 CSV 字串。 Path 參數會指定檔案Processes.csv儲存在目前目錄中。 UseCulture 參數會使用目前文化特性的預設清單分隔符作為分隔符。 NoTypeInformation 參數會從 CSV 輸出中移除 #TYPE 資訊標頭，而且 PowerShell 6 中不需要。 Cmdlet Get-Content 會使用 Path 參數來顯示位於目前目錄中的檔案。

範例 5：導出具有類型資訊的處理程式

此範例說明如何在 CSV 檔案中包含 #TYPE 標頭資訊。 #TYPE 標頭是 PowerShell 6.0 之前的版本預設值。

Get-Process | Export-Csv -Path .\Processes.csv -IncludeTypeInformation
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", ...

Cmdlet Get-Process 會取得 Process 物件。進程物件會從管線向下傳送至 Export-Csv Cmdlet。 Export-Csv 將進程物件轉換成一系列的 CSV 字串。 Path 參數會指定檔案Processes.csv儲存在目前目錄中。 IncludeTypeInformation 包含 CSV 輸出中 #TYPE 資訊標頭。 Cmdlet Get-Content 會使用 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"

Cmdlet Get-Service 會取得服務物件。 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 中不需要。 Cmdlet Get-Content 會使用 Path 參數來顯示位於目前目錄中的檔案。

Get-Service和 Select-Object Cmdlet 會針對包含 Windows 一詞的服務重複執行。變數 $WinService 會儲存服務物件。 Cmdlet Export-Csv 會使用 Append 參數來 $WinService 指定物件新增至現有的 Services.csv 檔案。 Cmdlet Get-Content 會重複顯示包含附加數據的更新檔案。

範例 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",,,,,

Cmdlet Get-Date 會取得 DateTime 物件。物件會從管線向下傳送至 Select-Object Cmdlet。 Select-Object 會使用 Property 參數來選取物件屬性的子集。物件會從管線向下傳送至 Export-Csv Cmdlet。 Export-Csv 將物件轉換成 CSV 格式。 Path 參數會指定檔案DateTime.csv儲存在目前目錄中。 NoTypeInformation 參數會從 CSV 輸出中移除 #TYPE 資訊標頭，而且 PowerShell 6 中不需要。 Cmdlet Get-Content 會使用 Path 參數來顯示位於目前目錄中的 CSV 檔案。

當管 Format-Table 線內使用 Cmdlet 來選取收到非預期結果的屬性時。 Format-Table 將數據表格式物件向下傳送至 Cmdlet， Export-Csv 而不是 DateTime 物件。 Export-Csv 將數據表格式物件轉換成一系列 CSV 字串。 Cmdlet Get-Content 會顯示包含資料表格式物件的 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 檔案。 Cmdlet Set-ItemProperty 會使用 Name 和 Value 參數，將檔案的 IsReadOnly 屬性變更為 true。 Cmdlet Get-Process 會取得 Process 物件。進程物件會從管線向下傳送至 Export-Csv Cmdlet。 Export-Csv 將進程物件轉換成一系列的 CSV 字串。 Path 參數會指定檔案ReadOnly.csv儲存在目前目錄中。 NoTypeInformation 參數會從 CSV 輸出中移除 #TYPE 資訊標頭，而且 PowerShell 6 中不需要。輸出會顯示檔案未寫入，因為存取遭到拒絕。

Force 參數會新增至 Export-Csv Cmdlet，以強制匯出寫入檔案。 Cmdlet Get-Content 會使用 Path 參數來顯示位於目前目錄中的檔案。

範例 9：搭配 Append 使用 Force 參數

此範例示範如何使用 Force 和 Append 參數。結合這些參數時，可以將不相符的物件屬性寫入 CSV 檔案。

$Content = [PSCustomObject]@{Name = 'PowerShell'; Version = '7.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         7.0
Windows PowerShell

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

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

Export-Csv Cmdlet Force 參數可用來強制導出寫入檔案。已捨棄 Edition 屬性。 Cmdlet Import-Csv 會使用 Path 參數來顯示位於目前目錄中的檔案。

範例 10：匯出至 CSV，其中包含兩個數據行的引號

本範例會將 DateTime 物件轉換為 CSV 字串。

Get-Date | Export-Csv  -QuoteFields "DateTime","Date" -Path .\FTDateTime.csv
Get-Content -Path .\FTDateTime.csv

DisplayHint,"DateTime","Date",Day,DayOfWeek,DayOfYear,Hour,Kind,Millisecond,Minute,Month,Second,Ticks,TimeOfDay,Year
DateTime,"Thursday, August 22, 2019 11:27:34 AM","8/22/2019 12:00:00 AM",22,Thursday,234,11,Local,569,27,8,34,637020700545699784,11:27:34.5699784,2019

範例 11：僅在需要時使用引號導出至 CSV

本範例會將 DateTime 物件轉換為 CSV 字串。

Get-Date | Export-Csv  -UseQuotes AsNeeded -Path .\FTDateTime.csv
Get-Content -Path .\FTDateTime.csv

DisplayHint,DateTime,Date,Day,DayOfWeek,DayOfYear,Hour,Kind,Millisecond,Minute,Month,Second,Ticks,TimeOfDay,Year
DateTime,"Thursday, August 22, 2019 11:31:00 AM",8/22/2019 12:00:00 AM,22,Thursday,234,11,Local,713,31,8,0,637020702607132640,11:31:00.7132640,2019

範例 12：將哈希表轉換成 CSV

在 PowerShell 7.2 和更新版本中，當您將哈希表導出至 CSV 時，第一個哈希表的索引鍵會串行化並當做 csv 檔案輸出中的標頭使用。

$person1 = @{
    Name = 'John Smith'
    Number = 1
}

$person2 = @{
    Name = 'Jane Smith'
    Number = 1
}

$allPeople = $person1, $person2
$allPeople | Export-Csv -Path .\People.csv

Get-Content -Path .\People.csv

"Name","Number"
"John Smith","1"
"Jane Smith","2"

範例 13：使用其他屬性將哈希表轉換為 CSV

在 PowerShell 7.2 和更新版本中，當您匯出已新增 Add-Member 其他屬性的哈希表時，也會 Select-Object 在 CSV 檔案中新增其他屬性作為標頭。

$allPeople | Add-Member -Name ExtraProp -Value 42 -MemberType NoteProperty
$allPeople | Export-Csv -Path .\People.csv

Get-Content -Path .\People.csv

"Name","Number","ExtraProp"
"John Smith","1","42"
"Jane Smith","2","42"

每個哈希表都有一 ExtraProp 個名為的屬性， Add-Member 由新增，然後匯出至 CSV。您現在可以看到 ExtraProp CSV 檔案輸出中的標頭。

如果新增的屬性名稱與哈希表中的索引鍵 名稱相同 ，則索引鍵會優先使用，而且只會將密鑰導出至 CSV。

參數

-Append

使用此參數，以便 Export-CSV 將 CSV 輸出新增至指定檔案的結尾。若未使用此參數， Export-CSV 則取代檔案內容而不發出警告。

此參數是在 Windows PowerShell 3.0 引進。

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

在執行 Cmdlet 前提示您確認。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Delimiter

指定分隔符號以區隔屬性值。預設值為逗號 (,) 。輸入字元，例如冒號 (:) 。若要指定分號 (;) ，請將它括在引號中。

Type:	Char
Position:	1
Default value:	comma (,)
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Encoding

指定匯出之 CSV 檔案的編碼。預設值是 utf8NoBOM。

此參數可接受的值如下所示：

ascii：使用 ASCII (7 位) 字元集的編碼方式。
bigendianunicode：使用大位元組位元組順序以UTF-16格式編碼。
bigendianutf32：使用大位元組位元組順序以UTF-32格式編碼。
oem：使用 MS-DOS 和控制台程式的預設編碼方式。
unicode：使用位元組由小到大的順序，以UTF-16格式編碼。
utf7：以 UTF-7 格式編碼。
utf8：以 UTF-8 格式編碼。
utf8BOM：使用位元組順序標記 (BOM) 以 UTF-8 格式編碼
utf8NoBOM：以 UTF-8 格式編碼，不含位元組順序標記 (BOM)
utf32：以 UTF-32 格式編碼。

從 PowerShell 6.2 開始， Encoding 參數也允許已註冊代碼頁的數值標識符， (例如 -Encoding 1251) 或已註冊代碼頁的字串名稱 (，例如 -Encoding "windows-1251") 。如需詳細資訊，請參閱 Encoding.CodePage 的 .NET 檔。

注意

不再建議使用UTF-7* 。自 PowerShell 7.1 起，如果您為 Encoding 參數指定utf7，則會寫入警告。

Type:	Encoding
Accepted values:	ASCII, BigEndianUnicode, BigEndianUTF32, OEM, Unicode, UTF7, UTF8, UTF8BOM, UTF8NoBOM, UTF32
Position:	Named
Default value:	UTF8NoBOM
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

此參數允許 Export-Csv 使用唯讀屬性覆寫檔案。

合併 Force 和 Append 參數時，可以寫入包含不相符屬性的物件至 CSV 檔案。只有相符的屬性會寫入檔案。捨棄不相符的屬性。

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IncludeTypeInformation

使用此參數時，CSV 輸出的第一行會 #TYPE 包含，後面接著物件類型的完整名稱。例如： #TYPE System.Diagnostics.Process 。

此參數是在 PowerShell 6.0 中引進。

Type:	SwitchParameter
Aliases:	ITI
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

指定要匯出為 CSV 字串的物件。輸入包含物件的變數，或輸入可取得物件的命令或運算式。您也可以使用管線會傳送至 Export-CSV。

Type:	PSObject
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-LiteralPath

指定 CSV 輸出檔案的路徑。與 Path 不同，LiteralPath 參數值將完全依照其輸入值來使用。沒有字元會被視為萬用字元。如果路徑包含逸出字元，請使用單引號。單引號會指示PowerShell不要將任何字元解譯為逸出序列。

Type:	String
Aliases:	PSPath, LP
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoClobber

使用此參數， Export-CSV 如此就不會覆寫現有的檔案。根據預設，如果檔案存在於指定的路徑中，則會 Export-CSV 覆寫檔案而不發出警告。

Type:	SwitchParameter
Aliases:	NoOverwrite
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoTypeInformation

#TYPE從輸出中移除資訊標頭。此參數在 PowerShell 6.0 中變成預設值，並隨附於回溯相容性中。

Type:	SwitchParameter
Aliases:	NTI
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Path

必要參數，指定要儲存 CSV 輸出檔案的位置。

Type:	String
Position:	0
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-QuoteFields

指定應加上引號的數據行名稱。使用此參數時，只會以引弧括住指定的數據行。此參數已在PowerShell 7.0中新增。

Type:	String[]
Aliases:	QF
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UseCulture

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

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UseQuotes

指定 CSV 檔案中使用引號的時機。可能的值包括：

永不 - 不要加上任何引號
一律 - 引號所有專案 (預設行為)
AsNeeded - 僅包含分隔符、雙引號或換行符的引號字段

此參數已在PowerShell 7.0中新增。

Type:	Microsoft.PowerShell.Commands.BaseCsvWritingCommand+QuoteKind
Aliases:	UQ
Position:	Named
Default value:	Always
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

防止 Cmdlet 進行處理或進行變更。輸出會顯示執行 Cmdlet 時會發生什麼情況。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

輸入

PSObject

您可以使用管線將具有擴充類型系統的任何物件傳送至此 Cmdlet (ETS) 配接器。

輸出

None

此 Cmdlet 不會傳回任何輸出。

備註

PowerShell 包含的下列別名 Export-Csv：

所有平台：
- epcsv

Cmdlet Export-CSV 會將您提交的物件轉換成一系列的 CSV 字串，並將其儲存在指定的文字檔中。您可以使用 Export-CSV -IncludeTypeInformation 將物件儲存在 CSV 檔案中，然後使用 Import-Csv Cmdlet 從 CSV 檔案中的文字建立物件。

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

CSV 字串輸出如下：

如果使用 IncludeTypeInformation ，第一個字串會包含 #TYPE 資訊標頭，後面接著物件類型的完整名稱。例如， #TYPE System.Diagnostics.Process。
如果未使用 IncludeTypeInformation ，則第一個字串會包含數據行標頭。標頭包含第一個物件的屬性名稱做為字元分隔清單。
其餘字串包含每個物件屬性值的字元分隔清單。

從 PowerShell 6.0 開始，的預設行為 Export-CSV 是不包含 CSV 中的 #TYPE 資訊， 而且隱含 NoTypeInformation 。 IncludeTypeInformation 可用來包含 #TYPE 資訊，並模擬 PowerShell 6.0 之前的默認行為 Export-CSV 。

當您將多個物件提交至 Export-CSV時， Export-CSV 會根據您提交之第一個對象的屬性來組織檔案。如果其餘的物件不具有指定之屬性的其中之一，該物件的屬性值會是 null，以兩個連續的逗號表示。如果其餘的物件有其他屬性，那些屬性值將不會包含在檔案中。

您可以使用 Import-Csv Cmdlet，從檔案中的 CSV 字串重新建立物件。產生的物件是 CSV 版本的原始物件，包含屬性值的字串表示，而且不含方法。

ConvertTo-Csv和 ConvertFrom-Csv Cmdlet 會將物件轉換成 CSV 字串，以及從 CSV 字串轉換。 Export-CSV 與 ConvertTo-CSV相同，不同之處在於它會將 CSV 字串儲存在檔案中。

共用方式為

Export-Csv

Syntax

Description

範例

範例 1：將進程屬性匯出至 CSV 檔案

範例 2：將進程匯出至逗號分隔檔案

範例 3：將進程匯出至以分號分隔的檔案

範例 4：使用目前文化特性的清單分隔符匯出進程

範例 5：導出具有類型資訊的處理程式

範例 6：將物件匯出並附加至 CSV 檔案

範例 7：在管線內格式化 Cmdlet 會建立非預期的結果

範例 8：使用 Force 參數覆寫唯讀檔案

範例 9：搭配 Append 使用 Force 參數

範例 10：匯出至 CSV，其中包含兩個數據行的引號

範例 11：僅在需要時使用引號導出至 CSV

範例 12：將哈希表轉換成 CSV

範例 13：使用其他屬性將哈希表轉換為 CSV

參數

-Append

-Confirm

-Delimiter

-Encoding

-Force

-IncludeTypeInformation

-InputObject

-LiteralPath

-NoClobber

-NoTypeInformation

-Path

-QuoteFields

-UseCulture

-UseQuotes

-WhatIf

輸入

輸出

備註

其他資源

共用方式為

Export-Csv

Syntax

Description

範例

範例 1：將進程屬性匯出至 CSV 檔案

範例 2：將進程匯出至逗號分隔檔案

範例 3：將進程匯出至以分號分隔的檔案

範例 4：使用目前文化特性的清單分隔符匯出進程

範例 5：導出具有類型資訊的處理程式

範例 6：將物件匯出並附加至 CSV 檔案

範例 7：在管線內格式化 Cmdlet 會建立非預期的結果

範例 8：使用 Force 參數覆寫唯讀檔案

範例 9：搭配 Append 使用 Force 參數

範例 10：匯出至 CSV，其中包含兩個數據行的引號

範例 11：僅在需要時使用引號導出至 CSV

範例 12：將哈希表轉換成 CSV

範例 13：使用其他屬性將哈希表轉換為 CSV

參數

-Append

-Confirm

-Delimiter

-Encoding

-Force

-IncludeTypeInformation

-InputObject

-LiteralPath

-NoClobber

-NoTypeInformation

-Path

-QuoteFields

-UseCulture

-UseQuotes

-WhatIf

輸入

輸出

備註

相關連結

其他資源