建立物件的 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 變數。






請參閱




目錄