ConvertTo-Html (Microsoft.PowerShell.Utility)

ConvertTo-Html

Modül:: Microsoft.PowerShell.Utility

.NET nesnelerini Web tarayıcısında görüntülenebilecek 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>]

Tanım

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

Nesne özelliklerini seçmek, bir tablo veya liste biçimi belirtmek, HTML sayfa başlığını belirtmek, nesnenin önüne ve arkasına metin eklemek ve yalnızca nesneyi döndürmek için ConvertTo-Html parametrelerini kullanabilirsiniz. katı bir DTD sayfası yerine tablo veya liste parçası.

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

Örnekler

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

ConvertTo-Html -InputObject (Get-Date)

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

Örnek 2: PowerShell takma adlarını görüntülemek için bir web sayfası oluşturun

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

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

Komut, takma adları almak için Get-Alias cmdlet'ini kullanır. Takma adları HTML sayfasını oluşturan ConvertTo-Html cmdlet'ine göndermek için ardışık düzen operatörünü (|) kullanır. Komut aynı zamanda HTML kodunu aliases.htm dosyasına göndermek için Out-File cmdlet'ini de kullanır.

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

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

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

Windows PowerShell günlüğündeki olayları almak için Get-EventLog cmdlet'ini kullanır ve ardından olayları ConvertTo-'ya göndermek için ardışık düzen operatörünü (|) kullanır. Html cmdlet'i. Komut aynı zamanda HTML kodunu pslog.htm dosyasına göndermek için Out-File cmdlet'ini de kullanır.

Komut aynı zamanda HTML kodunu pslog.htm dosyasına göndermek için Out-File cmdlet'ini de kullanır.

Örnek 4: Süreçleri görüntülemek için bir web sayfası oluşturun

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 Get-Process cmdlet'ini kullanır. Komut, işlem nesnelerini ConvertTo-Html cmdlet'ine göndermek için ardışık düzen operatörünü (|) kullanır.

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

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

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

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, Get-Service cmdlet'inin döndürdüğü hizmet nesnelerinin bir HTML sayfasını oluşturur. Komut, HTML sayfası için basamaklı bir stil sayfası belirtmek üzere CssUri parametresini kullanır.

CssUri parametresi, ortaya çıkan HTML'ye ek bir <link rel="stylesheet" type="text/css" href="test.css"> etiketi ekler. Etiketteki HREF özelliği stil sayfasının adını içerir.

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

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

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

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

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 bir HTML tablosunu oluşturmak için ConvertTo-Html'i kullanır. Komut, geçerli tarihi almak için Get-Date cmdlet'ini kullanır. Sonuçları ConvertTo-Html cmdlet'ine göndermek için bir ardışık düzen operatörü (|) kullanır.

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

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

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

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

Olayları, olayları HTML biçimine dönüştüren ConvertTo-Html cmdlet'ine göndermek için bir ardışık düzen operatörü (|) kullanır.

ConvertTo-Html komutu yalnızca Kimlik, Seviye ve Görevi seçmek için Özellik parametresini kullanır etkinliğin özellikleri.

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

$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, bilgisayardaki A ile başlayan hizmetleri görüntüleyen bir Web sayfası oluşturur ve açar. ConvertTo-HtmlTitle, Body, PreContent ve PostContent parametrelerini kullanır. > çıktıyı özelleştirmek için.

Komutun ilk kısmı, bilgisayardaki A ile başlayan hizmetleri almak için Get-Service cmdlet'ini kullanır. Komut, sonuçları ConvertTo-Html cmdlet'ine göndermek için bir ardışık düzen operatörü (|) kullanır. Komut aynı zamanda çıktıyı Services.htm dosyasına göndermek için Out-File cmdlet'ini de kullanır.

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

Örnek 10: HTML'nin Meta özelliklerini ve Karakter Kümesini ayarlayın

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üklere yönelik 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şli DTD olarak ayarlayın

Get-Service | ConvertTo-HTML -Transitional

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

Parametreler

-As

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

Table değeri, PowerShell tablo biçimine benzeyen bir HTML tablosu oluşturur. Başlık satırı özellik adlarını görüntüler. Her tablo satırı bir nesneyi temsil eder ve nesnenin her özelliğe ilişkin 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ütun özellik adını görüntüler. İkinci sütun özellik değerini görüntüler.

Tip :: String
Kabul edilen değerler:: Tablo, Liste
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-Body

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

Tip :: String[]
Konum:: 3
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: 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 tanıtıldı.

Tip :: String
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: 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 dahil edilir.

Tip :: Uri
Takma adlar:: cu, uri
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-Fragment

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

Tip :: SwitchParameter
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-Head

<HEAD> etiketinin içeriğini belirtir. Varsayılan <title\>HTML TABLE</title> şeklindedir. Başlık parametresini kullanırsanız Başlık parametresi yoksayılır.

Tip :: String[]
Konum:: 1
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-InputObject

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

Bu parametreyi, bilgisayardaki tüm hizmetler gibi birden fazla nesne göndermek için kullanırsanız, ConvertTo-Html, bir koleksiyonun veya bir nesne dizisinin özelliklerini görüntüleyen bir tablo oluşturur. Tek tek nesnelerin bir tablosunu oluşturmak için, nesneleri ConvertTo-Html'e yönlendirmek üzere ardışık düzen operatörünü kullanın.

Tip :: PSObject
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: 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 tanıtıldı.

Tip :: Karma tablo
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-PostContent

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

Tip :: String[]
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-PreContent

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

Tip :: String[]
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-Property

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

Ad (veya etiket) - <string> (PowerShell 6.x'te eklendi)
İfade - <string> veya <script; bloğu>
FormatString - <string>
Genişlik - <int32> - 0'dan büyük olmalıdır
Hizalama - değer Sol, Orta veya Sağ olabilir

Daha fazla bilgi için bkz. about_Calculated_Properties.

Tip :: Object[]
Konum:: 0
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-Title

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

Tip :: String
Konum:: 2
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-Transitional

DOCTYPE'ı XHTML Geçişli DTD olarak değiştirir, Varsayılan DOCTYPE XHTML Strict DTD'dir.

Bu parametre PowerShell 6,0'da tanıtıldı.

Tip :: SwitchParameter
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

Girişler

PSObject

Bu cmdlet'e herhangi bir nesneyi aktarabilirsiniz.

Çıkışlar

Dize

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'e yönlendirin veya nesneyi belirtmek için InputObject parametresini kullanın. Giriş birden fazla nesneden oluştuğunda bu iki yöntemin çıktısı oldukça farklıdır.

Bir cmdlet'e birden fazla nesne aktardığınızda PowerShell, nesneleri cmdlet'e teker teker gönderir. Sonuç olarak ConvertTo-Html, tek tek nesneleri görüntüleyen bir tablo oluşturur. Örneğin, bir bilgisayardaki işlemleri ConvertTo-Html'e yönlendirirseniz ortaya çıkan tablo tüm işlemleri görüntüler.
Birden fazla nesne göndermek için InputObject parametresini kullandığınızda, ConvertTo-Html bu nesneleri bir 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, bilgisayardaki işlemleri ConvertTo-Html'e göndermek için InputObject'i kullanırsanız ortaya çıkan tablo, bir nesne dizisini ve onun özelliklerini görüntüler.
XHTML Strict DTD'ye uymak için DOCTYPE etiketi buna göre değiştirildi:
```
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"   "https://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"\>
```

ConvertTo-Html (Microsoft.PowerShell.Utility)

ConvertTo-Html

Sözdizimi

Tanım

Örnekler

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

Örnek 2: PowerShell takma adlarını görüntülemek için bir web sayfası oluşturun

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

Örnek 4: Süreçleri görüntülemek için bir web sayfası oluşturun

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

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

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

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

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

Örnek 10: HTML'nin Meta özelliklerini ve Karakter Kümesini ayarlayın

Örnek 11: HTML'yi XHTML Geçişli DTD olarak ayarlayın

Parametreler

-As

-Body

-Charset

-CssUri

-Fragment

-Head

-InputObject

-Meta

-PostContent

-PreContent

-Property

-Title

-Transitional

Girişler

Çıkışlar

Notlar

İlgili makaleler