Compartilhar via


Write-Output

Envia os objetos especificados para o próximo comando no pipeline. Se o comando for o último comando no pipeline, os objetos serão exibidos no console.

Sintaxe

Write-Output [-InputObject] <PSObject[]> [<CommonParameters>]

Descrição

O cmdlet Write-Output envia o objeto especificado pelo pipeline para o próximo comando. Se o comando for o último comando no pipeline, o objeto será exibido no console.

O Write-Output envia objetos pelo pipeline primário, também conhecido como o "fluxo de saída" ou o "pipeline bem-sucedido". Para enviar objetos de erro pelo pipeline de erro, use Write-Error.

Esse cmdlet é usado normalmente em scripts para exibir cadeias de caracteres e outros objetos no console. No entanto, como o comportamento padrão é exibir os objetos no fim de um pipeline, geralmente não é necessário usar o cmdlet. Por exemplo, "Get-Process | write-output" é equivalente a "Get-Process".

Parâmetros

-InputObject <PSObject[]>

Especifica os objetos a serem enviados pelo pipeline. Insira uma variável que contenha os objetos, ou digite um comando ou uma expressão que obtenha os objetos.

Necessário?

true

Posição?

1

Valor padrão

Aceitar entrada do pipeline?

true (ByValue)

Aceitar caracteres curinga?

false

<CommonParameters>

Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.

Entradas e saídas

O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.

Entradas

System.Management.Automation.PSObject

É possível canalizar objetos para Write-Output.

Saídas

System.Management.Automation.PSObject

Write-Output retorna os objetos que são enviados como entrada.

Exemplo 1

C:\PS>$p = get-process

c:\PS> write-output $p

c:\PS> $p

Descrição
-----------
Esses comandos obtêm objetos que representam os processos em execução no computador e exibem os objetos no console.





Exemplo 2

C:\PS>write-output "test output" | get-member

Descrição
-----------
Esse comando canaliza a cadeia de caracteres "test output" para o cmdlet Get-Member, que exibe os membros da classe String, demonstrando que a cadeia de caracteres passou pelo pipeline.





Consulte também

Conceitos

Write-Debug
Write-Verbose
Write-Error
Write-Progress
Write-Host
Write-Warning
Tee-Object