Compartilhar 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 erro, não são afetados. As exceções serão exibidas. Isso facilita o teste de erros no comando.

Exemplos

Exemplo 1: Excluir saída

Get-ChildItem | Out-Null

Esse 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 contém os objetos ou digite um comando ou uma expressão que obtém os objetos.

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

Entradas

PSObject

Você pode canalizar qualquer objeto para esse cmdlet.

Saídas

None

Esse cmdlet não retorna nenhuma saída.

Observações

  • 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 obter 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.