ConvertTo-Html

Modul:: Microsoft.PowerShell.Utility Module

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

Sintaks

Page (Default)

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

Fragment

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

Deskripsi

cmdlet ConvertTo-Html 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 perintah Get-Date ke cmdlet ConvertTo-Html.

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

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

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

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 cmdlet Get-Process untuk mendapatkan objek yang mewakili proses yang berjalan di komputer. Perintah menggunakan operator alur (|) untuk mengirim objek proses ke cmdlet ConvertTo-Html.

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 cmdlet Out-File untuk mengirim HTML yang dihasilkan ke file bernama Proc.htm.

Perintah kedua menggunakan cmdlet Invoke-Item 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 dikembalikan cmdlet Get-Service. Perintah menggunakan parameter CssUri untuk menentukan lembar gaya berjenjang untuk halaman HTML.

Parameter CssUri menambahkan tag <link rel="stylesheet" type="text/css" href="test.css"> tambahan 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 dikembalikan cmdlet Get-Service. Perintah menggunakan parameter Sebagai untuk menentukan format daftar. Cmdlet Out-File mengirim HTML yang dihasilkan ke file Services.htm.

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 cmdlet Get-Date untuk mendapatkan tanggal saat ini. Ini menggunakan operator alur (|) untuk mengirim hasil ke cmdlet ConvertTo-Html.

Perintah ConvertTo-Html mencakup parameter Fragmen, yang membatasi output ke tabel HTML. Akibatnya, elemen lain dari halaman HTML, seperti tag <HEAD> 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 cmdlet Get-EventLog untuk mendapatkan peristiwa dari log peristiwa Windows PowerShell.

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

Perintah ConvertTo-Html menggunakan parameter Properti untuk memilih hanya id , Tingkat, dan properti 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 Judul, Body, PreContent , dan parameter PostContentConvertTo-Html untuk menyesuaikan output.

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

Titik koma (;) mengakhiri perintah pertama dan memulai perintah kedua, yang menggunakan cmdlet Invoke-Item untuk membuka file Services.htm 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.

Properti parameter

Jenis:	String
Nilai default:	None
Nilai yang diterima:	Table, List
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Body

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

Properti parameter

Jenis:	String[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

Page

Position:	3
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Charset

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

Parameter ini diperkenalkan di PowerShell 6.0.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

Page

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	Uri
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	Cu, URI

Kumpulan parameter

Page

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Fragment

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

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

Fragment

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Head

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

Properti parameter

Jenis:	String[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

Page

Position:	1
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	PSObject
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	True
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Meta

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

Parameter ini diperkenalkan di PowerShell 6.0.

Properti parameter

Jenis:	Hashtable
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

Page

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-PostContent

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

Properti parameter

Jenis:	String[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-PreContent

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

Properti parameter

Jenis:	String[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Property

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

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

Untuk informasi lebih lanjut, lihat tentang_Properti_Terhitung.

Properti parameter

Jenis:	Object[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	0
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Title

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

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

Page

Position:	2
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Transitional

Mengubah DOCTYPE ke DTD Transisi XHTML, DOCTYPE Default DTD Ketat XHTML .

Parameter ini diperkenalkan di PowerShell 6.0.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

Page

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

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, tag DOCTYPE dimodifikasi dengan sesuai:

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

Saran dan Komentar

Apakah halaman ini membantu?

Bagikan melalui

ConvertTo-Html

Sintaks

Page (Default)

Fragment

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

Properti parameter

Kumpulan parameter

-Body

Properti parameter

Kumpulan parameter

-Charset

Properti parameter

Kumpulan parameter

-CssUri

Properti parameter

Kumpulan parameter

-Fragment

Properti parameter

Kumpulan parameter

-Head

Properti parameter

Kumpulan parameter

-InputObject

Properti parameter

Kumpulan parameter

-Meta

Properti parameter

Kumpulan parameter

-PostContent

Properti parameter

Kumpulan parameter

-PreContent

Properti parameter

Kumpulan parameter

-Property

Properti parameter

Kumpulan parameter

-Title

Properti parameter

Kumpulan parameter

-Transitional

Properti parameter

Kumpulan parameter

CommonParameters

Input

PSObject

Output

String

Catatan

Link Terkait

Saran dan Komentar