Aracılığıyla paylaş

Import-Clixml

  • Başvuru
Modül:
Microsoft.PowerShell.Utility

CLIXML dosyasını içeri aktarır ve PowerShell'de ilgili nesneleri oluşturur.

Syntax

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

Description

Cmdlet, Import-Clixml Microsoft .NET Framework nesnelerini temsil eden verileri içeren bir Ortak Dil Altyapısı (CLI) XML dosyasını içeri aktarır ve PowerShell nesnelerini oluşturur. CLI hakkında daha fazla bilgi için bkz. Dil bağımsızlığı.

Windows bilgisayarlarda değerli bir kullanımı Import-Clixml , kullanılarak Export-Clixmlgüvenli XML olarak dışarı aktarılan kimlik bilgilerini ve güvenli dizeleri içeri aktarmaktır. Örnek için bkz. Örnek 2.

Import-Clixml dosyanın kodlama biçimini algılamak için bayt sipariş işaretini (BOM) kullanır. Dosyada BOM yoksa, kodlamanın UTF8 olduğunu varsayar.

Örnekler

Örnek 1: Seri hale getirilmiş bir dosyayı içeri aktarma ve nesneyi yeniden oluşturma

Bu örnekte cmdlet'i, tarafından Get-Processdöndürülen işlem bilgilerinin serileştirilmiş bir kopyasını kaydetmek için kullanılırExport-Clixml. Import-Clixml seri hale getirilmiş dosyanın içeriğini alır ve değişkeninde $Processes depolanan bir nesneyi yeniden oluşturur.

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

Örnek 2: Güvenli bir kimlik bilgisi nesnesini içeri aktarma

Bu örnekte, cmdlet'ini çalıştırarak Get-Credential değişkende $Credential depoladığınız bir kimlik bilgisi verdiyseniz, kimlik bilgilerini diske kaydetmek için cmdlet'ini çalıştırabilirsinizExport-Clixml.

Önemli

Export-Clixml yalnızca Windows'ta şifrelenmiş kimlik bilgilerini dışarı aktarır. macOS ve Linux gibi Windows dışı işletim sistemlerinde kimlik bilgileri düz metin olarak dışarı aktarılır.

$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

cmdlet'i Export-Clixml , Windows Veri Koruma API'sini kullanarak kimlik bilgisi nesnelerini şifreler. Şifreleme, yalnızca kullanıcı hesabınızın kimlik bilgisi nesnesinin içeriğinin şifresini çözebilmesini sağlar. Dışarı aktarılan CLIXML dosya farklı bir bilgisayarda veya farklı bir kullanıcı tarafından kullanılamaz.

Örnekte, kimlik bilgilerinin depolandığı dosya ile TestScript.ps1.credentialtemsil edilir. TestScript'i, kimlik bilgilerini yüklemekte olduğunuz betiğin adıyla değiştirin.

kimlik bilgisi nesnesini işlem hattının aşağısına Export-Clixmlgönderir ve ilk komutta belirttiğiniz yola $Credxmlpathkaydedersiniz.

Kimlik bilgilerini betiğinize otomatik olarak aktarmak için son iki komutu çalıştırın. Güvenli kimlik bilgisi nesnesini betiğinize aktarmak için komutunu çalıştırın Import-Clixml . Bu içeri aktarma işlemi, betiğinizde düz metin parolaları ortaya çıkarma riskini ortadan kaldırır.

Parametreler

-First

Yalnızca belirtilen nesne sayısını alır. Alınacak nesne sayısını girin.

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

-IncludeTotalCount

Veri kümesindeki toplam nesne sayısını ve ardından seçili nesneleri raporlar. Cmdlet toplam sayıyı belirleyemezse Bilinmeyen toplam sayısı'nı görüntüler. Tamsayı, toplam sayı değerinin güvenilirliğini gösteren bir Doğruluk özelliğine sahiptir. Doğruluk0.01.00.0 değeri, cmdlet'in nesneleri sayamadığı, 1.0 sayının tam olduğu ve ile arasındaki 0.01.0 bir değerin giderek daha güvenilir bir tahminde bulunduğu anlamına gelir.

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

-LiteralPath

XML dosyalarının yolunu belirtir. Path'in aksine, LiteralPath parametresinin değeri tam olarak yazıldığı gibi kullanılır. Hiçbir karakter joker karakter olarak yorumlanmamıştır. Yol kaçış karakterleri içeriyorsa, tek tırnak içine alın. Tek tırnak işaretleri PowerShell'e hiçbir karakteri kaçış dizisi olarak yorumlamaması gerektiğini söyler.

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

-Path

XML dosyalarının yolunu belirtir.

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

-Skip

Belirtilen sayıda nesneyi yoksayar ve sonra geri kalan nesneleri alır. Atlanacak nesne sayısını girin.

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

Girişler

String

yolunu içeren bir dizenin Import-Clixmlişlem hattını oluşturabilirsiniz.

Çıkışlar

PSObject

Import-Clixml depolanan XML dosyalarından seri durumdan çıkarılmış nesneleri döndürür.

Notlar

Bir parametre için birden çok değer belirtirken, değerleri ayırmak için virgül kullanın. Örneğin, <parameter-name> <value1>, <value2>.