ConvertTo-Xml (Microsoft.PowerShell.Utility)

ConvertTo-Xml

Modül:
Microsoft.PowerShell.Utility

Bir nesnenin XML tabanlı temsilini oluşturur.

Sözdizimi

ConvertTo-Xml
              [-Depth <Int32>]
              [-InputObject] <PSObject>
              [-NoTypeInformation]
              [-As <String>]
              [<CommonParameters>]

Tanım

ConvertTo-Xml cmdlet'i bir veya daha fazla .NET nesnesinin XML tabanlı temsilini oluşturur. Bu cmdlet'i kullanmak için bir veya daha fazla nesneyi cmdlet'e yönlendirin veya nesneyi belirtmek için InputObject parametresini kullanın.

Birden çok nesneyi ConvertTo-Xml'e aktardığınızda veya birden çok nesne göndermek için InputObject parametresini kullandığınızda, ConvertTo-Xml tek bir bellek içi öğe döndürür Tüm nesnelerin temsillerini içeren XML belgesi.

Bu cmdlet, Export-Clixml'in elde edilen XML'i Import-Clixml ile nesneler olarak yeniden içe aktarılabilen bir Ortak Dil Altyapısı (CLI) dosyasında saklaması dışında Export-Clixml'e benzer. ConvertTo-Xml bir XML belgesinin bellek içi temsilini döndürür, böylece onu PowerShell'de işlemeye devam edebilirsiniz. ConvertTo-Xml'de nesneleri CLI XML'e dönüştürme seçeneği yoktur.

Örnekler

Örnek 1: Tarihi XML'e dönüştürme

Get-Date | ConvertTo-Xml

Bu komut geçerli tarihi (bir DateTime nesnesi) XML'e dönüştürür.

Örnek 2: İşlemleri XML'e dönüştürme

ConvertTo-Xml -As "Document" -InputObject (Get-Process) -Depth 3

Bu komut, bilgisayardaki tüm işlemleri temsil eden işlem nesnelerini bir XML belgesine dönüştürür. Nesneler üç seviye derinliğe kadar genişletilir.

Parametreler

-As

Çıkış formatını belirler. Bu parametre için kabul edilebilir değerler şunlardır:

  • Dize - Tek bir dize döndürür.
  • Akış - Bir dizi dize döndürür.
  • Document - Bir XmlDocument nesnesi döndürür.

Varsayılan değer Belge'dir.

Tip :

String

Kabul edilen değerler:

Akış, Dize, Belge

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-Depth

XML gösterimine kaç düzeyde içerilen nesnenin dahil edildiğini belirtir. Varsayılan değer 1'dir.

Örneğin, nesnenin özellikleri aynı zamanda nesneler de içeriyorsa, içerilen nesnelerin özelliklerinin XML temsilini kaydetmek için derinliği 2 olarak belirtmeniz gerekir.

Types.ps1xml dosyalarındaki nesne türü için varsayılan değer geçersiz kılınabilir. Daha fazla bilgi için about_Types.ps1xml'e bakın.

Tip :

Int32

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-InputObject

Dönüştürülecek nesneyi belirtir. Nesneleri içeren bir değişken girin veya nesneleri alan bir komut veya ifade yazın. Ayrıca nesneleri ConvertTo-XML'e yönlendirebilirsiniz.

Tip :

PSObject

Konum:

0

Varsayılan değer:

None

Gerekli:

True

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

False

-NoTypeInformation

Type özniteliğini nesne düğümlerinden çıkarır.

Tip :

SwitchParameter

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

Girişler

PSObject

Bu cmdlet'e herhangi bir nesneyi aktarabilirsiniz

Çıkışlar

Dize

As parametresini kullandığınızda ve değeri string olarak ayarladığınızda, bu cmdlet XML'i bir dize olarak döndürür. Değer stream olduğunda, bu cmdlet bir dizi dize döndürür.

XmlDocument

Varsayılan olarak bu cmdlet bir XML belgesi döndürür.

İlgili makaleler