Partilhar via

Out-Null

Módulo:
Microsoft.PowerShell.Core Module

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

Sintaxe

Default (Predefinição) 

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

Description

O cmdlet Out-Null envia sua saída para NULL, na verdade, removendo-a do pipeline e impedindo que a saída seja exibida na tela.

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

Propriedades dos parâmetros

Tipo:PSObject
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

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 encaminhar a saída de um comando 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 do Out-Null para o cmdlet Get-Member, Get-Member informará que nenhum objeto foi especificado.