Scrive output personalizzato su un host.
Sintassi
Descrizione
Lo scopo principale del cmdlet Write-Host è quello di produrre per-(host)-display-only output, ad es. stampare testo colorato come quando si richiede all’utente l’input in combinazione con Read-Host.Write-Host utilizza il metodo toString() per scrivere l’output., Al contrario, per inviare i dati alla pipeline, utilizzare Write-Output o implicitoutput.
È possibile specificare il colore del testo utilizzando il parametro ForegroundColor e specificare il colore dello sfondo utilizzando il parametro BackgroundColor. Il parametro Separatore consente di specificareuna stringa da utilizzare per separare gli oggetti visualizzati. Il risultato particolare dipende dal programma che èospostando PowerShell.
Nota
A partire da Windows PowerShell 5.,0, Write-Hostè un wrapper perWrite-InformationQuesto consente di utilizzareWrite-Host per emettere output al flusso di informazioni. Ciò consente l’acquisizione o la soppressione dei dati scritti utilizzando Write-Host preservando la compatibilità all’indietro.
La variabile di preferenza$InformationPreference e il parametro comuneInformationAction non influiscono sui messaggiWrite-Host. L’eccezione a questa regola è-InformationAction Ignore, che sopprime efficacementeWrite-Host output., (vedere “Esempio 5”)
Esempi
Esempio 1: Scrivere sulla console senza aggiungere una nuova riga
Questo comando visualizza la stringa “no newline test” con il parametro NoNewline.
Viene scritta una seconda stringa, ma finisce sulla stessa riga della prima a causa dell’assenza di anewline che separa le stringhe.,
Esempio 2: Scrivere sulla console e includere un separatore
Esempio 3: Scrivere con testo e colori di sfondo diversi
Questo comando visualizza i numeri pari da due a dodici. Utilizza il parametroForegroundColorper produrre testo verde scuro e il parametroBackgroundColor per visualizzare uno sfondo bianco.
Esempio 4: Scrivi con testo e colori di sfondo diversi
Questo comando visualizza la stringa “Red on white text.,”Il testo è rosso, come definito dal parametroForegroundColor. Lo sfondo è bianco, come definito dal parametroBackgroundColor.
Esempio 5: Sopprimere l’output dall’host di scrittura
Questi comandi sopprimono efficacemente l’output del cmdlet Write-Host. Il primo utilizza il parametroInformationAction con il valore Ignore per sopprimere l’output nel flusso di informazioni.,Il secondo esempio reindirizza il flusso di informazioni del comando alla variabile$null e la sopprime.
Parametri
Specifica il colore di sfondo. Non c’è alcun valore predefinito.,ellow
| Type: | ConsoleColor |
| Accepted values: | Black, DarkBlue, DarkGreen, DarkCyan, DarkRed, DarkMagenta, DarkYellow, Gray, DarkGray, Blue, Green, Cyan, Red, Magenta, Yellow, White |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies the text color., Non c’è alcun valore predefinito.,
The string representations of the input objects are concatenated to form the output., Non vengono inseriti spazi o righe di testo tra le stringhe di output. Nessuna nuova riga viene aggiunta dopo l’ultima stringa di output.
| Tipo: | SwitchParameter |
| Posizione: | Nome |
| valore Predefinito: | Nessuno |
| Accettare l’input della pipeline: | False |
| Accetta i caratteri jolly: | False |
Oggetti da visualizzare nell’host.,
| Type: | Object |
| Aliases: | Msg, Message |
| Position: | 0 |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Specifies a separator string to insert between objects displayed by the host.,
| Type: | Object |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Inputs
Object
You can pipe objects to be written to the host.
Outputs
None
Write-Host sends the objects to the host. It does not return any objects., Tuttavia, l’host visualizza gli oggetti cheWrite-Host invia ad esso.
Note
-
Quando si scrive una raccolta sull’host, gli elementi della raccolta vengono stampati sulla stessa lineaseparati da un singolo spazio. Questo può essere sovrascritto con il parametro Separatore.
-
Tipi di dati non primitivi come oggetti con proprietà possono causare risultati imprevisti e non fornire un output significativo. Ad esempio,
Write-Host @{a = 1; b = 2}stamperàSystem.Collections.DictionaryEntry System.Collections.DictionaryEntrysull’host.,
- Clear-Host
- Out-Host
- Write-Debug
- Write-Error
- Write-Output
- Write-Progress
- Write-Verbose
- Write-Warning