Partilhar via

Out-Null

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

Oculta a saída em vez de enviá-la pelo pipeline ou exibi-la.

Sintaxe

Out-Null
   [-InputObject <PSObject>]
   [<CommonParameters>]

Description

O Out-Null cmdlet envia sua saída para NULL, na verdade, removendo-a do pipeline e impedindo que a saída seja exibida na tela. Isso afeta apenas o fluxo de saída padrão. Outros fluxos de saída, como o fluxo de erros, não são afetados. Exceções serão exibidas. Isso torna mais fácil testar o comando em busca de erros.

Exemplos

Exemplo 1: Excluir saída

Get-ChildItem | Out-Null

Este comando obtém itens no local/diretório atual, mas sua saída não é passada pelo pipeline nem exibida na linha de comando. Isso é útil para ocultar a saída que você não precisa.

Parâmetros

-InputObject

Especifica o objeto a ser enviado para NULL (removido do pipeline). Insira uma variável que contenha os objetos ou digite um comando ou expressão que obtenha os objetos.

Tipo:PSObject
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

Entradas

PSObject

Você pode canalizar qualquer objeto para este cmdlet.

Saídas

None

Este cmdlet não retorna nenhuma saída.

Notas

  • Os cmdlets que contêm o verbo out (os cmdlets out) não têm parâmetros para nomes ou caminhos de arquivo. Para enviar dados para um cmdlet out , use um operador de pipeline (|) para enviar a saída de um comando do Windows PowerShell para o cmdlet. Você também pode armazenar dados em uma variável e usar o parâmetro InputObject para passar os dados para o cmdlet. Para mais informações, consulte os exemplos.
  • Out-Null não retorna nenhum objeto de saída. Se você canalizar a saída de Out-Null para o cmdlet Get-Member, Get-Member informará que nenhum objeto foi especificado.