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 |
Nenhum 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.