ConvertTo-Html

Referencia

Modul:: Microsoft.PowerShell.Utility

A .NET-objektumokat HTML-fájllá alakítja, amelyek megjeleníthetők egy webböngészőben.

Syntax

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

Description

A ConvertTo-Html parancsmag html formátumúvá alakítja a .NET-objektumokat, amelyek megjeleníthetők egy webböngészőben. Ezzel a parancsmaggal megjelenítheti egy parancs kimenetét egy weblapon.

A paraméterekkel kijelölheti az objektumtulajdonságokat ConvertTo-Html , 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-oldal helyett csak a táblázat vagy a listatöredék visszaadására használható.

Ha több objektumot küld el, ConvertTo-Htmla PowerShell az első beküldött objektum tulajdonságai alapján hozza létre a táblát (vagy 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

ConvertTo-Html -InputObject (Get-Date)

Ez a parancs létrehoz egy HTML-lapot, amely megjeleníti az aktuális dátum tulajdonságait. Az InputObject paraméterrel küldi Get-Date el a parancs eredményeit a ConvertTo-Html parancsmagnak.

2. példa: Weblap létrehozása PowerShell-aliasok megjelenítéséhez

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

Ez a parancs létrehoz egy HTML-lapot, amely felsorolja a PowerShell-aliasokat az aktuális konzolon.

A parancs az aliasok lekéréséhez használja Get-Alias a parancsmagot. A folyamat operátorral (|) elküldi az aliasokat a ConvertTo-Html parancsmagnak, amely létrehozza a HTML-oldalt. A parancs a Out-File parancsmaggal is elküldi a HTML-kódot a aliases.htm fájlnak.

3. példa: Weblap létrehozása PowerShell-események megjelenítéséhez

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

Ez a parancs létrehoz egy HTML-lapot, amely pslog.htm megjeleníti az eseményeket a Windows PowerShell eseménynaplójában a helyi számítógépen.

A parancsmaggal Get-EventLog 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ájlnak.

A parancs a Out-File parancsmaggal is elküldi a HTML-kódot a pslog.htm fájlnak.

4. példa: Weblap létrehozása folyamatok megjelenítéséhez

Get-Process |
  ConvertTo-Html -Property Name, Path, Company -Title "Process Information" |
    Out-File proc.htm
Invoke-Item 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 lekéri 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 szerepeltetni 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 nevesített Proc.htmfájlba.

A második parancs a Invoke-Item parancsmaggal nyitja meg az Proc.htm alapértelmezett böngészőben.

5. példa: Weblap létrehozása szolgáltatásobjektumok megjelenítéséhez

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 a parancsmag által visszaadott szolgáltatásobjektumok Get-Service HTML-lapját. A parancs a CssUri paraméterrel adja meg a HTML-lap kaszkádolt stíluslapját.

A CssUri paraméter egy további <link rel="stylesheet" type="text/css" href="test.css"> címkét ad hozzá az eredményként 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

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

Ez a parancs létrehozza a parancsmag által visszaadott szolgáltatásobjektumok Get-Service HTML-lapját. A parancs az As paraméterrel adja meg a listaformátumot. 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

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>

Ez a parancs az aktuális dátum HTML-táblázatának létrehozására használja ConvertTo-Html . A parancs a Get-Date parancsmaggal lekéri az aktuális dátumot. Egy folyamatkezelővel (|) küldi el az eredményeket a ConvertTo-Html parancsmagnak.

A ConvertTo-Html parancs tartalmazza a Töredék paramétert, amely egy HTML-táblára korlátozza a kimenetet. Ennek eredményeképpen a HTML-lap többi eleme, például a címkék és <BODY> a <HEAD> címkék nem lesznek megadva.

8. példa: Weblap létrehozása PowerShell-események megjelenítéséhez

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ővel (|) küldi el az eseményeket a ConvertTo-Html parancsmagnak, amely HTML formátumúvá alakítja az eseményeket.

A ConvertTo-Html parancs a Tulajdonság paraméter használatával csak az esemény azonosítóját, szintjét és tevékenységtulajdonságait választja ki.

9. példa: Weblap létrehozása a megadott szolgáltatások megjelenítéséhez

$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

Ez a parancs létrehoz és megnyit egy weblapot, amely megjeleníti a szolgáltatásokat a számítógépen.A A kimenet testreszabásához a Cím, a Törzs, a PreContent és a PostContent paramétert ConvertTo-Html használja.

A parancs első része a Get-Service parancsmaggal szerzi be a szolgáltatásokat a számítógépen, amely a következővel Akezdődik: . 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ájlnak.

A pontosvessző (;) befejezi az első parancsot, és elindít egy második parancsot, amely a Invoke-Item parancsmaggal nyitja meg a Services.htm fájlt az alapértelmezett böngészőben.

10. példa: A HTML metatulajdonságainak és karakterkészletének beállítása

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

Ez a parancs létrehozza egy weblap HTML-kódját a frissítéshez, a szerzőhöz és a kulcsszavakhoz tartozó metacímkékkel. A lap karakterkészlete UTF-8 értékre van állítva

11. példa: A HTML beállítása XHTML átmeneti DTD-re

Get-Service | ConvertTo-HTML -Transitional

Ez a parancs beállítja a DOCTYPE visszaadott HTML-t az XHTML Átmeneti DTD-be

Paraméterek

-As

Meghatározza, hogy az objektum táblázatként vagy listaként van-e formázva. Az érvényes értékek a Táblázat és a Lista. Az alapértelmezett érték a Táblázat.

A Tábla érték a PowerShell-táblázat formátumához 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 PowerShell-lista formá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.

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

-Body

A nyitó <BODY> 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.

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

-Charset

A nyitó <charset> címkéhez hozzáadni kívánt szöveget adja meg. Alapértelmezés szerint nincs szöveg ebben a pozícióban.

Ezt a paramétert a PowerShell 6.0-ban vezettük be.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-Fragment

Csak HTML-táblázatot hoz létre. A <HTML>, <HEAD>, <TITLE>és <BODY> a címkék nem lesznek megadva.

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

-Head

Megadja a címke tartalmát <HEAD> . Az alapértelmezett érték <title\>HTML TABLE</title>. Ha a Head paramétert használja, a Cím paraméter figyelmen kívül lesz hagyva.

Type:	String[]
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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, létrehoz egy táblázatot, ConvertTo-Html amely megjeleníti egy gyűjtemény vagy egy objektumtömb tulajdonságait. Az egyes objektumok táblájának létrehozásához használja a folyamatkezelőt az objektumok becsúsztatására ConvertTo-Html.

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

-Meta

A nyitó <meta> címkéhez hozzáadni kívánt szöveget adja meg. Alapértelmezés szerint nincs szöveg ebben a pozícióban.

Ezt a paramétert a PowerShell 6.0-ban vezettük be.

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-PreContent

A nyitó <TABLE> címke elé felvenni kívánt szöveget adja meg. Alapértelmezés szerint nincs szöveg ebben a pozícióban.

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

-Property

Tartalmazza a HTML-ben található objektumok megadott tulajdonságait. A Tulajdonság paraméter értéke lehet egy új számított tulajdonság. A számított tulajdonság lehet szkriptblokk vagy kivonattábla. Az érvényes kulcs-érték párok a következők:

Name (vagy címke) – <string> (a PowerShell 6.x-ben hozzáadva)
Expression - <string> vagy <script block>
FormatString - <string>
Width - <int32> - nagyobbnak kell lennie, mint 0
Alignment - az érték lehet Left, Centervagy Right

További információ: about_Calculated_Properties.

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

-Title

Megadja a HTML-fájl címét, vagyis a címkék között <TITLE> megjelenő szöveget.

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

-Transitional

DOCTYPEAz XHTML átmeneti DTD-t módosítja, alapértelmezett értéke DOCTYPE az XHTML Szigorú DTD.

Ezt a paramétert a PowerShell 6.0-ban vezettük be.

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

Bevitelek

PSObject

A parancsmaghoz bármilyen objektumot csövezhet.

Kimenetek

String

Ez a parancsmag a konvertált objektumot képviselő HTML-sztringek tömbét adja vissza.

Jegyzetek

A parancsmag használatához egy vagy több objektumot csövezhet a parancsmagba, vagy az InputObject paraméter használatával adja meg az objektumot. 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 PowerShell egyenként küldi el az objektumokat a parancsmagnak. Ennek eredményeként létrehoz egy táblát, ConvertTo-Html amely megjeleníti az egyes objektumokat. Ha például egy számítógépen ConvertTo-Htmlfuttatja a folyamatokat, az eredményként kapott táblázat megjeleníti az összes folyamatot.
Ha az InputObject paraméterrel több objektumot küld el, ConvertTo-Html ezeket az objektumokat gyűjteményként vagy tömbként kapja meg. 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 az InputObject használatával küldi el a folyamatokat egy számítógépenConvertTo-Html, az eredményül kapott táblázat egy objektumtömböt és annak tulajdonságait jeleníti meg.

Az XHTML Szigorú 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"\>

ConvertTo-Html

Syntax

Description

Példák

1. példa: Weblap létrehozása a dátum megjelenítéséhez

2. példa: Weblap létrehozása PowerShell-aliasok megjelenítéséhez

3. példa: Weblap létrehozása PowerShell-események megjelenítéséhez

4. példa: Weblap létrehozása folyamatok megjelenítéséhez

5. példa: Weblap létrehozása szolgáltatásobjektumok megjelenítéséhez

6. példa: Weblap létrehozása szolgáltatásobjektumok megjelenítéséhez

7. példa: Webes táblázat létrehozása az aktuális dátumhoz

8. példa: Weblap létrehozása PowerShell-események megjelenítéséhez

9. példa: Weblap létrehozása a megadott szolgáltatások megjelenítéséhez

10. példa: A HTML metatulajdonságainak és karakterkészletének beállítása

11. példa: A HTML beállítása XHTML átmeneti DTD-re

Paraméterek

-As

-Body

-Charset

-CssUri

-Fragment

-Head

-InputObject

-Meta

-PostContent

-PreContent

-Property

-Title

-Transitional

Bevitelek

Kimenetek

Jegyzetek

Visszajelzés

További források

ConvertTo-Html

Syntax

Description

Példák

1. példa: Weblap létrehozása a dátum megjelenítéséhez

2. példa: Weblap létrehozása PowerShell-aliasok megjelenítéséhez

3. példa: Weblap létrehozása PowerShell-események megjelenítéséhez

4. példa: Weblap létrehozása folyamatok megjelenítéséhez

5. példa: Weblap létrehozása szolgáltatásobjektumok megjelenítéséhez

6. példa: Weblap létrehozása szolgáltatásobjektumok megjelenítéséhez

7. példa: Webes táblázat létrehozása az aktuális dátumhoz

8. példa: Weblap létrehozása PowerShell-események megjelenítéséhez

9. példa: Weblap létrehozása a megadott szolgáltatások megjelenítéséhez

10. példa: A HTML metatulajdonságainak és karakterkészletének beállítása

11. példa: A HTML beállítása XHTML átmeneti DTD-re

Paraméterek

-As

-Body

-Charset

-CssUri

-Fragment

-Head

-InputObject

-Meta

-PostContent

-PreContent

-Property

-Title

-Transitional

Bevitelek

Kimenetek

Jegyzetek

Kapcsolódó hivatkozások

Visszajelzés

További források