Compartilhar via

Write-Host

Módulo:
Microsoft.PowerShell.Utility Module

Grava a saída personalizada em um host.

Sintaxe

Default (Default) 

Write-Host
    [[-Object] <Object>]
    [-NoNewline]
    [-Separator <Object>]
    [-ForegroundColor <ConsoleColor>]
    [-BackgroundColor <ConsoleColor>]
    [<CommonParameters>]

Description

O cmdlet Write-Host personaliza a saída. Você pode especificar a cor do texto usando o parâmetro ForegroundColor e especificar a cor da tela de fundo usando o parâmetro BackgroundColor. O parâmetro Separador permite que você especifique uma cadeia de caracteres a ser usada para separar objetos exibidos. O resultado específico depende do programa que está hospedando o PowerShell.

Observação

A partir do Windows PowerShell 5.0, Write-Host é um wrapper para Write-Information, permitindo que você use Write-Host para gerar saída para o fluxo de informações. Isso permite que o capturar ou de supressão de dados gravados usando Write-Host preservando a compatibilidade com versões anteriores.

A variável de preferência $InformationPreference e InformationAction parâmetro comum não afetam Write-Host mensagens. A exceção a essa regra é -InformationAction Ignore, que suprime efetivamente Write-Host saída. (consulte "Exemplo 5")

Exemplos

Exemplo 1: Gravar no console sem adicionar uma nova linha

Write-Host "no newline test " -NoNewline
Write-Host "second string"

no newline test second string

Esse comando exibe a cadeia de caracteres "nenhum teste de nova linha" com o parâmetro NoNewline.

Uma segunda cadeia de caracteres é escrita, mas acaba na mesma linha que a primeira devido à ausência de uma nova linha separando as cadeias de caracteres.

Exemplo 2: gravar no console e incluir um separador

Write-Host (2,4,6,8,10,12) -Separator ", +2= "

2, +2= 4, +2= 6, +2= 8, +2= 10, +2= 12

Esse comando exibe os números par de dois a doze. O parâmetro Separador é usado para adicionar a cadeia de caracteres , +2= (comma, space, +, 2, =, space).

Exemplo 3: Gravar com diferentes cores de texto e plano de fundo

Write-Host (2,4,6,8,10,12) -Separator ", -> " -ForegroundColor DarkGreen -BackgroundColor White

2, -> 4, -> 6, -> 8, -> 10, -> 12

Esse comando exibe os números par de dois a doze. Ele usa o parâmetro ForegroundColor para gerar texto 'verde escuro' e o parâmetro BackgroundColor para exibir um plano de fundo 'branco'.

Exemplo 4: gravar com diferentes cores de texto e plano de fundo

Write-Host "Red on white text." -ForegroundColor red -BackgroundColor white

Red on white text.

Esse comando exibe a cadeia de caracteres "Vermelho em texto em branco". O texto é "vermelho", conforme definido pelo parâmetro ForegroundColor. O plano de fundo é 'white', conforme definido pelo parâmetro BackgroundColor.

Exemplo 5: suprimir a saída de Write-Host

# The following two statements can be used to effectively suppress output from Write-Host
Write-Host "I won't print" -InformationAction Ignore
Write-Host "I won't print" 6>$null

Esse comando exibe a cadeia de caracteres "Vermelho em texto em branco". O texto é "vermelho", conforme definido pelo parâmetro ForegroundColor. O plano de fundo é 'white', conforme definido pelo parâmetro BackgroundColor.

Parâmetros

-BackgroundColor

Especifica a cor da tela de fundo. Não há nenhum padrão. Os valores aceitáveis para este parâmetro são:

  • Preto
  • DarkBlue
  • DarkGreen
  • Ciano escuro
  • DarkRed
  • Magenta Escuro
  • DarkYellow
  • Cinza
  • DarkGray
  • Azul
  • Verde
  • Cyan
  • Vermelho
  • Magenta
  • Amarelo
  • Branco

Propriedades do parâmetro

Tipo:ConsoleColor
Valor padrão:None
Valores aceitos:Black, DarkBlue, DarkGreen, DarkCyan, DarkRed, DarkMagenta, DarkYellow, Gray, DarkGray, Blue, Green, Cyan, Red, Magenta, Yellow, White
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ForegroundColor

Especifica a cor do texto. Não há nenhum padrão. Os valores aceitáveis para este parâmetro são:

  • Preto
  • DarkBlue
  • DarkGreen
  • Ciano escuro
  • DarkRed
  • Magenta Escuro
  • DarkYellow
  • Cinza
  • DarkGray
  • Azul
  • Verde
  • Cyan
  • Vermelho
  • Magenta
  • Amarelo
  • Branco

Propriedades do parâmetro

Tipo:ConsoleColor
Valor padrão:None
Valores aceitos:Black, DarkBlue, DarkGreen, DarkCyan, DarkRed, DarkMagenta, DarkYellow, Gray, DarkGray, Blue, Green, Cyan, Red, Magenta, Yellow, White
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-NoNewline

As representações de cadeia de caracteres dos objetos de entrada são concatenadas para formar a saída. Nenhum espaço ou nova linha é inserido entre as cadeias de caracteres de saída. Nenhuma nova linha é adicionada após a última cadeia de caracteres de saída.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Object

Objetos a serem exibidos no host.

Propriedades do parâmetro

Tipo:Object
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:0
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Separator

Especifica uma cadeia de caracteres separador a ser inserida entre os objetos exibidos pelo host.

Propriedades do parâmetro

Tipo:Object
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

Object

Você pode canalizar objetos a serem gravados no host.

Saídas

None

Write-Host envia os objetos para o host. Ele não retorna nenhum objeto. No entanto, o host pode exibir os objetos que Write-Host enviar a ele.