ConvertTo-Html

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

Cmdleten ConvertTo-Html konverterar .NET-objekt till HTML som kan visas i en webbläsare. Du kan använda den här cmdleten för att visa utdata från ett kommando på en webbsida.

Du kan använda parametrarna ConvertTo-Html för för att välja objektegenskaper, ange ett tabell- eller listformat, ange HTML-sidrubriken, lägga till text före och efter objektet och för att endast returnera tabellen eller listfragmentet i stället för en strikt DTD-sida.

När du skickar flera objekt till ConvertTo-Htmlskapar PowerShell tabellen (eller listan) baserat på egenskaperna för det första objekt som du skickar. Om de återstående objekten inte har någon av de angivna egenskaperna är egenskapsvärdet för objektet en tom cell. Om de återstående objekten har ytterligare egenskaper inkluderas inte dessa egenskapsvärden i filen.

Exempel

Exempel 1: Skapa en webbsida för att visa datumet

ConvertTo-Html -InputObject (Get-Date)

Det här kommandot skapar en HTML-sida som visar egenskaperna för det aktuella datumet. Den använder parametern InputObject för att skicka resultatet av ett Get-Date kommando till cmdleten ConvertTo-Html .

Exempel 2: Skapa en webbsida för att visa PowerShell-alias

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

Det här kommandot skapar en HTML-sida som visar PowerShell-aliasen i den aktuella konsolen.

Kommandot använder cmdleten Get-Alias för att hämta aliasen. Den använder pipelineoperatorn (|) för att skicka aliasen till cmdleten ConvertTo-Html , vilket skapar HTML-sidan. Kommandot använder också cmdleten Out-File för att skicka HTML-koden till aliases.htm filen.

Exempel 3: Skapa en webbsida för att visa PowerShell-händelser

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

Det här kommandot skapar en HTML-sida med namnet pslog.htm som visar händelserna i Windows PowerShell-händelseloggen på den lokala datorn.

Den använder cmdleten Get-EventLog för att hämta händelserna i Windows PowerShell-loggen och använder sedan pipelineoperatorn (|) för att skicka händelserna till cmdleten ConvertTo-Html . Kommandot använder också cmdleten Out-File för att skicka HTML-koden till pslog.htm filen.

Kommandot använder också cmdleten Out-File för att skicka HTML-koden till pslog.htm filen.

Exempel 4: Skapa en webbsida för att visa processer

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

Dessa kommandon skapar och öppnar en HTML-sida som visar namn, sökväg och företag för processerna på den lokala datorn.

Det första kommandot använder cmdleten Get-Process för att hämta objekt som representerar de processer som körs på datorn. Kommandot använder pipelineoperatorn (|) för att skicka processobjekten till cmdleten ConvertTo-Html .

Kommandot använder parametern Egenskap för att välja tre egenskaper för processobjekten som ska ingå i tabellen. Kommandot använder parametern Rubrik för att ange en rubrik för HTML-sidan. Kommandot använder också cmdleten Out-File för att skicka den resulterande HTML-koden till en fil med namnet Proc.htm.

Det andra kommandot använder cmdleten Invoke-Item Proc.htm för att öppna i standardwebbläsaren.

Exempel 5: Skapa en webbsida för att visa tjänstobjekt

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

Det här kommandot skapar en HTML-sida med de tjänstobjekt som cmdleten Get-Service returnerar. Kommandot använder parametern CssUri för att ange ett sammanhängande formatmallar för HTML-sidan.

CssUri-parametern lägger till ytterligare en <link rel="stylesheet" type="text/css" href="test.css"> tagg i den resulterande HTML-koden. HREF-attributet i taggen innehåller namnet på formatmallen.

Exempel 6: Skapa en webbsida för att visa tjänstobjekt

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

Det här kommandot skapar en HTML-sida med de tjänstobjekt som cmdleten Get-Service returnerar. Kommandot använder parametern Som för att ange ett listformat. Cmdleten Out-File skickar den resulterande HTML-koden till Services.htm filen.

Exempel 7: Skapa en webbtabell för det aktuella datumet

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>

Det här kommandot används ConvertTo-Html för att generera en HTML-tabell med det aktuella datumet. Kommandot använder cmdleten Get-Date för att hämta det aktuella datumet. Den använder en pipelineoperator (|) för att skicka resultatet till cmdleten ConvertTo-Html .

Kommandot ConvertTo-Html innehåller parametern Fragment , som begränsar utdata till en HTML-tabell. Därför utelämnas de andra elementen på en HTML-sida, till exempel taggarna <HEAD> och <BODY> .

Exempel 8: Skapa en webbsida för att visa PowerShell-händelser

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

Det här kommandot använder cmdleten Get-EventLog för att hämta händelser från Windows PowerShell-händelseloggen.

Den använder en pipelineoperator (|) för att skicka händelserna till cmdleten ConvertTo-Html , som konverterar händelserna till HTML-format.

Kommandot ConvertTo-Html använder egenskapsparametern för att endast välja egenskaperna ID, Nivå och Aktivitet för händelsen.

Exempel 9: Skapa en webbsida för att visa angivna tjänster

$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

Det här kommandot skapar och öppnar en webbsida som visar tjänsterna på datorn som börjar med A. Den använder parametrarna Rubrik, Brödtext, PreContent och PostContent för för att anpassa utdata. ConvertTo-Html

Den första delen av kommandot använder cmdleten Get-Service för att hämta tjänsterna på datorn som börjar med A. Kommandot använder en pipelineoperator (|) för att skicka resultatet till cmdleten ConvertTo-Html . Kommandot använder också cmdleten Out-File för att skicka utdata till Services.htm filen.

Ett semikolon (;) avslutar det första kommandot och startar ett andra kommando, som använder cmdleten Invoke-Item Services.htm för att öppna filen i standardwebbläsaren.

Exempel 10: Ange metaegenskaperna och teckenuppsättningen för HTML

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

Det här kommandot skapar HTML för en webbsida med metataggar för uppdatering, författare och nyckelord. Teckenuppsättningen för sidan är inställd på UTF-8

Exempel 11: Ange HTML till XHTML Övergångs-DTD

Get-Service | ConvertTo-HTML -Transitional

Det här kommandot anger DOCTYPE den returnerade HTML-koden till XHTML Transitional DTD

Parametrar

-As

-Body

-Charset

-CssUri

-Fragment

-Head

-InputObject

-Meta

-PostContent

-PreContent

-Property

-Title

-Transitional

Indata

PSObject

Du kan skicka valfritt objekt till den här cmdleten.

Utdata

String

Den här cmdleten returnerar en matris med strängar av HTML som representerar det konverterade objektet.

Kommentarer

Om du vill använda den här cmdleten kan du skicka ett eller flera objekt till cmdleten eller använda parametern InputObject för att ange objektet. När indata består av flera objekt är utdata från dessa två metoder helt olika.

• När du skickar flera objekt till en cmdlet skickar PowerShell objekten till cmdleten en i taget. Därför ConvertTo-Html skapar en tabell som visar de enskilda objekten. Om du till exempel rör processerna på en dator till ConvertTo-Htmlvisar den resulterande tabellen alla processer.

• När du använder parametern InputObject för att skicka flera objekt tar ConvertTo-Html du emot dessa objekt som en samling eller som en matris. Därför skapas en tabell som visar matrisen och dess egenskaper, inte objekten i matrisen. Om du till exempel använder InputObject för att skicka processerna på en dator till ConvertTo-Htmlvisar den resulterande tabellen en objektmatris och dess egenskaper.

  För att följa XHTML Strict DTD ändras taggen DOCTYPE i enlighet med detta:

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

Relaterade länkar

• about_Calculated_Properties
• ConvertTo-Csv
• ConvertTo-Json
• ConvertTo-Xml
• Export-Clixml
• Import-Clixml