Import-Clixml

Mengimpor file CLIXML dan membuat objek terkait di PowerShell.

Sintaks

Import-Clixml
      [-Path] <String[]>
      [-IncludeTotalCount]
      [-Skip <UInt64>]
      [-First <UInt64>]
      [<CommonParameters>]
Import-Clixml
      -LiteralPath <String[]>
      [-IncludeTotalCount]
      [-Skip <UInt64>]
      [-First <UInt64>]
      [<CommonParameters>]

Deskripsi

Import-Clixml Cmdlet mengimpor file XML Common Language Infrastructure (CLI) dengan data yang mewakili objek Microsoft .NET Framework dan membuat objek PowerShell. Untuk informasi selengkapnya tentang CLI, lihat Kemandirian bahasa.

Penggunaan yang berharga pada Import-Clixml komputer Windows adalah mengimpor kredensial dan string aman yang diekspor sebagai XML aman menggunakan Export-Clixml. Misalnya, lihat Contoh 2.

Import-Clixml menggunakan byte-order-mark (BOM) untuk mendeteksi format pengodean file. Jika file tidak memiliki BOM, diasumsikan pengodeannya adalah UTF8.

Contoh

Contoh 1: Mengimpor file berseri dan membuat ulang objek

Contoh ini menggunakan Export-Clixml cmdlet untuk menyimpan salinan serial informasi proses yang dikembalikan oleh Get-Process. Import-Clixml mengambil konten file yang diserialisasikan dan membuat ulang objek yang disimpan dalam $Processes variabel .

Get-Process | Export-Clixml -Path .\pi.xml
$Processes = Import-Clixml -Path .\pi.xml

Contoh 2: Mengimpor objek kredensial aman

Dalam contoh ini, mengingat kredensial yang telah Anda simpan dalam $Credential variabel dengan menjalankan Get-Credential cmdlet , Anda dapat menjalankan Export-Clixml cmdlet untuk menyimpan kredensial ke disk.

Penting

Export-Clixml hanya mengekspor kredensial terenkripsi pada Windows. Pada sistem operasi non-Windows seperti macOS dan Linux, kredensial diekspor dalam teks biasa.

$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 mengenkripsi objek kredensial dengan menggunakan API Perlindungan Data Windows. Enkripsi memastikan bahwa hanya akun pengguna Anda yang dapat mendekripsi konten objek kredensial. File yang diekspor CLIXML tidak dapat digunakan pada komputer lain atau oleh pengguna lain.

Dalam contoh, file tempat kredensial disimpan diwakili oleh TestScript.ps1.credential. Ganti TestScript dengan nama skrip tempat Anda memuat kredensial.

Anda mengirim objek kredensial ke bawah alur ke Export-Clixml, dan menyimpannya ke jalur, $Credxmlpath, yang Anda tentukan dalam perintah pertama.

Untuk mengimpor kredensial secara otomatis ke dalam skrip Anda, jalankan dua perintah akhir. Jalankan Import-Clixml untuk mengimpor objek kredensial aman ke dalam skrip Anda. Impor ini menghilangkan risiko mengekspos kata sandi teks biasa dalam skrip Anda.

Parameter

-First

Hanya mendapatkan jumlah objek yang ditentukan. Masukkan jumlah objek yang akan didapatkan.

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

-IncludeTotalCount

Melaporkan jumlah total objek dalam himpunan data diikuti oleh objek yang dipilih. Jika cmdlet tidak dapat menentukan jumlah total, cmdlet akan menampilkan Jumlah total yang tidak diketahui. Bilangan bulat memiliki properti Akurasi yang menunjukkan keandalan nilai jumlah total. Nilai Akurasi berkisar dari 0.0 hingga 1.0 di mana 0.0 berarti bahwa cmdlet tidak dapat menghitung objek, 1.0 berarti bahwa hitungannya tepat, dan nilai antara 0.0 dan 1.0 menunjukkan perkiraan yang semakin dapat diandalkan.

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

-LiteralPath

Menentukan jalur ke file XML. Tidak seperti Path, nilai parameter LiteralPath digunakan persis seperti yang ditik. Tidak ada karakter yang ditafsirkan sebagai kartubebas. Jika jalur menyertakan karakter escape, sertakan dalam tanda kutip tunggal. Tanda kutip tunggal memberi tahu PowerShell untuk tidak menafsirkan karakter apa pun sebagai urutan escape.

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

-Path

Menentukan jalur ke file XML.

Type:String[]
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Skip

Mengabaikan jumlah objek yang ditentukan lalu mendapatkan objek yang tersisa. Masukkan jumlah objek yang akan dilewati.

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

Input

String

Anda dapat menyalurkan string yang berisi jalur ke Import-Clixml.

Output

PSObject

Import-Clixml mengembalikan objek yang dideserialisasi dari file XML yang disimpan.

Catatan

Saat menentukan beberapa nilai untuk parameter, gunakan koma untuk memisahkan nilai. Contohnya:<parameter-name> <value1>, <value2>