Partilhar 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 (Predefinição) 

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.

Write-Output envia objetos pelo pipeline primário, também conhecido como "fluxo de saída" ou "pipeline de sucesso". Para enviar objetos de erro para baixo do 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 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

Este comando canaliza a cadeia de caracteres "test output" 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

Este comando adiciona o parâmetro NoEnumerate para tratar uma coleção ou matriz como um único objeto no pipeline.

Parâmetros

-InputObject

Especifica os objetos que devem ser enviados através do pipeline. Insira uma variável que contenha os objetos ou digite um comando ou expressão que obtenha os objetos.

Propriedades dos parâmetros

Tipo:

PSObject[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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 que foram criadas por comandos de encapsulamento entre parênteses, porque os parênteses forçam a enumeração.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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 Write-Output.

Saídas

PSObject

Write-Output retorna os objetos enviados como entrada.