ConvertTo-Html
Převede objekty rozhraní Microsoft .NET Framework na html, které lze zobrazit ve webovém prohlížeči.
Syntaxe
ConvertTo-Html
[-InputObject <PSObject>]
[[-Property] <Object[]>]
[[-Body] <String[]>]
[[-Head] <String[]>]
[[-Title] <String>]
[-As <String>]
[-CssUri <Uri>]
[-PostContent <String[]>]
[-PreContent <String[]>]
[<CommonParameters>] ConvertTo-Html
[-InputObject <PSObject>]
[[-Property] <Object[]>]
[-As <String>]
[-Fragment]
[-PostContent <String[]>]
[-PreContent <String[]>]
[<CommonParameters>] Description
Rutina ConvertTo-Html převede objekty rozhraní .NET Framework na html, které lze zobrazit ve webovém prohlížeči. Tuto rutinu můžete použít k zobrazení výstupu příkazu na webové stránce.
Pomocí parametrů ConvertTo-Html vybrat vlastnosti objektu, určit formát tabulky nebo seznamu, zadat název stránky HTML, přidat text před a za objekt a vrátit pouze fragment tabulky nebo seznamu místo striktní stránky DTD.
Když odešlete více objektů do ConvertTo-Html, Windows PowerShell vytvoří tabulku nebo seznam na základě vlastností prvního objektu, který odešlete. Pokud zbývající objekty nemají jednu ze zadaných vlastností, hodnota vlastnosti tohoto objektu je prázdná buňka. Pokud zbývající objekty mají další vlastnosti, tyto hodnoty vlastností nejsou zahrnuty do souboru.
Příklady
Příklad 1: Vytvoření webové stránky pro zobrazení data
PS C:\> ConvertTo-Html -InputObject (Get-Date)Tento příkaz vytvoří stránku HTML, která zobrazí vlastnosti aktuálního data. Pomocí parametru InputObject odešle výsledky příkazu Get-Date do rutiny ConvertTo-Html.
Příklad 2: Vytvoření webové stránky pro zobrazení aliasů PowerShellu
PS C:\> Get-Alias | ConvertTo-Html | Out-File aliases.htm
PS C:\> Invoke-Item aliases.htmTento příkaz vytvoří stránku HTML se seznamem aliasů Windows PowerShellu v aktuální konzole.
Příkaz používá rutinu Get-Alias k získání aliasů. Pomocí operátoru kanálu (|) odešle aliasy do rutiny ConvertTo-Html, která vytvoří stránku HTML. Příkaz také používá rutinu Out-File k odeslání kódu HTML do souboru aliases.htm.
Příklad 3: Vytvoření webové stránky pro zobrazení událostí PowerShellu
PS C:\> Get-EventLog -LogName "Windows PowerShell" | ConvertTo-Html | Out-File pslog.htmTento příkaz vytvoří stránku HTML s názvem pslog.htm, která zobrazí události v protokolu událostí Windows PowerShellu na místním počítači.
Pomocí rutiny Get-EventLog získá události v protokolu Prostředí Windows PowerShell a pak pomocí operátoru kanálu (|) odešle události do rutiny ConvertTo-Html.
Příkaz také používá rutinu Out-File k odeslání kódu HTML do souboru pslog.htm.
Příklad 4: Vytvoření webové stránky pro zobrazení procesů
PS C:\> Get-Process | ConvertTo-Html -Property Name, Path, Company -Title "Process Information" | Out-File proc.htm; ii proc.htmTyto příkazy vytvoří a otevřou stránku HTML, která obsahuje název, cestu a společnost procesů v místním počítači.
První příkaz používá rutinu Get-Process k získání objektů, které představují procesy spuštěné v počítači. Příkaz pomocí operátoru kanálu (|) odešle objekty procesu do rutiny ConvertTo-Html.
Příkaz používá parametr Vlastnost k výběru tří vlastností procesních objektů, které mají být zahrnuty do tabulky. Příkaz používá parametr Title k určení názvu stránky HTML. Příkaz také používá rutinu Out-File k odeslání výsledného kódu HTML do souboru s názvem Proc.htm.
Druhý příkaz používá rutinu Invoke-Item (alias = ii) k otevření Proc.htm ve výchozím prohlížeči. Dva příkazy jsou oddělené středníkem (;).
Příklad 5: Vytvoření webové stránky pro zobrazení objektů služby
PS> 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" />
...Tento příkaz vytvoří stránku HTML objektů služby, které Get-Service rutina vrátí. Příkaz používá parametr CssUri k určení šablony stylů CSS pro stránku HTML.
Parametr CssUri přidá do výsledného kódu HTML další <link rel="stylesheet" type="text/css"/ href="test.css>". Atribut HREF ve značce obsahuje název šablony stylů.
Příklad 6: Vytvoření webové stránky pro zobrazení objektů služby
PS C:\> Get-Service | ConvertTo-Html -As LIST | Out-File services.htmTento příkaz vytvoří stránku HTML objektů služby, které Get-Service rutina vrátí. Příkaz používá parametr As k určení formátu seznamu. Rutina Out-File odešle výsledný kód HTML do souboru Services.htm.
Příklad 7: Vytvoření webové tabulky pro aktuální datum
PS C:\> Get-Date | cth -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>Tento příkaz používá ConvertTo-Html k vygenerování tabulky HTML aktuálního data. Příkaz použije rutinu Get-Date k získání aktuálního data. Pomocí operátoru kanálu (|) odesílá výsledky do rutiny ConvertTo-Html (aliased as cth).
Příkaz ConvertTo-Html obsahuje parametr Fragment, který omezuje výstup na tabulku HTML. V důsledku toho se vynechá ostatní prvky stránky HTML, například> HEAD <a <BODY> značky.
Příklad 8: Vytvoření webové stránky pro zobrazení událostí PowerShellu
PS C:\> Get-EventLog -Log "Windows PowerShell" | ConvertTo-Html -Property id, level, taskTento příkaz používá rutinu Get-EventLog k získání událostí z protokolu událostí Prostředí Windows PowerShell.
Pomocí operátoru kanálu (|) odesílá události do rutiny ConvertTo-Html, která převádí události do formátu HTML.
Příkaz ConvertTo-Html používá parametr Vlastnost k výběru pouze vlastností ID, úrovně a úlohy události.
Příklad 9: Vytvoření webové stránky pro zobrazení zadaných služeb
PS C:\> Get-Service A* | ConvertTo-Html -Title "Windows Services: Server01" -Body (get-date) -Pre
"<P>Generated by Corporate IT</P>" -Post "For details, contact Corporate IT." | Out-File services.htm; ii services.htmTento příkaz vytvoří a otevře webovou stránku, která zobrazí služby v počítači, který začíná na A. K přizpůsobení výstupu používá Title, Body, PreContenta PostContent parametry ConvertTo- Html.
První část příkazu používá rutinu Get-Service k získání služeb v počítači, který začíná na A. Příkaz pomocí operátoru kanálu (|) odešle výsledky do rutiny ConvertTo-Html. Příkaz také používá rutinu Out-File k odeslání výstupu do souboru Services.htm.
Středník (;) ukončí první příkaz a spustí druhý příkaz, který pomocí rutiny Invoke-Item (alias = "ii") otevře soubor Services.htm ve výchozím prohlížeči.
Parametry
-As
Určuje, zda je objekt formátován jako tabulka nebo seznam. Přijatelné hodnoty pro tento parametr jsou: Table a List. Výchozí hodnota je Tabulka.
Hodnota Tabulka generuje tabulku HTML, která se podobá formátu tabulky Windows PowerShellu. Řádek záhlaví zobrazuje názvy vlastností. Každý řádek tabulky představuje objekt a zobrazuje hodnoty objektu pro každou vlastnost.
Hodnota List vygeneruje pro každý objekt tabulku ve formátu HTML se dvěma sloupci, která se podobá formátu seznamu Windows PowerShellu. První sloupec zobrazí název vlastnosti; druhý sloupec zobrazí hodnotu vlastnosti.
| Typ: | String |
| Přípustné hodnoty: | Table, List |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Body
Určuje text, který se má přidat za levou značku <BODY>. Ve výchozím nastavení není v této pozici žádný text.
| Typ: | String[] |
| Position: | 3 |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-CssUri
Určuje identifikátor URI (Uniform Resource Identifier) šablony stylů CSS (Cascading Style Sheet), který se použije u souboru HTML. Identifikátor URI je součástí odkazu šablony stylů ve výstupu.
| Typ: | Uri |
| Aliasy: | cu, uri |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Fragment
Označuje, že tato rutina generuje pouze tabulku HTML. Značky HTML, HEAD, TITLE a BODY jsou vynechány.
| Typ: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Head
Určuje obsah značky <HEAD> jako pole. Výchozí hodnota je <název>HTML TABLE</title>. Pokud použijete parametr Head, bude parametr Title ignorován.
| Typ: | String[] |
| Position: | 1 |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-InputObject
Určuje objekty, které mají být reprezentovány v HTML. Zadejte proměnnou obsahující objekty nebo zadejte příkaz nebo výraz, který objekty získá.
Pokud tento parametr použijete k odeslání více objektů, jako jsou všechny služby v počítači, ConvertTo-Html vytvoří tabulku, která zobrazuje vlastnosti kolekce nebo pole objektů (System.Object[]). Chcete-li vytvořit tabulku jednotlivých objektů, pomocí operátoru kanálu převést objekty do ConvertTo-Html.
| Typ: | PSObject |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-PostContent
Určuje text, který se má přidat za pravou značku </TABLE>. Ve výchozím nastavení není v této pozici žádný text.
| Typ: | String[] |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-PreContent
Určuje pole textu, které se má přidat před levou značku <TABLE>. Ve výchozím nastavení není v této pozici žádný text.
| Typ: | String[] |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Property
Určuje vlastnosti objektů v HTML. Hodnota parametru Vlastnost může být nová počítaná vlastnost. K vytvoření počítané vlastnosti použijte tabulku hash. Platné klíče jsou:
- <řetězcové <> (na rozdíl od Select-Object nebo tabulky Format-Table se klíč Name nepodporuje)
- > bloku skriptu <výrazu> nebo bloku skriptu <
| Typ: | Object[] |
| Position: | 0 |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Title
Určuje název souboru HTML, tj. text, který se zobrazí mezi značkami <TITLE>.
| Typ: | String |
| Position: | 2 |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
Vstupy
Libovolný objekt .NET můžete pipetovat do ConvertTo-Html.
Výstupy
System.String or System.Xml.XmlDocument
Tato rutina vrátí řadu řetězců, které tvoří platný kód HTML.
Poznámky
Chcete-li použít tuto rutinu, předaný jeden nebo více objektů do rutiny nebo použijte InputObject parametr k určení objektu. Když se vstup skládá z více objektů, výstup těchto dvou metod je poměrně odlišný.
Když předáte více objektů do rutiny, Windows PowerShell odesílá objekty do rutiny po jednom. V důsledku toho ConvertTo-Html vytvoří tabulku, která zobrazí jednotlivé objekty. Pokud například procesy v počítači předáte do ConvertTo-Html, zobrazí výsledná tabulka všechny procesy.
Pokud použijete parametr InputObject k odeslání více objektů, ConvertTo-Html tyto objekty obdrží jako kolekci nebo jako pole. V důsledku toho vytvoří tabulku, která zobrazí pole a její vlastnosti, nikoli položky v poli. Pokud například použijete InputObject k odeslání procesů v počítači do ConvertTo-Html, zobrazí výsledná tabulka pole objektů (System.Object[]) a jeho vlastnosti.
Aby bylo v souladu s XHTML Strict DTD, značka DOCTYPE se odpovídajícím způsobem upraví:
(<! DOCTYPE html PUBLIC "-//W3C///DTD XHTML 1.0 Strict//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">)