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.