Scrive l'output personalizzato in un host.
Sintassi
Write-Host [[-Object] <Object>] [-BackgroundColor {<Black> | <DarkBlue> | <DarkGreen> | <DarkCyan> | <DarkRed> | <DarkMagenta> | <DarkYellow> | <Gray> | <DarkGray> | <Blue> | <Green> | <Cyan> | <Red> | <Magenta> | <Yellow> | <White>}] [-ForegroundColor {<Black> | <DarkBlue> | <DarkGreen> | <DarkCyan> | <DarkRed> | <DarkMagenta> | <DarkYellow> | <Gray> | <DarkGray> | <Blue> | <Green> | <Cyan> | <Red> | <Magenta> | <Yellow> | <White>}] [-NoNewline] [-Separator <Object>] [<CommonParameters>]
Descrizione
Il cmdlet Write-Host personalizza l'output. È possibile specificare il colore del testo utilizzando il parametro ForegroundColor, nonché il colore di sfondo utilizzando il parametro BackgroundColor. Il parametro Separator consente di specificare una stringa da utilizzare per separare gli oggetti visualizzati. Il risultato dipende dal programma che ospita Windows PowerShell.
Parametri
-BackgroundColor <ConsoleColor>
Specifica il colore di sfondo. Non esiste alcuna impostazione predefinita.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
nessuno |
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-ForegroundColor <ConsoleColor>
Specifica il colore del testo. Non esiste alcuna impostazione predefinita.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
nessuno |
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-NoNewline
Specifica che il contenuto visualizzato nella console non termina con un carattere di avanzamento riga.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
nessuno |
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-Object <Object>
Oggetti da visualizzare nella console.
|
Obbligatorio? |
false |
|
Posizione? |
1 |
|
Valore predefinito |
nessuno |
|
Accettare input da pipeline? |
true (ByValue) |
|
Accettare caratteri jolly? |
false |
-Separator <Object>
Stringa da utilizzare per separare gli oggetti visualizzati nella console.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
nessuno |
|
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.Object È possibile reindirizzare gli oggetti da scrivere all'host. |
|
Output |
Nessuno Write-Host invia gli oggetti all'host. Non restituisce alcun oggetto. Tuttavia, l'host potrebbe visualizzare gli oggetti inviati da Write-Host. |
Esempio 1
C:\PS>write-host "no newline test " -nonewline no newline test C:\PS> Descrizione ----------- Questo comando visualizza l'input nella console, tuttavia per la presenza del parametro NoNewline l'output sarà seguito direttamente dal prompt.
Esempio 2
C:\PS>write-host (2,4,6,8,10,12) -Separator ", +2= " 2, +2= 4, +2= 6, +2= 8, +2= 10, +2= 12 Descrizione ----------- Tramite questo comando verranno visualizzati i numeri pari compresi tra 2 e 12. Verrà utilizzato il parametro Separator per aggiungere la stringa , +2= (virgola, spazio, +, 2, =, spazio).
Esempio 3
C:\PS>write-host (2,4,6,8,10,12) -Separator ", -> " -foregroundcolor DarkGreen -backgroundcolor white Descrizione ----------- Questo comando visualizza i numeri pari compresi tra 2 e 12. Utilizza il parametro ForegroundColor per visualizzare il testo in verde scuro e il parametro BackgroundColor per visualizzare uno sfondo bianco.
Esempio 4
C:\PS>write-host "Red on white text." -ForegroundColor red -BackgroundColor white Red on white text. Descrizione ----------- Questo comando visualizza la stringa "Testo rosso su bianco". Il testo è rosso, come definito dal parametro ForegroundColor. Lo sfondo è bianco, come definito dal parametro BackgroundColor.
Vedere anche