Write-Output
Grava os objetos especificados no pipeline. Se Write-Output
for o último comando no pipeline, os objetos serão exibidos no console.
Syntax
Write-Output
[-InputObject] <PSObject[]>
[-NoEnumerate]
[<CommonParameters>]
Description
Grava os objetos especificados no pipeline. Se Write-Output
for o último comando no pipeline, os objetos serão exibidos no console.
Write-Output
envia objetos para o pipeline primário, também conhecido como "fluxo de saída" ou "pipeline de êxito". Para enviar objetos de erro para o pipeline de erro, use Write-Error
.
Esse cmdlet é usado normalmente em scripts para exibir cadeias de caracteres e outros objetos no console. Um dos aliases internos para Write-Output
é echo
e semelhante a outros shells que usam echo
. O comportamento padrão é exibir a saída no final de um pipeline. No PowerShell, geralmente não é necessário usar o cmdlet em instâncias em que a saída é exibida por padrão. Por exemplo, Get-Process | Write-Output
é equivalente a Get-Process
. Ou, echo "Home directory: $HOME"
pode ser escrito, "Home directory: $HOME"
.
Por padrão, Write-Output
enumera por meio de objetos de coleção. No entanto, Write-Output
também pode ser usado para passar coleções pelo pipeline como um único objeto com o parâmetro NoEnumerate .
Exemplos
Exemplo 1: Obter objetos e gravá-los no console
Neste exemplo, os resultados do Get-Process
cmdlet são armazenados na $P
variável . O Write-Output
cmdlet exibe os objetos de processo no $P
console.
$P = Get-Process
Write-Output $P
Exemplo 2: passar a saída para outro cmdlet
Esse comando redireciona a cadeia de caracteres de "saída de teste" para o Get-Member
cmdlet , que exibe os membros da classe System.String , demonstrando que a cadeia de caracteres foi passada ao longo do pipeline.
Write-Output "test output" | Get-Member
Exemplo 3: suprimir enumeração na saída
Esse comando adiciona o parâmetro NoEnumerate para tratar uma coleção ou matriz como um único objeto por meio do pipeline.
Write-Output 1,2,3 | Measure-Object
Count : 3
...
Write-Output 1,2,3 -NoEnumerate | Measure-Object
Count : 1
...
Parâmetros
-InputObject
Especifica os objetos para envio pelo pipeline. Insira uma variável que contém os objetos ou digite um comando ou uma expressão que obtém os objetos.
Type: | PSObject[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NoEnumerate
Por padrão, o Write-Output
cmdlet sempre enumera sua saída. O parâmetro NoEnumerate suprime o comportamento padrão e impede Write-Output
a enumeração da saída. O parâmetro NoEnumerate não terá efeito se o comando estiver encapsulado entre parênteses, pois os parênteses forçam a enumeração. Por exemplo, (Write-Output 1,2,3)
ainda enumera a matriz.
O parâmetro NoEnumerate só é útil em um pipeline. Tentar ver os efeitos de NoEnumerate no console é problemático porque o PowerShell adiciona Out-Default
ao final de cada linha de comando, o que resulta em enumeração. Mas se você redirecionar Write-Output -NoEnumerate
para outro cmdlet, o cmdlet downstream receberá o objeto da coleção, não os itens enumerados da coleção.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Você pode redirecionar objetos para Write-Output
.
Saídas
Write-Output
retorna os objetos que são enviados como entrada.