ConvertTo-Xml

Başvuru

Modül:: Microsoft.PowerShell.Utility

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

Sözdizimi

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

Description

ConvertTo-Xml cmdlet'i bir veya daha fazla .NET nesnesinin XML tabanlı gösterimini oluşturur. Bu cmdlet'i kullanmak için, bir veya daha fazla nesneyi cmdlet'e kanal veya InputObject parametresini kullanarak nesneyi belirtin.

Birden çok nesneyi ConvertTo-Xml veya InputObject parametresini kullanarak 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 benzer ancak Export-Clixml sonuçta elde edilen XML'i Import-Clixmlile nesneler olarak yeniden aktarılabilir Ortak Dil Altyapısı (CLI) dosyasında depolar. ConvertTo-Xml, 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ği yoktur.

Ö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 bir XML belgesine dönüştürür. Nesneler üç düzey derinliğe genişletilir.

Parametreler

-As

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

String - Tek bir dize döndürür.
Stream - Bir dize dizisi döndürür.
Document - bir XmlDocument nesnesi döndürür.

Varsayılan değer Document.

Tür:	String
Kabul edilen değerler:	Stream, String, Document
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-Depth

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

Örneğin, nesnenin özellikleri de nesneler 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.

Tür:	Int32
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	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. Nesneleri ConvertTo-Xml'e de yöneltebilirsiniz.

Tür:	PSObject
Position:	0
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-NoTypeInformation

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

Tür:	SwitchParameter
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

Girişler

PSObject

Herhangi bir nesneyi bu cmdlet'e yöneltebilirsiniz

Çıkışlar

String

As parametresini kullandığınızda ve değeri stringolarak ayarladığınızda, bu cmdlet XML'yi dize olarak döndürür. Değer streamolduğunda, bu cmdlet bir dize dizisi döndürür.

XmlDocument

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

Aracılığıyla paylaş