Compartilhar via

Write-Output

Módulo:
Microsoft.PowerShell.Utility Module

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

Default (Default) 

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 para envio pelo pipeline. Insira uma variável que contenha os objetos ou digite um comando ou expressão que obtém os objetos.

Propriedades do parâmetro

Tipo:

PSObject[]

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

Conjuntos de parâmetros

(All)
Cargo:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

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

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

PSObject

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

Saídas

PSObject

write-output retorna os objetos enviados como entrada.