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.

Syntax

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 çıkışını görüntülemek için kullanabilirsiniz.

parametrelerini kullanarak ConvertTo-Html 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ı İçerik Oluşturucu

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ı İçerik Oluşturucu

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 bir web sayfası İçerik Oluşturucu

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 ConvertTo-Html göndermek için işlem hattı işlecini (| ) 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 bir web sayfası İçerik Oluşturucu

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 hattı işlecini (|) kullanarak işlem nesnelerini cmdlet'ine ConvertTo-Html gönderir.

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, sonuçta elde edilen Out-File HTML'yi 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 bir web sayfası İçerik Oluşturucu

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. Etiketindeki HREF özniteliği stil sayfasının adını içerir.

Örnek 6: Hizmet nesnelerini görüntülemek için bir web sayfası İçerik Oluşturucu

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 bir web tablosu İçerik Oluşturucu

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 . Komut, geçerli tarihi almak için cmdlet'ini kullanır Get-Date . Sonuçları ConvertTo-Html cmdlet'e göndermek için bir işlem hattı işleci (|) kullanır.

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

Örnek 8: PowerShell olaylarını görüntülemek için bir web sayfası İçerik Oluşturucu

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

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

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ı İçerik Oluşturucu

$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 kullanarak Get-Service ile başlayan Abilgisayardaki hizmetleri alır. Komut, sonuçları ConvertTo-Html cmdlet'e göndermek için bir işlem hattı işleci (|) kullanır. Komutu, çıktıyı Out-File dosyaya 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 komutu 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, yazar 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çimlendirilmediğ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ında özellik adları görüntülenir. Her tablo satırı bir nesneyi temsil eder ve her özellik için nesnenin değerlerini görüntüler.

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

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

-Body

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

Type:	String[]
Position:	3
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-CssUri

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

Type:	Uri
Aliases:	cu, uri
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Fragment

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String[]
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	PSObject
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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.

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

-PostContent

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

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PreContent

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

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Property

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

Name (veya etiket) - <string> (PowerShell 6.x'e 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.

Type:	Object[]
Position:	0
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Title

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

Type:	String
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Transitional

DOCTYPEXHTML 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.

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

Girişler

PSObject

Herhangi bir .NET nesnesini öğesine yöneltebilirsiniz ConvertTo-Html.

Çıkışlar

System.String or System.Xml.XmlDocument

ConvertTo-Html geçerli HTML'i oluşturan dize serisini döndürür.

Notlar

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

Bir cmdlet'e 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 işlemleri öğesine ConvertTo-Htmlaktarırsanız, sonuçta elde edilen tablo tüm işlemleri görüntüler.
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 tablo bir nesne dizisini ve özelliklerini görüntüler.

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

Syntax

Description

Örnekler

Örnek 1: Tarihi görüntülemek için bir web sayfası İçerik Oluşturucu

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

Örnek 3: PowerShell olaylarını görüntülemek için bir web sayfası İçerik Oluşturucu

Örnek 4: İşlemleri görüntülemek için bir web sayfası İçerik Oluşturucu

Örnek 5: Hizmet nesnelerini görüntülemek için bir web sayfası İçerik Oluşturucu

Örnek 6: Hizmet nesnelerini görüntülemek için bir web sayfası İçerik Oluşturucu

Örnek 7: Geçerli tarih için bir web tablosu İçerik Oluşturucu

Örnek 8: PowerShell olaylarını görüntülemek için bir web sayfası İçerik Oluşturucu

Örnek 9: Belirtilen hizmetleri görüntülemek için bir web sayfası İçerik Oluşturucu

Ö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

Syntax

Description

Örnekler

Örnek 1: Tarihi görüntülemek için bir web sayfası İçerik Oluşturucu

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

Örnek 3: PowerShell olaylarını görüntülemek için bir web sayfası İçerik Oluşturucu

Örnek 4: İşlemleri görüntülemek için bir web sayfası İçerik Oluşturucu

Örnek 5: Hizmet nesnelerini görüntülemek için bir web sayfası İçerik Oluşturucu

Örnek 6: Hizmet nesnelerini görüntülemek için bir web sayfası İçerik Oluşturucu

Örnek 7: Geçerli tarih için bir web tablosu İçerik Oluşturucu

Örnek 8: PowerShell olaylarını görüntülemek için bir web sayfası İçerik Oluşturucu

Örnek 9: Belirtilen hizmetleri görüntülemek için bir web sayfası İçerik Oluşturucu

Ö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