Compartilhar via

Write-Output

  • Referência
Módulo:
Microsoft.PowerShell.Utility

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[]>
     [-NoEnumerate]
     [<CommonParameters>]

Description

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.

de Saída de Gravação envia objetos para baixo no pipeline primário, também conhecido como "fluxo de saída" ou "pipeline de êxito". Para enviar objetos de erro para baixo no pipeline de erros, use Write-Error.

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

Exemplos

Exemplo 1: Obter objetos e gravá-los no console

PS C:\> $P = Get-Process
PS C:\> Write-Output $P
PS C:\> $P

O primeiro comando obtém processos em execução no computador e os armazena na variável $P.

O segundo e o terceiro comandos exibem os objetos de processo em $P no console.

Exemplo 2: passar a saída para outro cmdlet

PS C:\> Write-Output "test output" | Get-Member

Esse comando redireciona a cadeia de caracteres "saída de teste" para o cmdlet Get-Member, que exibe os membros da classe System.String, demonstrando que a cadeia de caracteres foi passada ao longo do pipeline.

Exemplo 3: suprimir enumeração na saída

PS C:\> Write-Output @(1,2,3) | measure

Count    : 3
...

PS C:\> Write-Output @(1,2,3) -NoEnumerate | measure

Count    : 1

Esse comando adiciona o parâmetro NoEnumerate para tratar uma coleção ou matriz como um único objeto por meio do pipeline.

Parâmetros

-InputObject

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

Tipo:PSObject[]
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-NoEnumerate

Por padrão, o cmdlet write-output sempre enumera sua saída. O parâmetro NoEnumerate suprime o comportamento padrão e impede que write-output enumerem a saída. O parâmetro NoEnumerate não tem efeito sobre coleções criadas por comandos de encapsulamento em parênteses, porque os parênteses forçam a enumeração.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

PSObject

Você pode canalizar objetos para de saída de gravação.

Saídas

PSObject

write-output retorna os objetos enviados como entrada.