Import-Clixml
匯入 CLIXML 檔案，並在 PowerShell 中建立對應的物件。
語法
Import-Clixml
[-Path] <String[]>
[-IncludeTotalCount]
[-Skip <UInt64>]
[-First <UInt64>]
[<CommonParameters>]Import-Clixml
-LiteralPath <String[]>
[-IncludeTotalCount]
[-Skip <UInt64>]
[-First <UInt64>]
[<CommonParameters>]Description
Import-Clixml Cmdlet 會匯入 Common Language Infrastructure （CLI） XML 檔案，其中包含代表 .NET Framework 物件Microsoft，並建立 PowerShell 對象的數據。 如需 CLI 的詳細資訊，請參閱 語言獨立。
在 Windows 電腦上，有價值地使用 Import-Clixml，就是使用 Export-Clixml匯入認證和安全導出為安全 XML 的安全字串。 如需範例，請參閱範例 2。
Import-Clixml 會使用位元組順序標記 （BOM） 來偵測檔案的編碼格式。 如果檔案沒有 BOM，則會假設編碼方式為 UTF8。
範例
範例 1：匯入串行化檔案並重新建立物件
此範例會使用 Export-Clixml Cmdlet 來儲存 Get-Process所傳回之進程資訊的串行化複本。
Import-Clixml 擷取串行化檔案的內容，並重新建立儲存在 $Processes 變數中的物件。
Get-Process | Export-Clixml -Path .\pi.xml
$Processes = Import-Clixml -Path .\pi.xml範例 2：匯入安全認證物件
在此範例中，假設您已藉由執行 Get-Credential Cmdlet，將認證儲存在 $Credential 變數中，您可以執行 Export-Clixml Cmdlet，將認證儲存至磁碟。
重要
Export-Clixml 只會匯出 Windows 上的加密認證。 在macOS和Linux等非 Windows 作業系統上，認證會以純文字匯出。
$Credxmlpath = Join-Path (Split-Path $Profile) TestScript.ps1.credential
$Credential | Export-Clixml $Credxmlpath
$Credxmlpath = Join-Path (Split-Path $Profile) TestScript.ps1.credential
$Credential = Import-Clixml $Credxmlpath
Export-Clixml Cmdlet 會使用 Windows 資料保護 API來加密認證物件。
加密可確保只有您的用戶帳戶才能解密認證對象的內容。 導出的 CLIXML 檔案不能在不同的計算機上或由不同的使用者使用。
在此範例中，儲存認證的檔案會以 TestScript.ps1.credential表示。 將 TestScript 取代為您載入認證的腳本名稱。
您會將認證物件向下傳送至管線，以 Export-Clixml，並將它儲存至您在第一個命令中指定的路徑 $Credxmlpath。
若要自動將認證匯入腳本，請執行最後兩個命令。 執行 Import-Clixml，將受保護的認證物件匯入腳本中。 此匯入可消除在您的文稿中公開純文字密碼的風險。
參數
-First
只取得指定的物件數目。 輸入要取得的物件數目。
| 類型: | UInt64 |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-IncludeTotalCount
報告數據集中物件的總數，後面接著選取的物件。 如果 Cmdlet 無法判斷總計數，它會顯示 未知的總計數。 整數具有 精確度 屬性，表示總計數值的可靠性。
精確度 值的範圍從 0.0 到 1.0，其中 0.0 表示 Cmdlet 無法計算物件，1.0 表示計數是確切的，0.0 與 1.0 之間的值表示越來越可靠的估計值。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-LiteralPath
指定 XML 檔案的路徑。 與 Path不同，LiteralPath 參數的值會與類型完全相同。 不會將任何字元解譯為通配符。 如果路徑包含逸出字元，請以單引弧括住它。 單引號會告知PowerShell不要將任何字元解譯為逸出序列。
| 類型: | String[] |
| 別名: | PSPath |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Path
指定 XML 檔案的路徑。
| 類型: | String[] |
| Position: | 0 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Skip
忽略指定的物件數目，然後取得其餘物件。 輸入要略過的物件數目。
| 類型: | UInt64 |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
輸入
您可以管線包含路徑的字串，以 Import-Clixml。
輸出
PSObject
Import-Clixml 傳回從預存 XML 檔案還原串行化的物件。
備註
指定參數的多個值時，請使用逗號來分隔值。 例如，<parameter-name> <value1>, <value2>。