ConvertTo-Html
Converte gli oggetti Microsoft .NET Framework in HTML che è possibile visualizzare in un browser.
Sintassi
ConvertTo-Html [[-Head] <string[]>] [[-Title] <string>] [[-Body] <string[]>] [-CssUri <Uri>] [[-Property] <Object[]>] [-As <string>] [-InputObject <psobject>] [-PostContent <string[]>] [-PreContent <string[]>] [<CommonParameters>]
ConvertTo-Html [-Fragment] [[-Property] <Object[]>] [-As <string>] [-InputObject <psobject>] [-PostContent <string[]>] [-PreContent <string[]>] [<CommonParameters>]
Descrizione
Il cmdlet ConvertTo-Html converte gli oggetti .NET Framework in HTML che è possibile visualizzare in un browser. È possibile utilizzare questo cmdlet per visualizzare l'output di un comando in una pagina Web.
È possibile utilizzare i parametri di ConvertTo-Html per selezionare le proprietà degli oggetti, specificare una tabella o un formato elenco, specificare il titolo della pagina HTML, aggiungere testo prima e dopo l'oggetto e restituire solo la tabella o il frammento di elenco, anziché una pagina DTD Strict.
Quando si inviano più oggetti a ConvertTo-Html, in Windows PowerShell viene creata la tabella (o l'elenco) in base alle proprietà del primo oggetto inviato. Se gli oggetti rimanenti non dispongono di una delle proprietà specificate, il valore della proprietà di tale oggetto è una cella vuota. Se gli oggetti rimanenti dispongono di proprietà aggiuntive, i valori di tali proprietà non vengono inclusi nel file.
Parametri
-As <string>
Determina se l'oggetto viene formattato come tabella o elenco. I valori validi sono TABLE e LIST. Il valore predefinito è TABLE.
Il valore TABLE genera una tabella HTML simile al formato tabella di Windows PowerShell. Nella riga dell'intestazione vengono visualizzati i nomi delle proprietà. Ogni riga della tabella rappresenta un oggetto e visualizza i valori dell'oggetto per ciascuna proprietà.
Il valore LIST genera una tabella HTML a due colonne per ogni oggetto simile al formato elenco di Windows PowerShell. Nella prima colonna viene visualizzato il nome della proprietà; nella seconda il valore della proprietà.
Obbligatorio? |
false |
Posizione? |
named |
Valore predefinito |
Table |
Accettare input da pipeline? |
false |
Accettare caratteri jolly? |
false |
-Body <string[]>
Specifica il testo da aggiungere dopo il tag <BODY> di apertura. Per impostazione predefinita, in tale posizione non è presente testo.
Obbligatorio? |
false |
Posizione? |
4 |
Valore predefinito |
No text. |
Accettare input da pipeline? |
false |
Accettare caratteri jolly? |
false |
-CssUri <Uri>
Specifica l'URI del foglio di stile CSS applicato al file HTML. L'URI viene incluso in un collegamento al foglio di stile nell'output.
Obbligatorio? |
false |
Posizione? |
named |
Valore predefinito |
|
Accettare input da pipeline? |
false |
Accettare caratteri jolly? |
false |
-Fragment
Genera solo una tabella HTML. I tag HTML, HEAD, TITLE e BODY vengono omessi.
Obbligatorio? |
false |
Posizione? |
named |
Valore predefinito |
|
Accettare input da pipeline? |
false |
Accettare caratteri jolly? |
false |
-Head <string[]>
Specifica il contenuto del tag <HEAD>. L'impostazione predefinita è"<title>HTML TABLE</title>". Se si utilizza il parametro Head, viene ignorato il parametro Title.
Obbligatorio? |
false |
Posizione? |
2 |
Valore predefinito |
<title>HTML TABLE</title> |
Accettare input da pipeline? |
false |
Accettare caratteri jolly? |
false |
-InputObject <psobject>
Specifica gli oggetti da rappresentare in HTML. Immettere una variabile contenente gli oggetti oppure digitare un comando o un'espressione che consente di ottenere gli oggetti.
Se si utilizza questo parametro per inviare più oggetti, ad esempio tutti i servizi in un computer, ConvertTo-Html crea una tabella in cui vengono visualizzate le proprietà di una raccolta o di una matrice di oggetti (System.Object[]). Per creare una tabella dei singoli oggetti, utilizzare l'operatore pipeline per reindirizzare gli oggetti a ConvertTo-Html.
Obbligatorio? |
false |
Posizione? |
named |
Valore predefinito |
|
Accettare input da pipeline? |
true (ByValue) |
Accettare caratteri jolly? |
false |
-PostContent <string[]>
Specifica il testo da aggiungere dopo il tag </TABLE> di chiusura. Per impostazione predefinita, in tale posizione non è presente testo.
Obbligatorio? |
false |
Posizione? |
named |
Valore predefinito |
No text |
Accettare input da pipeline? |
false |
Accettare caratteri jolly? |
false |
-PreContent <string[]>
Specifica il testo da aggiungere prima del tag <TABLE> di apertura. Per impostazione predefinita, in tale posizione non è presente testo.
Obbligatorio? |
false |
Posizione? |
named |
Valore predefinito |
No text |
Accettare input da pipeline? |
false |
Accettare caratteri jolly? |
false |
-Property <Object[]>
Include le proprietà specificate degli oggetti in HTML.
Obbligatorio? |
false |
Posizione? |
1 |
Valore predefinito |
|
Accettare input da pipeline? |
false |
Accettare caratteri jolly? |
false |
-Title <string>
Specifica un titolo per il file HTML, ovvero il testo visualizzato tra i tag <TITLE>.
Obbligatorio? |
false |
Posizione? |
3 |
Valore predefinito |
|
Accettare input da pipeline? |
false |
Accettare caratteri jolly? |
false |
<CommonParameters>
Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.
Input e output
Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.
Input |
System.Management.Automation.PSObject È possibile reindirizzare qualsiasi oggetto .NET a ConvertTo-Html. |
Output |
System.String ConvertTo-Html restituisce una serie di stringhe che includono l'HTML valido. |
Note
Per utilizzare questo cmdlet, reindirizzare uno o più oggetti al cmdlet o utilizzare il parametro InputObject per specificare l'oggetto. Quando l'input è costituito da più oggetti, l'output di questi due metodi è piuttosto diverso.
-- Quando si reindirizzano più oggetti a un cmdlet, in Windows PowerShell gli oggetti vengono inviati al cmdlet uno alla volta. Di conseguenza, ConvertTo-Html crea una tabella in cui vengono visualizzati i singoli oggetti. Ad esempio, se si reindirizzano i processi in un computer a ConvertTo-Html, nella tabella risultante vengono visualizzati tutti i processi.
-- Quando si utilizza il parametro InputObject per inviare più oggetti, ConvertTo-Html riceve questi oggetti come raccolta o matrice. Di conseguenza, crea una tabella in cui viene visualizzata la matrice e le relative proprietà, non gli elementi nella matrice. Ad esempio, se si utilizza InputObject per inviare i processi in un computer a ConvertTo-Html, nella tabella risultante viene visualizzata una matrice di oggetti (System.Object[]) e le relative proprietà.
Per essere conforme a XHTML DTD Strict, il tag DOCTYPE viene modificato di conseguenza:
(<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">)
Esempio 1
C:\PS>convertto-html -inputobject (get-date)
Descrizione
-----------
Con questo comando viene creata una pagina HTML in cui sono visualizzate le proprietà della data corrente. Viene utilizzato il parametro InputObject per inviare i risultati di un comando Get-Date al cmdlet ConvertTo-Html.
Esempio 2
C:\PS>get-alias | convertto-html > aliases.htm
C:\PS> invoke-item aliases.htm
Descrizione
-----------
Con questo comando viene creata una pagina HTML che elenca gli alias Windows PowerShell nella console corrente.
Il cmdlet Get-Alias viene utilizzato per ottenere gli alias e l'operatore pipeline (|) viene utilizzato per inviare gli alias al cmdlet ConvertTo-Html che crea la pagina HTML.
Esempio 3
C:\PS>get-eventlog -logname "Windows PowerShell | convertto-html > pslog.htm
Descrizione
-----------
Con questo comando viene creata una pagina HTML denominata pslog.htm che visualizza gli eventi nel registro eventi di Windows PowerShell nel computer locale.
Il cmdlet Get-EventLog viene utilizzato per ottenere gli eventi nel registro di Windows PowerShell, quindi l'operatore pipeline (|) viene utilizzato per inviare gli eventi al cmdlet ConvertTo-Html.
Viene inoltre utilizzato l'operatore di reindirizzamento (>) per inviare il codice HTML al file pslog.htm.
Esempio 4
C:\PS>get-process | convertto-html -property Name, Path, Company -title "Process Information" > proc.htm; ii proc.htm
Descrizione
-----------
Con questi comandi viene creata e aperta una pagina HTML in cui sono elencati nome, percorso e società dei processi nel computer locale.
Nel primo comando viene utilizzato il cmdlet Get-Process per ottenere oggetti che rappresentano i processi in esecuzione nel computer. Viene utilizzato l'operatore pipeline (|) per inviare gli oggetti processo al cmdlet ConvertTo-Html.
Vengono utilizzati il parametro Property per selezionare tre proprietà degli oggetti processo da includere nella tabella e il parametro Title per specificare un titolo per la pagina HTML. Viene quindi utilizzato l'operatore di reindirizzamento (>) per inviare il codice HTML risultante a un file denominato Proc.htm.
Nel secondo comando viene utilizzato il cmdlet Invoke-Item (alias = ii) per aprire il file Proc.htm nel browser predefinito. I due comandi sono separati da punto e virgola (;).
Esempio 5
C:\PS>get-service | convertto-html -CssUri "test.css"
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
<head>
<title>HTML TABLE</title>
<link rel="stylesheet" type="text/css" href="test.css" />
...
Descrizione
-----------
Con questo comando viene creata una pagina HTML degli oggetti servizio restituiti dal cmdlet Get-Service. Viene utilizzato il parametro CssUri per specificare un foglio di stile CSS per la pagina HTML.
Il parametro CssUri aggiunge un tag "<link rel="stylesheet" type="text/css" aggiuntivo all'HTML risultante. L'attributo HREF nel tag contiene il nome del foglio di stile.
Esempio 6
C:\PS>get-service | convertto-html -as LIST > services.htm
Descrizione
-----------
Con questo comando viene creata una pagina HTML degli oggetti servizio restituiti dal cmdlet Get-Service. Viene utilizzato il parametro As per specificare un formato elenco. L'operatore di reindirizzamento (>) invia l'HTML risultante al file Services.htm.
Esempio 7
C:\PS>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>
Descrizione
-----------
In questo comando viene utilizzato ConvertTo-Html per generare una tabella HTML della data corrente. Vengono utilizzati il cmdlet Get-Date per ottenere la data corrente e un operatore pipeline (|) per inviare i risultati al cmdlet ConvertTo-Html (con alias "cth").
Il comando ConvertTo-Html include il parametro Fragment che limita l'output a una tabella HTML. Di conseguenza, vengono omessi gli altri elementi di una pagina HTML, ad esempio i tag <HEAD> e <BODY>.
Esempio 8
C:\PS>get-eventlog -log "Windows PowerShell" | convertto-html -property id, level, task
Descrizione
-----------
In questo comando viene utilizzato il cmdlet Get-EventLog per ottenere eventi dal registro eventi "Windows PowerShell".
Viene utilizzato un operatore pipeline (|) per inviare gli eventi al cmdlet ConvertTo-Html che li converte in formato HTML.
Nel comando ConvertTo-Html viene utilizzato il parametro Property per selezionare solo le proprietà ID, Level e Task dell'evento.
Esempio 9
C:\PS>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." > services.htm; ii services.htm
Descrizione
-----------
Con questo comando viene creata e aperta una pagina Web in cui vengono visualizzati i servizi che iniziano con "A" disponibili nel computer. I parametri Title, Body, PreContent e PostContent di ConvertTo-Html vengono utilizzati per personalizzare l'output.
Nella prima parte del comando viene utilizzato il cmdlet Get-Service per ottenere i servizi che iniziano con "A" disponibili nel computer. Vengono utilizzati un operatore pipeline (|) per inviare i risultati al cmdlet ConvertTo-Html e un operatore di reindirizzamento (>) per inviare l'output al file Services.htm.
Il punto e virgola (;) termina il primo comando e ne avvia un secondo, che utilizza il cmdlet Invoke-Item (alias = "ii") per aprire il file Services.htm nel browser predefinito.