ConvertTo-Html

Referensi

Modul:: Microsoft.PowerShell.Utility

Mengonversi objek .NET menjadi HTML yang dapat ditampilkan di browser Web.

Sintaks

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

Deskripsi

ConvertTo-Html Cmdlet mengonversi objek .NET menjadi HTML yang dapat ditampilkan di browser Web. Anda dapat menggunakan cmdlet ini untuk menampilkan output perintah di halaman Web.

Anda dapat menggunakan parameter ConvertTo-Html untuk memilih properti objek, untuk menentukan format tabel atau daftar, untuk menentukan judul halaman HTML, untuk menambahkan teks sebelum dan sesudah objek, dan untuk mengembalikan hanya fragmen tabel atau daftar, bukan halaman DTD yang ketat.

Saat Anda mengirimkan beberapa objek ke ConvertTo-Html, PowerShell membuat tabel (atau daftar) berdasarkan properti objek pertama yang Anda kirimkan. Jika objek yang tersisa tidak memiliki salah satu properti yang ditentukan, nilai properti objek tersebut adalah sel kosong. Jika objek yang tersisa memiliki properti tambahan, nilai properti tersebut tidak disertakan dalam file.

Contoh

Contoh 1: Membuat halaman web untuk menampilkan tanggal

ConvertTo-Html -InputObject (Get-Date)

Perintah ini membuat halaman HTML yang menampilkan properti tanggal saat ini. Ini menggunakan parameter InputObject untuk mengirimkan hasil Get-Date perintah ke ConvertTo-Html cmdlet.

Contoh 2: Membuat halaman web untuk menampilkan alias PowerShell

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

Perintah ini membuat halaman HTML yang mencantumkan alias PowerShell di konsol saat ini.

Perintah menggunakan Get-Alias cmdlet untuk mendapatkan alias. Ini menggunakan operator alur (|) untuk mengirim alias ke ConvertTo-Html cmdlet, yang membuat halaman HTML. Perintah ini juga menggunakan Out-File cmdlet untuk mengirim kode HTML ke aliases.htm file.

Contoh 3: Membuat halaman web untuk menampilkan peristiwa PowerShell

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

Perintah ini membuat halaman HTML yang disebut pslog.htm yang menampilkan peristiwa di log peristiwa Windows PowerShell di komputer lokal.

Ini menggunakan Get-EventLog cmdlet untuk mendapatkan peristiwa di log Windows PowerShell lalu menggunakan operator alur (|) untuk mengirim peristiwa ke ConvertTo-Html cmdlet. Perintah ini juga menggunakan Out-File cmdlet untuk mengirim kode HTML ke pslog.htm file.

Perintah ini juga menggunakan Out-File cmdlet untuk mengirim kode HTML ke pslog.htm file.

Contoh 4: Membuat halaman web untuk menampilkan proses

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

Perintah ini membuat dan membuka halaman HTML yang mencantumkan nama, jalur, dan perusahaan proses di komputer lokal.

Perintah pertama menggunakan Get-Process cmdlet untuk mendapatkan objek yang mewakili proses yang berjalan di komputer. Perintah menggunakan operator alur (|) untuk mengirim objek proses ke ConvertTo-Html cmdlet.

Perintah menggunakan parameter Properti untuk memilih tiga properti objek proses yang akan disertakan dalam tabel. Perintah menggunakan parameter Judul untuk menentukan judul untuk halaman HTML. Perintah ini juga menggunakan Out-File cmdlet untuk mengirim HTML yang dihasilkan ke file bernama Proc.htm.

Perintah kedua menggunakan Invoke-Item cmdlet untuk membuka Proc.htm di browser default.

Contoh 5: Membuat halaman web untuk menampilkan objek layanan

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

Perintah ini membuat halaman HTML dari objek layanan yang Get-Service dikembalikan cmdlet. Perintah menggunakan parameter CssUri untuk menentukan lembar gaya berjenjang untuk halaman HTML.

Parameter CssUri menambahkan tag tambahan <link rel="stylesheet" type="text/css" href="test.css"> ke HTML yang dihasilkan. Atribut HREF dalam tag berisi nama lembar gaya.

Contoh 6: Membuat halaman web untuk menampilkan objek layanan

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

Perintah ini membuat halaman HTML dari objek layanan yang Get-Service dikembalikan cmdlet. Perintah menggunakan parameter Sebagai untuk menentukan format daftar. Cmdlet Out-File mengirimkan HTML yang dihasilkan ke Services.htm file.

Contoh 7: Membuat tabel web untuk tanggal saat ini

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>

Perintah ini menggunakan ConvertTo-Html untuk menghasilkan tabel HTML dari tanggal saat ini. Perintah menggunakan Get-Date cmdlet untuk mendapatkan tanggal saat ini. Ini menggunakan operator alur (|) untuk mengirim hasil ke ConvertTo-Html cmdlet.

Perintah ConvertTo-Html ini mencakup parameter Fragmen , yang membatasi output ke tabel HTML. Akibatnya, elemen lain dari halaman HTML, seperti <HEAD> tag dan <BODY> , dihilangkan.

Contoh 8: Membuat halaman web untuk menampilkan peristiwa PowerShell

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

Perintah ini menggunakan Get-EventLog cmdlet untuk mendapatkan peristiwa dari log peristiwa Windows PowerShell.

Ini menggunakan operator alur (|) untuk mengirim peristiwa ke ConvertTo-Html cmdlet, yang mengonversi peristiwa ke format HTML.

Perintah ConvertTo-Html menggunakan parameter Properti untuk hanya memilih properti ID, Tingkat, dan Tugas peristiwa.

Contoh 9: Membuat halaman web untuk menampilkan layanan tertentu

$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

Perintah ini membuat dan membuka halaman Web yang menampilkan layanan di komputer yang dimulai dengan A. Ini menggunakan parameter Title, Body, PreContent, dan PostContent untuk menyesuaikan output. ConvertTo-Html

Bagian pertama dari perintah menggunakan Get-Service cmdlet untuk mendapatkan layanan di komputer yang dimulai dengan A. Perintah menggunakan operator alur (|) untuk mengirim hasil ke ConvertTo-Html cmdlet. Perintah ini juga menggunakan Out-File cmdlet untuk mengirim output ke Services.htm file.

Titik koma (;) mengakhiri perintah pertama dan memulai perintah kedua, yang menggunakan Invoke-Item cmdlet untuk membuka Services.htm file di browser default.

Contoh 10: Atur properti Meta dan Charset HTML

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

Perintah ini membuat HTML untuk halaman web dengan tag meta untuk refresh, penulis, dan kata kunci. Set karakter untuk halaman diatur ke UTF-8

Contoh 11: Atur HTML ke DTD Transisi XHTML

Get-Service | ConvertTo-HTML -Transitional

Perintah ini mengatur DOCTYPE HTML yang dikembalikan ke DTD Transisi XHTML

Parameter

-As

Menentukan apakah objek diformat sebagai tabel atau daftar. Nilai yang valid adalah Tabel dan Daftar. Nilai defaultnya adalah Tabel.

Nilai Tabel menghasilkan tabel HTML yang menyerupan format tabel PowerShell. Baris header menampilkan nama properti. Setiap baris tabel mewakili objek dan menampilkan nilai objek untuk setiap properti.

Nilai Daftar menghasilkan tabel HTML dua kolom untuk setiap objek yang menyerupan format daftar PowerShell. Kolom pertama menampilkan nama properti. Kolom kedua menampilkan nilai properti.

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

-Body

Menentukan teks yang akan ditambahkan setelah tag pembuka <BODY> . Secara default, tidak ada teks dalam posisi tersebut.

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

-Charset

Menentukan teks untuk ditambahkan ke tag pembuka <charset> . Secara default, tidak ada teks dalam posisi tersebut.

Parameter ini diperkenalkan di PowerShell 6.0.

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

-CssUri

Menentukan Pengidentifikasi Sumber Daya Seragam (URI) dari lembar gaya berskala (CSS) yang diterapkan ke file HTML. URI disertakan dalam tautan lembar gaya dalam output.

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

-Fragment

Hanya menghasilkan tabel HTML. Tag <HTML>, <HEAD>, <TITLE>, dan <BODY> dihilangkan.

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

-Head

Menentukan konten <HEAD> tag. Default adalah <title\>HTML TABLE</title>. Jika Anda menggunakan parameter Head , parameter Judul diabaikan.

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

-InputObject

Menentukan objek yang akan diwakili dalam HTML. Masukkan variabel yang berisi objek atau ketik perintah atau ekspresi yang mendapatkan objek.

Jika Anda menggunakan parameter ini untuk mengirimkan beberapa objek, seperti semua layanan di komputer, ConvertTo-Html membuat tabel yang menampilkan properti koleksi atau array objek. Untuk membuat tabel objek individual, gunakan operator alur untuk menyalurkan objek ke ConvertTo-Html.

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

-Meta

Menentukan teks untuk ditambahkan ke tag pembuka <meta> . Secara default, tidak ada teks dalam posisi tersebut.

Parameter ini diperkenalkan di PowerShell 6.0.

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

-PostContent

Menentukan teks yang akan ditambahkan setelah tag penutup </TABLE> . Secara default, tidak ada teks dalam posisi tersebut.

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

-PreContent

Menentukan teks yang akan ditambahkan sebelum tag pembuka <TABLE> . Secara default, tidak ada teks dalam posisi tersebut.

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

-Property

Menyertakan properti objek yang ditentukan dalam HTML. Nilai parameter Properti dapat menjadi properti terhitung baru. Properti terhitung dapat berupa blok skrip atau tabel hash. Pasangan kunci-nilai yang valid adalah:

Name (atau label) - <string> (ditambahkan di PowerShell 6.x)
Expression - <string> atau <script block>
FormatString - <string>
Width - <int32> - harus lebih besar dari 0
Alignment - nilai dapat berupa Left, Center, atau Right

Untuk informasi selengkapnya, lihat about_Calculated_Properties.

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

-Title

Menentukan judul untuk file HTML, yaitu teks yang muncul di <TITLE> antara tag.

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

-Transitional

DOCTYPE Mengubah DTD Transisi XHTML, Defaultnya DOCTYPE adalah XHTML Strict DTD.

Parameter ini diperkenalkan di PowerShell 6.0.

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

Input

PSObject

Anda dapat menyalurkan objek apa pun ke cmdlet ini.

Output

String

Cmdlet ini mengembalikan array string HTML yang mewakili objek yang dikonversi.

Catatan

Untuk menggunakan cmdlet ini, pipa satu atau beberapa objek ke cmdlet atau gunakan parameter InputObject untuk menentukan objek. Ketika input terdiri dari beberapa objek, output dari kedua metode ini cukup berbeda.

Saat Anda menyalurkan beberapa objek ke cmdlet, PowerShell mengirim objek ke cmdlet satu per satu. Akibatnya, ConvertTo-Html membuat tabel yang menampilkan objek individual. Misalnya, jika Anda menyalurkan proses di komputer ke ConvertTo-Html, tabel yang dihasilkan menampilkan semua proses.
Saat Anda menggunakan parameter InputObject untuk mengirimkan beberapa objek, ConvertTo-Html menerima objek ini sebagai koleksi atau sebagai array. Akibatnya, ia membuat tabel yang menampilkan array dan propertinya, bukan item dalam array. Misalnya, jika Anda menggunakan InputObject untuk mengirimkan proses di komputer ke ConvertTo-Html, tabel yang dihasilkan menampilkan array objek dan propertinya.

Untuk mematuhi DTD Ketat XHTML, DOCTYPE tag dimodifikasi dengan sesuai:

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

ConvertTo-Html

Sintaks

Deskripsi

Contoh

Contoh 1: Membuat halaman web untuk menampilkan tanggal

Contoh 2: Membuat halaman web untuk menampilkan alias PowerShell

Contoh 3: Membuat halaman web untuk menampilkan peristiwa PowerShell

Contoh 4: Membuat halaman web untuk menampilkan proses

Contoh 5: Membuat halaman web untuk menampilkan objek layanan

Contoh 6: Membuat halaman web untuk menampilkan objek layanan

Contoh 7: Membuat tabel web untuk tanggal saat ini

Contoh 8: Membuat halaman web untuk menampilkan peristiwa PowerShell

Contoh 9: Membuat halaman web untuk menampilkan layanan tertentu

Contoh 10: Atur properti Meta dan Charset HTML

Contoh 11: Atur HTML ke DTD Transisi XHTML

Parameter

-As

-Body

-Charset

-CssUri

-Fragment

-Head

-InputObject

-Meta

-PostContent

-PreContent

-Property

-Title

-Transitional

Input

Output

Catatan

Saran dan Komentar

Sumber Daya Tambahan:

ConvertTo-Html

Sintaks

Deskripsi

Contoh

Contoh 1: Membuat halaman web untuk menampilkan tanggal

Contoh 2: Membuat halaman web untuk menampilkan alias PowerShell

Contoh 3: Membuat halaman web untuk menampilkan peristiwa PowerShell

Contoh 4: Membuat halaman web untuk menampilkan proses

Contoh 5: Membuat halaman web untuk menampilkan objek layanan

Contoh 6: Membuat halaman web untuk menampilkan objek layanan

Contoh 7: Membuat tabel web untuk tanggal saat ini

Contoh 8: Membuat halaman web untuk menampilkan peristiwa PowerShell

Contoh 9: Membuat halaman web untuk menampilkan layanan tertentu

Contoh 10: Atur properti Meta dan Charset HTML

Contoh 11: Atur HTML ke DTD Transisi XHTML

Parameter

-As

-Body

-Charset

-CssUri

-Fragment

-Head

-InputObject

-Meta

-PostContent

-PreContent

-Property

-Title

-Transitional

Input

Output

Catatan

Link Terkait

Saran dan Komentar

Sumber Daya Tambahan: