ConvertTo-Html

Modül:: Microsoft.PowerShell.Utility Module

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

Syntax

Page (Varsayılan)

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

Fragment

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

Description

ConvertTo-Html cmdlet'i.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.

nesne özelliklerini seçmek, tablo veya liste biçimi belirtmek, HTML sayfası başlığını belirtmek, nesneden önce ve sonra metin eklemek ve katı bir DTD sayfası yerine yalnızca tablo veya liste parçasını döndürmek için ConvertTo-Html parametrelerini kullanabilirsiniz.

ConvertTo-Html'ye birden ç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. komutunun sonuçlarını Get-Date cmdlet'ine göndermek için ConvertTo-Html parametresini 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.

Komut, diğer adları almak için Get-Alias cmdlet'ini kullanır. Diğer adları HTML sayfasını oluşturan | cmdlet'ine göndermek için işlem hattı işlecini (ConvertTo-Html) kullanır. Komut ayrıca html kodunu Out-File dosyasına göndermek için aliases.htm cmdlet'ini kullanır.

Ö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üğü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ı | cmdlet'ine göndermek için işlem hattı işlecini (ConvertTo-Html) kullanır. Komut ayrıca html kodunu Out-File dosyasına göndermek için pslog.htm cmdlet'ini kullanır.

Komut ayrıca html kodunu Out-File dosyasına göndermek için pslog.htm cmdlet'ini kullanır.

Ö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 Get-Process cmdlet'ini kullanır. Komut, işlem nesnelerini | cmdlet'ine göndermek için işlem hattı işlecini (ConvertTo-Html) kullanır.

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

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

Ö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, Get-Service cmdlet'in döndürdüğü hizmet nesnelerinin 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 bir <link rel="stylesheet" type="text/css" href="test.css"> etiketi 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, Get-Service cmdlet'in döndürdüğü hizmet nesnelerinin HTML sayfasını oluşturur. Komut, liste biçimini belirtmek için olarak parametresini kullanır. cmdlet Out-File, elde edilen HTML'yi Services.htm dosyasına 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 ConvertTo-Html kullanır. Komut, geçerli tarihi almak için Get-Date cmdlet'ini kullanır. Sonuçları | cmdlet'ine göndermek için bir işlem hattı işleci (ConvertTo-Html) kullanır.

ConvertTo-Html komutu, çıkışı html tablosuyla sınırlayan Fragment parametresini içerir. Sonuç olarak, 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 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 Get-EventLog cmdlet'ini kullanır.

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

ConvertTo-Html komutu Özelliği parametresini kullanarak yalnızca Kimliği, Düzeyve olayın Görev özelliklerini.

Ö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, bilgisayarda Aile başlayan hizmetleri görüntüleyen bir Web sayfası oluşturur ve açar. Çıktıyı özelleştirmek için Title, Body, PreContentve PostContent parametrelerini ConvertTo-Html kullanır.

Komutun ilk bölümü, Get-Serviceile başlayan hizmetleri bilgisayara almak için A cmdlet'ini kullanır. Komut, sonuçları | cmdlet'ine göndermek için bir işlem hattı işleci (ConvertTo-Html) kullanır. Komut ayrıca çıktıyı Out-File dosyasına göndermek için Services.htm cmdlet'ini kullanır.

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

Parametreler

-As

Nesnenin tablo veya liste olarak biçimlendirilip biçimlendirilmeyeceğini belirler. Geçerli değerler Tablo ve Listesi. Varsayılan değer tablo değeridir.

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.

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

Parametre özellikleri

Tür:	String
Default value:	None
Kabul edilen değerler:	Table, List
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

-Body

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

Parametre özellikleri

Tür:	String[]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

Page

Position:	3
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

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

Parametre özellikleri

Tür:	Uri
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	Cu, URI

Parametre kümeleri

Page

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

-Fragment

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

Parametre özellikleri

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

Parametre kümeleri

Fragment

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

-Head

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

Parametre özellikleri

Tür:	String[]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

Page

Position:	1
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

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, nesneleri ConvertTo-Htmlyöneltmek için işlem hattı işlecini kullanın.

Parametre özellikleri

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

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İş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

-PostContent

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

Parametre özellikleri

Tür:	String[]
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

-PreContent

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

Parametre özellikleri

Tür:	String[]
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

-Property

HTML'de nesnelerin belirtilen özelliklerini içerir. Özelliği 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:

Expression - <string> veya <scriptblock>
FormatString - <string>
Width - <int32> - 0 büyük olmalıdır
Alignment - değer Left, Centerveya Right olabilir

Daha fazla bilgi için, about_Calculated_Propertiesbölümüne bakın.

Parametre özellikleri

Tür:	Object[]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	0
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

-Title

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

Parametre özellikleri

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

Parametre kümeleri

Page

Position:	2
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

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, cmdlet'ine bir veya daha fazla nesne ekleyin 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'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 işlemleri ConvertTo-Htmliçin kanal oluşturursanı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 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, bir bilgisayardaki işlemleri göndermek için ConvertTo-Html kullanırsanız, sonuçta elde edilen tabloda bir nesne dizisi ve özellikleri görüntülenir.

XHTML Katı DTD'sine uymak için DOCTYPE etiketi 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"\>

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?

ConvertTo-Html

Syntax

Page (Varsayılan)

Fragment

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

Parametreler

-As

Parametre özellikleri

Parametre kümeleri

-Body

Parametre özellikleri

Parametre kümeleri

-CssUri

Parametre özellikleri

Parametre kümeleri

-Fragment

Parametre özellikleri

Parametre kümeleri

-Head

Parametre özellikleri

Parametre kümeleri

-InputObject

Parametre özellikleri

Parametre kümeleri

-PostContent

Parametre özellikleri

Parametre kümeleri

-PreContent

Parametre özellikleri

Parametre kümeleri

-Property

Parametre özellikleri

Parametre kümeleri

-Title

Parametre özellikleri

Parametre kümeleri

CommonParameters

Girişler

PSObject

Çıkışlar

String

Notlar

İlişkili Bağlantılar

Geri Bildirim