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 strings 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 string "test output" para o cmdlet Get-Member, que exibe os membros da classe String, demonstrando que a string passou pelo pipeline.

See Also