ConvertTo-Xml
Bir nesnenin XML tabanlı gösterimini oluşturur.
Sözdizimi
Default EnterprisePublishing
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 ş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 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.
