Out-Null

Exclui a saída em vez de enviá-la ao console.

Sintaxe

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

Descrição

O cmdlet Out-Null envia saída para NULL, na verdade, excluindo-a.

Parâmetros

-InputObject <psobject>

Especifica o objeto que foi enviado para null (excluído). Insira uma variável que contenha os objetos, ou digite um comando ou uma expressão que obtenha os objetos.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	true (ByValue)
Aceitar caracteres curinga?	false

<CommonParameters>

Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.

Entradas e saídas

O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.

Entradas

System.Management.Automation.PSObject

Você pode canalizar qualquer objeto para Out-Null.

Saídas

None

Out-Null não gera 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 a 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 ao cmdlet. Para obter mais informações, consulte os exemplos.

Out-Null não retorna objetos de saída. Se você canalizar a saída de Out-Null para Get-Member, Get-Member relatará que nenhum objeto foi especificado.

Exemplo 1

C:\PS>get-childitem | out-null

Descrição
-----------
Esse comando obtém os itens no diretório local, mas os descarta, em vez de passá-los através do pipeline ou exibi-los na linha de comando. Isso é útil para descartar a saída desnecessária.