ConvertTo-Html

Başvuru

Modül:: Microsoft.PowerShell.Utility

.NET nesnelerini Web tarayıcısında görüntülenebilen HTML'ye dönüştürür.

Sözdizimi

ConvertTo-Html
              [-InputObject <PSObject>]
              [[-Property] <Object[]>]
              [[-Body] <String[]>]
              [[-Head] <String[]>]
              [[-Title] <String>]
              [-As <String>]
              [-CssUri <Uri>]
              [-PostContent <String[]>]
              [-PreContent <String[]>]
              [-Meta <Hashtable>]
              [-Charset <String>]
              [-Transitional]
              [<CommonParameters>]

ConvertTo-Html
              [-InputObject <PSObject>]
              [[-Property] <Object[]>]
              [-As <String>]
              [-Fragment]
              [-PostContent <String[]>]
              [-PreContent <String[]>]
              [<CommonParameters>]

Description

Cmdlet, ConvertTo-Html .NET nesnelerini Web tarayıcısında görüntülenebilen HTML'ye dönüştürür. Bu cmdlet'i, web sayfasında bir komutun çıktısını görüntülemek için kullanabilirsiniz.

parametresini ConvertTo-Html kullanarak nesne özelliklerini seçebilir, tablo veya liste biçimini belirtebilir, HTML sayfası başlığını belirtebilir, nesneden önce ve sonra metin ekleyebilir ve katı bir DTD sayfası yerine yalnızca tablo veya liste parçasını döndürebilirsiniz.

öğesine ConvertTo-Htmlbirden çok nesne gönderdiğinizde PowerShell, gönderdiğiniz ilk nesnenin özelliklerine göre tabloyu (veya listeyi) oluşturur. Kalan nesneler belirtilen özelliklerden birine sahip değilse, bu nesnenin özellik değeri boş bir hücredir. Kalan nesnelerin ek özellikleri varsa, bu özellik değerleri dosyaya dahil değildir.

Örnekler

Örnek 1: Tarihi görüntülemek için bir web sayfası oluşturma

ConvertTo-Html -InputObject (Get-Date)

Bu komut, geçerli tarihin özelliklerini görüntüleyen bir HTML sayfası oluşturur. Komutun sonuçlarını Get-Date cmdlet'ine göndermek için InputObject parametresini ConvertTo-Html kullanır.

Örnek 2: PowerShell diğer adlarını görüntülemek için bir web sayfası oluşturma

Get-Alias | ConvertTo-Html | Out-File aliases.htm
Invoke-Item aliases.htm

Bu komut, geçerli konsoldaki PowerShell diğer adlarını listeleyen bir HTML sayfası oluşturur.

komutu, diğer adları almak için cmdlet'ini kullanır Get-Alias . Diğer adları cmdlet'e ConvertTo-Html göndermek için işlem hattı işlecini (|) kullanır ve bu da HTML sayfasını oluşturur. Komut, html kodunu dosyaya göndermek için cmdlet'ini aliases.htm de kullanırOut-File.

Örnek 3: PowerShell olaylarını görüntülemek için web sayfası oluşturma

Get-EventLog -LogName "Windows PowerShell" | ConvertTo-Html | Out-File pslog.htm

Bu komut, yerel bilgisayardaki Windows PowerShell olay günlüğünde olayları görüntüleyen adlı pslog.htm bir HTML sayfası oluşturur.

Get-EventLog Windows PowerShell günlüğündeki olayları almak için cmdlet'ini kullanır ve ardından olayları cmdlet'e göndermek için işlem hattı işlecini ConvertTo-Html (|) kullanır. Komut, html kodunu dosyaya göndermek için cmdlet'ini pslog.htm de kullanırOut-File.

Komut, html kodunu dosyaya göndermek için cmdlet'ini pslog.htm de kullanırOut-File.

Örnek 4: İşlemleri görüntülemek için web sayfası oluşturma

Get-Process |
  ConvertTo-Html -Property Name, Path, Company -Title "Process Information" |
    Out-File proc.htm
Invoke-Item proc.htm

Bu komutlar, yerel bilgisayardaki işlemlerin adını, yolunu ve şirketini listeleyen bir HTML sayfası oluşturur ve açar.

İlk komut, bilgisayarda çalışan işlemleri temsil eden nesneleri almak için cmdlet'ini kullanır Get-Process . komut, işlem nesnelerini cmdlet'ine göndermek için işlem hattı işlecini ConvertTo-Html (|) kullanır.

komutu, tabloya eklenecek işlem nesnelerinin üç özelliğini seçmek için Property parametresini kullanır. Komut, HTML sayfası için bir başlık belirtmek üzere Title parametresini kullanır. Komut, elde edilen HTML'yi Out-File adlı Proc.htmbir dosyaya göndermek için cmdlet'ini de kullanır.

İkinci komut, cmdlet'ini varsayılan tarayıcıda açmak Proc.htm için kullanırInvoke-Item.

Örnek 5: Hizmet nesnelerini görüntülemek için web sayfası oluşturma

Get-Service | ConvertTo-Html -CssUri "test.css"

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"  "https://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
<head>
<title>HTML TABLE</title>
<link rel="stylesheet" type="text/css" href="test.css" />
...

Bu komut, cmdlet'in döndürdüğü hizmet nesnelerinin Get-Service HTML sayfasını oluşturur. Komut, HTML sayfası için basamaklı stil sayfası belirtmek üzere CssUri parametresini kullanır.

CssUri parametresi, sonuçta elde edilen HTML'ye ek <link rel="stylesheet" type="text/css" href="test.css"> bir etiket ekler. Etiketteki HREF özniteliği stil sayfasının adını içerir.

Örnek 6: Hizmet nesnelerini görüntülemek için web sayfası oluşturma

Get-Service | ConvertTo-Html -As LIST | Out-File services.htm

Bu komut, cmdlet'in döndürdüğü hizmet nesnelerinin Get-Service HTML sayfasını oluşturur. Komut, liste biçimini belirtmek için As parametresini kullanır. Cmdlet Out-File , sonuçta elde edilen HTML'yi dosyaya Services.htm gönderir.

Örnek 7: Geçerli tarih için web tablosu oluşturma

Get-Date | ConvertTo-Html -Fragment

<table>
<colgroup>...</colgroup>
<tr><th>DisplayHint</th><th>DateTime</th><th>Date</th><th>Day</th><th>DayOfWeek</th><th>DayOfYear</th><th>Hour</th>
<th>Kind</th><th>Millisecond</th><th>Minute</th><th>Month</th><th>Second</th><th>Ticks</th><th>TimeOfDay</th><th>Year</th></tr>
<tr><td>DateTime</td><td>Monday, May 05, 2008 10:40:04 AM</td><td>5/5/2008 12:00:00 AM</td><td>5</td><td>Monday</td>
<td>126</td><td>10</td><td>Local</td><td>123</td><td>40</td><td>5</td><td>4</td><td>633455808041237213</td><td>10:40:04.12
37213</td><td>2008</td></tr>
</table>

Bu komut geçerli tarihin HTML tablosunu oluşturmak için kullanır ConvertTo-Html . Komutu, geçerli tarihi almak için cmdlet'ini kullanır Get-Date . Sonuçları ConvertTo-Html cmdlet'e göndermek için işlem hattı işlecini (|) kullanır.

komutu çıkışı ConvertTo-Html bir HTML tablosuyla sınırlayan Fragment parametresini içerir. Sonuç olarak, ve etiketleri gibi <HEAD> <BODY> bir HTML sayfasının diğer öğeleri atlanır.

Örnek 8: PowerShell olaylarını görüntülemek için web sayfası oluşturma

Get-EventLog -Log "Windows PowerShell" | ConvertTo-Html -Property id, level, task

Bu komut, Windows PowerShell olay günlüğünden olay almak için cmdlet'ini kullanır Get-EventLog .

Olayları cmdlet'ine ConvertTo-Html göndermek için bir işlem hattı işleci (|) kullanır ve bu da olayları HTML biçimine dönüştürür.

komutu, ConvertTo-Html olayın yalnızca Kimlik, Düzey ve Görev özelliklerini seçmek için Property parametresini kullanır.

Örnek 9: Belirtilen hizmetleri görüntülemek için bir web sayfası oluşturma

$htmlParams = @{
  Title = "Windows Services: Server01"
  Body = Get-Date
  PreContent = "<P>Generated by Corporate IT</P>"
  PostContent = "For details, contact Corporate IT."
}
Get-Service A* |
  ConvertTo-Html @htmlParams |
    Out-File Services.htm
Invoke-Item Services.htm

Bu komut, ile Abaşlayan bilgisayardaki hizmetleri görüntüleyen bir Web sayfası oluşturur ve açar. Çıktıyı özelleştirmek için Title, Body, PreContent ve PostContent parametrelerini ConvertTo-Html kullanır.

Komutun ilk bölümü cmdlet'ini Get-Service kullanarak hizmetleri ile Abaşlayan bilgisayara alır. komutu sonuçları cmdlet'e göndermek ConvertTo-Html için bir işlem hattı işleci (|) kullanır. Komutu, çıktıyı dosyaya Out-File göndermek için cmdlet'ini Services.htm de kullanır.

Noktalı virgül (;), ilk komutu sonlandırır ve dosyayı varsayılan tarayıcıda açmak Services.htm için cmdlet'ini kullanan Invoke-Item ikinci bir komut başlatır.

Örnek 10: HTML'nin Meta özelliklerini ve Karakter Kümesini ayarlama

Get-Service | ConvertTo-HTML -Meta @{
  refresh=10
  author="Author's Name"
  keywords="PowerShell, HTML, ConvertTo-HTML"
} -Charset "UTF-8"

Bu komut yenileme, yazma ve anahtar sözcükler için meta etiketleri içeren bir web sayfası için HTML oluşturur. Sayfanın karakter kümesi UTF-8 olarak ayarlandı

Örnek 11: HTML'yi XHTML Geçiş DTD'sine ayarlama

Get-Service | ConvertTo-HTML -Transitional

Bu komut, döndürülen HTML'nin değerini XHTML Geçiş DTD'sine ayarlar DOCTYPE

Parametreler

-As

Nesnenin tablo veya liste olarak biçimlendirilip biçimlendirilmeyeceğini belirler. Geçerli değerler Tablo ve Liste'dir. Varsayılan değer Tablo'dur.

Tablo değeri, PowerShell tablo biçimine benzeyen bir HTML tablosu oluşturur. Üst bilgi satırı özellik adlarını görüntüler. Her tablo satırı bir nesneyi temsil eder ve her özellik için nesnenin değerlerini görüntüler.

Liste değeri, her nesne için PowerShell liste biçimine benzeyen iki sütunlu bir HTML tablosu oluşturur. İlk sütun özellik adını görüntüler. İkinci sütun özellik değerini görüntüler.

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

-Body

Açılış <BODY> etiketinden sonra eklenecek metni belirtir. Varsayılan olarak, bu konumda metin yoktur.

Tür:	String[]
Position:	3
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-Charset

Açılış <charset> etiketine eklenecek metni belirtir. Varsayılan olarak, bu konumda metin yoktur.

Bu parametre PowerShell 6.0'da kullanıma sunulmuştur.

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

-CssUri

HTML dosyasına uygulanan basamaklı stil sayfasının (CSS) Tekdüzen Kaynak Tanımlayıcısını (URI) belirtir. URI, çıktıdaki bir stil sayfası bağlantısına eklenir.

Tür:	Uri
Diğer adlar:	cu, uri
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-Fragment

Yalnızca bir HTML tablosu oluşturur. <HTML>, <HEAD>, <TITLE>ve <BODY> etiketleri atlanır.

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

-Head

Etiketin içeriğini <HEAD> belirtir. Varsayılan değer: <title\>HTML TABLE</title>. Head parametresini kullanırsanız Title parametresi yoksayılır.

Tür:	String[]
Position:	1
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-InputObject

HTML ile temsil edilecek nesneleri belirtir. Nesneleri içeren bir değişken girin veya nesneleri alan bir komut veya ifade yazın.

Bir bilgisayardaki tüm hizmetler gibi birden çok nesne göndermek için bu parametreyi kullanırsanız, ConvertTo-Html bir koleksiyonun veya bir nesne dizisinin özelliklerini görüntüleyen bir tablo oluşturur. Tek tek nesnelerin tablosunu oluşturmak için işlem hattı işlecini kullanarak nesneleri öğesine yöneltin ConvertTo-Html.

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

-Meta

Açılış <meta> etiketine eklenecek metni belirtir. Varsayılan olarak, bu konumda metin yoktur.

Bu parametre PowerShell 6.0'da kullanıma sunulmuştur.

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

-PostContent

Kapanış </TABLE> etiketinden sonra eklenecek metni belirtir. Varsayılan olarak, bu konumda metin yoktur.

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

-PreContent

Açılış <TABLE> etiketinden önce eklenecek metni belirtir. Varsayılan olarak, bu konumda metin yoktur.

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

-Property

HTML'de nesnelerin belirtilen özelliklerini içerir. Property parametresinin değeri yeni bir hesaplanmış özellik olabilir. Hesaplanan özellik bir betik bloğu veya karma tablo olabilir. Geçerli anahtar-değer çiftleri şunlardır:

Name (veya etiket) - <string> (PowerShell 6.x'te eklendi)
Expression - <string> veya <script block>
FormatString - <string>
Width - <int32> - büyük olmalıdır 0
Alignment- değer , Centerveya olabilir LeftRight

Daha fazla bilgi için bkz . about_Calculated_Properties.

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

-Title

HTML dosyası için, yani etiketler arasında <TITLE> görünen metin için bir başlık belirtir.

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

-Transitional

DOCTYPE XHTML Geçiş DTD'sini değiştirir; Varsayılan DOCTYPE değer XHTML Katı DTD'dir.

Bu parametre PowerShell 6.0'da kullanıma sunulmuştur.

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

Bu cmdlet, dönüştürülen nesneyi temsil eden bir DIZI HTML dizesi döndürür.

Notlar

Bu cmdlet'i kullanmak için bir veya daha fazla nesneyi cmdlet'ine kanal veya InputObject parametresini kullanarak nesneyi belirtin. Giriş birden çok nesneden oluştuğunda, bu iki yöntemin çıkışı oldukça farklıdır.

Bir cmdlet'ine birden çok nesne gönderdiğinizde, PowerShell nesneleri cmdlet'ine birer birer gönderir. Sonuç olarak, ConvertTo-Html tek tek nesneleri görüntüleyen bir tablo oluşturur. Örneğin, bir bilgisayardaki ConvertTo-Htmlişlemleri öğesine yöneltiyorsanız, sonuçta elde edilen tabloda tüm işlemler görüntülenir.
Birden çok nesne göndermek için InputObject parametresini kullandığınızda, ConvertTo-Html bu nesneleri koleksiyon veya dizi olarak alır. Sonuç olarak, dizideki öğeleri değil diziyi ve özelliklerini görüntüleyen bir tablo oluşturur. Örneğin, bir bilgisayardaki ConvertTo-Htmlişlemleri adresine göndermek için InputObject kullanırsanız, sonuçta elde edilen tabloda bir nesne dizisi ve özellikleri görüntülenir.

XHTML Strict DTD'ye DOCTYPE uymak için etiket uygun şekilde değiştirilir:

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"\>

Aracılığıyla paylaş

ConvertTo-Html

Sözdizimi

Description

Örnekler

Örnek 1: Tarihi görüntülemek için bir web sayfası oluşturma

Örnek 2: PowerShell diğer adlarını görüntülemek için bir web sayfası oluşturma

Örnek 3: PowerShell olaylarını görüntülemek için web sayfası oluşturma

Örnek 4: İşlemleri görüntülemek için web sayfası oluşturma

Örnek 5: Hizmet nesnelerini görüntülemek için web sayfası oluşturma

Örnek 6: Hizmet nesnelerini görüntülemek için web sayfası oluşturma

Örnek 7: Geçerli tarih için web tablosu oluşturma

Örnek 8: PowerShell olaylarını görüntülemek için web sayfası oluşturma

Örnek 9: Belirtilen hizmetleri görüntülemek için bir web sayfası oluşturma

Örnek 10: HTML'nin Meta özelliklerini ve Karakter Kümesini ayarlama

Örnek 11: HTML'yi XHTML Geçiş DTD'sine ayarlama

Parametreler

-As

-Body

-Charset

-CssUri

-Fragment

-Head

-InputObject

-Meta

-PostContent

-PreContent

-Property

-Title

-Transitional

Girişler

Çıkışlar

Notlar

Ek kaynaklar

Aracılığıyla paylaş

ConvertTo-Html

Sözdizimi

Description

Örnekler

Örnek 1: Tarihi görüntülemek için bir web sayfası oluşturma

Örnek 2: PowerShell diğer adlarını görüntülemek için bir web sayfası oluşturma

Örnek 3: PowerShell olaylarını görüntülemek için web sayfası oluşturma

Örnek 4: İşlemleri görüntülemek için web sayfası oluşturma

Örnek 5: Hizmet nesnelerini görüntülemek için web sayfası oluşturma

Örnek 6: Hizmet nesnelerini görüntülemek için web sayfası oluşturma

Örnek 7: Geçerli tarih için web tablosu oluşturma

Örnek 8: PowerShell olaylarını görüntülemek için web sayfası oluşturma

Örnek 9: Belirtilen hizmetleri görüntülemek için bir web sayfası oluşturma

Örnek 10: HTML'nin Meta özelliklerini ve Karakter Kümesini ayarlama

Örnek 11: HTML'yi XHTML Geçiş DTD'sine ayarlama

Parametreler

-As

-Body

-Charset

-CssUri

-Fragment

-Head

-InputObject

-Meta

-PostContent

-PreContent

-Property

-Title

-Transitional

Girişler

Çıkışlar

Notlar

İlişkili Bağlantılar

Ek kaynaklar