Aracılığıyla paylaş

ConvertTo-Xml

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

Bir nesnenin XML tabanlı gösterimini oluşturur.

Syntax

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

Description

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

Birden çok nesneyi göndermek için inputobject parametresini ConvertTo-Xml kullandığınızda veya birden çok nesne gönderdiğinizde, ConvertTo-Xml tüm nesnelerin gösterimlerini içeren tek bir bellek içi XML belgesi döndürür.

Bu cmdlet Export-Clixml'ye benzer, ancak Export-Clixml sonuçta elde edilen XML'yi Import-Clixml ile nesneler olarak yeniden aktarılabilir bir Ortak Dil Altyapısı (CLI) XML dosyasında depolar. ConvertTo-Xml BIR XML belgesinin bellek içi gösterimini döndürür, böylece belgeyi PowerShell'de işlemeye devam edebilirsiniz. ConvertTo-Xml nesneleri CLI XML'e dönüştürme seçeneğine sahip değildir.

Örnekler

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

Get-Date | ConvertTo-Xml

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

Örnek 2: İşlemleri XML'ye 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 xml belgesine dönüştürür. Nesneler üç düzey derinliğe genişletilir.

Parametreler

-As

Çıkış biçimini belirler. Bu parametrenin kabul edilebilir değerleri şunlardır:

  • String Tek bir dize döndürür.
  • Stream Bir dize dizisi döndürür.
  • DocumentXmlDocument nesnesi döndürür.

Document varsayılan değerdir.

Type:String
Accepted values:Stream, String, Document
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Depth

XML gösterimine kaç kapsanan nesne düzeyi eklendiğini belirtir. Varsayılan değer 1’dir.

Örneğin, nesnenin özellikleri nesneleri de içeriyorsa, kapsanan nesnelerin özelliklerinin XML gösterimini kaydetmek için 2 derinliği 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 bkz . about_Types.ps1xml.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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. Nesneleri öğesine ConvertTo-XMLde yöneltebilirsiniz.

Type:PSObject
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-NoTypeInformation

Nesne düğümlerinden Type özniteliğini atlar.

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

Girişler

PSObject

Herhangi bir nesneyi öğesine kanal oluşturabilirsiniz ConvertTo-XML.

Çıkışlar

System.String or System.Xml.XmlDocument

As parametresinin değeri, döndürülen nesnenin ConvertTo-XML türünü belirler.