Export-Clixml

發行項
10/30/2009

建立物件的 XML 表示法並儲存至檔案。

語法

Export-Clixml [-Path] <string> -InputObject <psobject> [-Depth <int>] [-Encoding <string>] [-Force] [-NoClobber] [-Confirm] [-WhatIf] [<CommonParameters>]

描述

Export-Clixml Cmdlet 會建立物件的 XML 表示，然後將其儲存到檔案中。然後您可以使用 Import-CLIXML Cmdlet，根據該檔案的內容重新建立儲存的物件。

此 Cmdlet 與 ConvertTo-XML 相似，但不同是 Export-Clixml 將產生的 XML 儲存到檔案中。ConvertTo-XML 會傳回 XML，因此您可以在 Windows PowerShell 中繼續處理它。

參數

-Depth <int>

指定 XML 表示中所含之物件的層級數量。預設值為 2。

您可以在 Types.ps1xml 檔案中覆寫物件型別的預設值。如需詳細資訊，請參閱 about_Types.ps1xml。

必要?	false
位置?	named
預設值	2
接受管線輸入?	false
接受萬用字元?	false

-Encoding <string>

指定目標檔案的編碼類型。有效的值包括 ASCII、UTF8、UTF7、UTF32、Unicode、BigEndianUnicode、Default 和 OEM。預設為 UTF8。

必要?	false
位置?	named
預設值	UTF8
接受管線輸入?	false
接受萬用字元?	false

-Force

指示 cmdlet 於必要時清除輸出檔的唯讀屬性。cmdlet 會在命令完成後嘗試重設唯讀屬性。

必要?	false
位置?	named
預設值
接受管線輸入?	false
接受萬用字元?	false

-InputObject <psobject>

指定要轉換的物件。請輸入包含物件的變數，或輸入可取得物件的命令或運算式。您也可經由管道將物件輸出至 Export-Clixml。

必要?	true
位置?	named
預設值
接受管線輸入?	true (ByValue)
接受萬用字元?	false

-NoClobber

確保 cmdlet 不會覆寫現有檔案的內容。根據預設，如果檔案已在指定的路徑中，Export-Clixml 會毫無預警地覆寫該檔案。

必要?	false
位置?	named
預設值
接受管線輸入?	false
接受萬用字元?	false

-Path <string>

指定用於儲存物件 XML 表示法的檔案所在路徑。

必要?	true
位置?	1
預設值
接受管線輸入?	false
接受萬用字元?	false

-Confirm

在執行命令前先提示確認。

必要?	false
位置?	named
預設值
接受管線輸入?	false
接受萬用字元?	false

-WhatIf

說明執行命令時將會發生何種情況，但不會實際執行命令。

必要?	false
位置?	named
預設值
接受管線輸入?	false
接受萬用字元?	false

<CommonParameters>

這個 Cmdlet 支援一般參數：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。如需詳細資訊，請參閱 about_Commonparameters.

輸入和輸出

輸入型別是可經由管道輸出至 Cmdlet 的物件型別。傳回型別則是 Cmdlet 所傳回的物件型別。

輸入

System.Management.Automation.PSObject

您可經由管道將任何物件輸出至 Export-Clixml。

輸出

System.IO.FileInfo

Export-Clixml 會建立包含 XML 的檔案。

範例 1

C:\PS>"This is a test" | export-clixml sample.xml

描述
-----------
這個命令會建立一個 XML 檔案，儲存 "This is a test" 字串的表示法。

範例 2

C:\PS>get-acl C:\test.txt | export-clixml -Path fileacl.xml

C:\PS> $fileacl = import-clixml fileacl.xml

描述
-----------
這個範例示範如何將物件匯出到 XML 檔案，然後透過從該檔案匯入 XML 來建立物件。

第一個命令會使用 Get-ACL Cmdlet 取得 Test.txt 檔案的安全性描述元，並使用管線運算子將安全性描述元傳遞給 Export-Clixml，讓後者將物件的 XML 表示儲存到名為 FileACL.xml 的檔案。

第二個命令會使用 Import-Clixml Cmdlet 從 FileACL.xml 檔案中的 XML 建立物件，然後將該物件儲存到 $FileAcl 變數。

請參閱

概念

Import-Clixml
ConvertTo-XML
Export-CSV
ConvertTo-Html

共用方式為