escreve o resultado personalizado para uma máquina.
sintaxe
Descrição
o Write-Host cmdlet”o objectivo principal é produzir apenas para-(máquina)-visualização, tal texto colorido como ao pedir ao utilizador para introdução em conjunto com a máquina de leitura.Write-Host usa o método ToString() para escrever o rendimento., Em contraste, para enviar dados para o pipeline, use Write-Output ou implicit-output.
poderá indicar a cor do texto usando o parâmetro ForegroundColor, e poderá indicar a cor do campo usando o parâmetro BackgroundColor. O parâmetro separador permite-lhe indicar um texto a usar para separar os objectos apresentados. O resultado particular depende do programa que ishosting PowerShell.
Nota
começando no Windows PowerShell 5.,0, Write-Host é um invólucro para Write-Information This allowsyou to use Write-Host para emitir saída para o fluxo de informação. Isto permite a captura ou supressão de dados escritos usando Write-Host preservando a compatibilidade para trás.
The$InformationPreference preference variable andInformationAction common parameter do not affectWrite-Host messages. A exceção a esta regra é -InformationAction Ignore, que efetivamente suprime Write-Host saída., (ver “Exemplo 5”)
exemplos
exemplo 1: escreva para a consola sem adicionar uma nova linha
Este comando mostra o texto “sem teste de newline” com o parâmetro
.
uma segunda string é escrita, mas acaba na mesma linha que a primeira devido à ausência de uma nova linha separando as strings.,
Exemplo 2: Escrever para o console e inclui um separador
Exemplo 3: Escrever com diferentes cores de texto e fundo
Este comando exibe o mesmo números de dois a doze anos. Ele usa o parâmetro ForegroundColorpara a saída de texto verde escuro e o parâmetro BackgroundColor para exibir um campo branco.
exemplo 4: escrever com diferentes cores de texto e fundo
Este comando mostra o texto ” vermelho no texto branco.,”The text is red, as defined by theForegroundColor parameter. O fundo é branco, como definido pelo parâmetro BackgroundColor.
Exemplo 5: Suprimir a saída de Write-Host
Estes comandos efetivamente suprimir a saída de Write-Host cmdlet. O primeiro usa o parâmetroInformationAction com o valor Ignore para suprimir a saída para o fluxo de informação.,O segundo exemplo redireciona o fluxo de Informação do comando para a variável
e, por conseguinte, suprime-o.
parâmetros
especifica a cor de fundo. Não há padrão.,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., Não há padrão.,
The string representations of the input objects are concatenated to form the output., Não são inseridos espaços ornewlines entre as cadeias de saída. Não é adicionada nenhuma nova linha após o último texto de saída.
| Tipo: | SwitchParameter |
| Cargo: | Nome |
| valor Padrão: | None |
| Aceita a entrada de pipeline: | False |
| Aceita caracteres curinga: | False |
Objetos para exibir no 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., No entanto, o host displays os objetos que Write-Host envia para ele.ao escrever uma coleção para o hospedeiro, os elementos da coleção são impressos na mesma linha separada por um único espaço. Isto pode ser substituído com o parâmetro separador.
tipos de dados não primitivos, tais como objectos com propriedades, podem causar resultados inesperados e não proporcionar uma saída significativa. Por exemplo, Write-Host @{a = 1; b = 2} irá imprimirSystem.Collections.DictionaryEntry System.Collections.DictionaryEntry para o host.,
- Clear-Host
- Out-Host
- Write-Debug
- Write-Error
- Write-Output
- Write-Progress
- Write-Verbose
- Escrever-Aviso