ConvertTo-Html
A Microsoft .NET-keretrendszer objektumait html formátumúvá alakítja, amelyek megjeleníthetők egy webböngészőben.
Syntax
Page (Alapértelmezett)
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
A ConvertTo-Html parancsmag a .NET-keretrendszer objektumait HTML-vé alakítja, amelyek megjeleníthetők egy webböngészőben. Ezzel a parancsmaggal megjelenítheti egy parancs kimenetét egy weblapon.
A ConvertTo-Html paramétereivel kijelölheti az objektumtulajdonságokat, megadhatja a táblázat- vagy listaformátumot, megadhatja a HTML-oldal címét, szöveget adhat hozzá az objektum előtt és után, és szigorú DTD-lap helyett csak a táblázat vagy listatöredéket adja vissza.
Ha több objektumot küld ConvertTo-Html, a Windows PowerShell az első beküldött objektum tulajdonságai alapján létrehozza a táblát vagy egy listát. Ha a többi objektum nem rendelkezik a megadott tulajdonságok egyikével, az objektum tulajdonságértéke egy üres cella. Ha a többi objektum további tulajdonságokkal rendelkezik, ezek a tulajdonságértékek nem szerepelnek a fájlban.
Példák
1. példa: Weblap létrehozása a dátum megjelenítéséhez
PS C:\> ConvertTo-Html -InputObject (Get-Date)
Ez a parancs létrehoz egy HTML-lapot, amely megjeleníti az aktuális dátum tulajdonságait. A InputObject paraméterrel küldi el egy Get-Date parancs eredményét a ConvertTo-Html parancsmagnak.
2. példa: Weblap létrehozása PowerShell-aliasok megjelenítéséhez
PS C:\> Get-Alias | ConvertTo-Html | Out-File aliases.htm
PS C:\> Invoke-Item aliases.htm
Ez a parancs létrehoz egy HTML-lapot, amely felsorolja a Windows PowerShell-aliasokat az aktuális konzolon.
A parancs a Get-Alias parancsmaggal szerzi be az aliasokat. A folyamat operátorral (|) elküldi az aliasokat a ConvertTo-Html parancsmagnak, amely létrehozza a HTML-lapot. A parancs a Out-File parancsmaggal is elküldi a HTML-kódot a aliases.htm fájlba.
3. példa: Weblap létrehozása PowerShell-események megjelenítéséhez
PS C:\> Get-EventLog -LogName "Windows PowerShell" | ConvertTo-Html | Out-File pslog.htm
Ez a parancs létrehoz egy pslog.htm nevű HTML-lapot, amely megjeleníti az eseményeket a Windows PowerShell eseménynaplójában a helyi számítógépen.
A Get-EventLog parancsmaggal lekéri az eseményeket a Windows PowerShell-naplóban, majd a folyamatkezelővel (|) elküldi az eseményeket a ConvertTo-Html parancsmagnak.
A parancs a Out-File parancsmaggal is elküldi a HTML-kódot a pslog.htm fájlba.
4. példa: Weblap létrehozása folyamatok megjelenítéséhez
PS C:\> Get-Process | ConvertTo-Html -Property Name, Path, Company -Title "Process Information" | Out-File proc.htm; ii proc.htm
Ezek a parancsok létrehoznak és megnyitnak egy HTML-lapot, amely felsorolja a helyi számítógépen található folyamatok nevét, elérési útját és vállalatát.
Az első parancs a Get-Process parancsmaggal szerzi be a számítógépen futó folyamatokat képviselő objektumokat. A parancs a folyamatkezelő (|) használatával küldi el a folyamatobjektumokat a ConvertTo-Html parancsmagnak.
A parancs a Tulajdonság paraméter használatával választja ki a táblában felvenni kívánt folyamatobjektumok három tulajdonságát. A parancs a Cím paraméterrel adja meg a HTML-lap címét. A parancs a Out-File parancsmaggal is elküldi az eredményül kapott HTML-fájlt egy Proc.htmnevű fájlba.
A második parancs a Invoke-Item parancsmaggal (alias = ii) nyitja meg a Proc.htm az alapértelmezett böngészőben. A két parancsot pontosvessző választja el egymástól (;).
5. példa: Weblap létrehozása szolgáltatásobjektumok megjelenítéséhez
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" />
...
Ez a parancs létrehozza az Get-Service parancsmag által visszaadott szolgáltatásobjektumok HTML-lapját. A parancs a CssUri paraméterrel adja meg a HTML-lap kaszkádolt stíluslapját.
A CssUri paraméter hozzáad egy további <link rel="stylesheet" type="text/css"/ href="test.css"> címkét az eredményül kapott HTML-hez. A címke HREF attribútuma tartalmazza a stíluslap nevét.
6. példa: Weblap létrehozása szolgáltatásobjektumok megjelenítéséhez
PS C:\> Get-Service | ConvertTo-Html -As LIST | Out-File services.htm
Ez a parancs létrehozza az Get-Service parancsmag által visszaadott szolgáltatásobjektumok HTML-lapját. A parancs a As paramétert használja a listaformátum megadásához. A parancsmag Out-File elküldi az eredményül kapott HTML-fájlt a Services.htm fájlnak.
7. példa: Webes táblázat létrehozása az aktuális dátumhoz
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>
Ez a parancs ConvertTo-Html használatával hoz létre egy HTML-táblázatot az aktuális dátumról. A parancs a Get-Date parancsmagot használja az aktuális dátum lekéréséhez. Egy folyamatkezelővel (|) küldi el az eredményeket a ConvertTo-Html parancsmagnak (más néven cth).
A ConvertTo-Html parancs tartalmazza a Töredék paramétert, amely a kimenetet HTML-táblára korlátozza. Ennek eredményeképpen a HTML-lap többi eleme, például a <HEAD> és <BODY> címkék kimaradnak.
8. példa: Weblap létrehozása PowerShell-események megjelenítéséhez
PS C:\> Get-EventLog -Log "Windows PowerShell" | ConvertTo-Html -Property id, level, task
Ez a parancs a Get-EventLog parancsmaggal lekéri az eseményeket a Windows PowerShell eseménynaplójából.
Egy folyamatkezelő (|) használatával küldi el az eseményeket a ConvertTo-Html parancsmagnak, amely HTML formátumba konvertálja az eseményeket.
A ConvertTo-Html parancs a Tulajdonság paramétert használja az esemény azonosítójának, szintjének és tevékenységtulajdonságainak kiválasztásához.
9. példa: Weblap létrehozása a megadott szolgáltatások megjelenítéséhez
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.htm
Ez a parancs létrehoz és megnyit egy weblapot, amely megjeleníti az A kezdetű számítógépen található szolgáltatásokat. A Cím, Törzs, PreContentés ConvertTo-Html PostContent paramétereit használja a kimenet testreszabásához.
A parancs első része a Get-Service parancsmaggal szerzi be az A kezdetű szolgáltatásokat a számítógépen. A parancs egy folyamatkezelővel (|) küldi el az eredményeket a ConvertTo-Html parancsmagnak. A parancs a Out-File parancsmaggal is elküldi a kimenetet a Services.htm fájlba.
Egy pontosvessző (;) az első parancsot befejezi, és elindít egy második parancsot, amely a Invoke-Item parancsmagot (alias = "ii") használja a Services.htm fájl alapértelmezett böngészőben való megnyitásához.
Paraméterek
-As
Megadja, hogy az objektum táblázatként vagy listaként van-e formázva. A paraméter elfogadható értékei a következők: Tábla és Lista. Az alapértelmezett érték a Táblázat.
A Tábla érték a Windows PowerShell-táblázatformátumhoz hasonló HTML-táblázatot hoz létre. A fejlécsor megjeleníti a tulajdonságneveket. Minden táblasor egy objektumot jelöl, és megjeleníti az objektum értékeit az egyes tulajdonságokhoz.
A Lista érték kétoszlopos HTML-táblázatot hoz létre minden olyan objektumhoz, amely hasonlít a Windows PowerShell listaformátumára. Az első oszlop a tulajdonság nevét jeleníti meg; a második oszlop a tulajdonság értékét jeleníti meg.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Elfogadott értékek: | Table, List |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Body
Tömbként adja meg azt a szöveget, amely a nyitó <BODY> címke után hozzáadandó. Alapértelmezés szerint nincs szöveg ebben a pozícióban.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
Page
| Position: | 3 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-CssUri
A HTML-fájlra alkalmazott kaszkádolt stíluslap (CSS) egységes erőforrás-azonosítóját (URI) adja meg. Az URI szerepel a kimenet stíluslap-hivatkozásában.
Paramétertulajdonságok
| Típus: | Uri |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Cu, URL |
Paraméterkészletek
Page
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Fragment
Azt jelzi, hogy ez a parancsmag csak EGY HTML-táblát hoz létre. A HTML-, a HEAD-, a TITLE- és a BODY-címkék nem lesznek megadva.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
Fragment
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Head
A <HEAD> címke tartalmát adja meg tömbként. Az alapértelmezett <cím>HTML TABLE</title>. Ha a Head paramétert használja, a Cím paraméter figyelmen kívül lesz hagyva.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
Page
| Position: | 1 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-InputObject
A HTML-ben megjelenítendő objektumokat adja meg. Adjon meg egy változót, amely tartalmazza az objektumokat, vagy írjon be egy parancsot vagy kifejezést, amely lekéri az objektumokat.
Ha ezt a paramétert több objektum, például a számítógép összes szolgáltatásának elküldéséhez használja, ConvertTo-Html létrehoz egy táblázatot, amely megjeleníti egy gyűjtemény vagy egy objektumtömb tulajdonságait (System.Object[]). Az egyes objektumok táblázatának létrehozásához használja a folyamatkezelőt az objektumok ConvertTo-Html.
Paramétertulajdonságok
| Típus: | PSObject |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | True |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-PostContent
A záró </TABLE> címke után hozzáadni kívánt szöveget adja meg. Alapértelmezés szerint nincs szöveg ebben a pozícióban.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-PreContent
A TÁBLA <> címke megnyitása előtt hozzáadni kívánt szövegtömböt adja meg. Alapértelmezés szerint nincs szöveg ebben a pozícióban.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Property
A HTML-ben található objektumok tulajdonságait adja meg. A tulajdonság paraméter értéke új számított tulajdonság lehet. Számított tulajdonság létrehozásához használjon kivonattáblát. Az érvényes kulcsok a következők:
- Címke <sztring> (a Select-Object vagy a Formátumtáblázattól eltérően a névkulcs nem támogatott)
- Kifejezés <sztring> vagy <szkriptblokkoló>
Paramétertulajdonságok
| Típus: | Object[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | 0 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Title
Megadja a HTML-fájl címét, vagyis a <CÍM> címkék között megjelenő szöveget.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
Page
| Position: | 2 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.
Bevitelek
PSObject
A .NET-objektumokat a ConvertTo-Html
Kimenetek
System.String or System.Xml.XmlDocument
Ez a parancsmag érvényes HTML-t tartalmazó sztringsorozatot ad vissza.
Jegyzetek
A parancsmag használatához pipáljon egy vagy több objektumot a parancsmagba, vagy használja az InputObject paramétert az objektum megadásához. Ha a bemenet több objektumból áll, a két módszer kimenete meglehetősen eltérő.
Ha több objektumot csövez egy parancsmagba, a Windows PowerShell egyenként küldi el az objektumokat a parancsmagnak. Ennek eredményeképpen ConvertTo-Html létrehoz egy táblát, amely megjeleníti az egyes objektumokat. Ha például egy számítógépen futtatja a folyamatokat a ConvertTo-Html
, az eredményként kapott táblázat megjeleníti az összes folyamatot. Ha a InputObject paramétert használja több objektum elküldéséhez, ConvertTo-Html gyűjteményként vagy tömbként fogadja ezeket az objektumokat. Ennek eredményeként létrehoz egy táblát, amely a tömböt és a tulajdonságait jeleníti meg, nem pedig a tömb elemeit. Ha például
InputObject használatával küldi el a folyamatokat a számítógépen a ConvertTo-Html, az eredményül kapott táblázat egy objektumtömböt ( System.Object []) jelenít meg és annak tulajdonságait.
Az XHTML Strict DTD-nek való megfelelés érdekében a DOCTYPE címke ennek megfelelően módosul:
(<! DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">)