ConvertTo-Xml

Modül:
Microsoft.PowerShell.Utility Module

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

Syntax

Default (Varsayılan) 

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 birden çok nesneye yönelttiğinizde veya birden çok nesne ConvertTo-Xml göndermek için InputObject parametresini kullandığınızda, ConvertTo-Xml tüm nesnelerin temsillerini içeren tek bir bellek içi XML belgesi döndürür.

Bu cmdlet, elde edilen XML'yi Export-Clixml Import-Clixml ile nesneler olarak yeniden içeri aktarılabilen bir Ortak Dil Altyapısı (CLI) XML dosyasında depolaması dışında Export-Clixml'ye benzer. 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 şudur: Document.

Parametre özellikleri

Tür:String
Default value:None
Kabul edilen değerler:Stream, String, Document
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer: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.

Parametre özellikleri

Tür:Int32
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer: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.

Parametre özellikleri

Tür:PSObject
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:0
Zorunlu:True
İşlem hattından gelen değer:True
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-NoTypeInformation

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

Parametre özellikleri

Tür:SwitchParameter
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

Girişler

PSObject

herhangi bir nesneyi ConvertTo-XML.

Çıkışlar

System.String or System.Xml.XmlDocument

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