Compartilhar via

Out-Default

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

Envia a saída para o formatador padrão e para o cmdlet de saída padrão.

Sintaxe

Out-Default
   [-Transcript]
   [-InputObject <PSObject>]
   [<CommonParameters>]

Description

O PowerShell adiciona automaticamente Out-Default ao final de cada pipeline. Out-Default decide como formatar e gerar o fluxo de objetos. Se o fluxo de objetos for um fluxo de cadeias de caracteres, Out-Default os redireciona diretamente para Out-Host que chama as APIs apropriadas fornecidas pelo host. Se o fluxo de objetos não contiver cadeias de caracteres, Out-Default inspecionará o objeto para determinar o que fazer. Primeiro, ele examina o tipo de objeto e determina se há uma exibição registrada para esse tipo de objeto.

O PowerShell define um esquema XML e um mecanismo (o cmdlet Update-FormatData) em que qualquer pessoa pode registrar exibições para um tipo de objeto. Você pode especificar visualizações inteiras, lista, tabela ou personalizada para qualquer tipo de objeto. As exibições especificam quais propriedades exibir e como devem ser exibidas. Se uma visualização for registrada, ela definirá qual formatador usar. Portanto, se a vista registrada for uma vista de tabela , Out-Default transmitirá os objetos para Format-Table | Out-Host. Format-Table transforma os objetos em um fluxo de registros de formatação (controlados pelos dados na definição de exibição) e Out-Host transforma os registros de formatação em chamadas na interface host.

Esse cmdlet não se destina a ser usado pelo usuário final. Outros cmdlets são recomendados para controlar a saída, como Out-Host ou usando cmdlets Format-* e o arquivo Format.ps1xml para controlar a formatação.

Exemplos

Exemplo 1

Embora esse cmdlet não se pretenda ser executado diretamente pelo usuário final, ele pode ser.

Get-Process | Select-Object -First 5 | Out-Default

NPM(K)    PM(M)      WS(M)     CPU(s)      Id  SI ProcessName
 ------    -----      -----     ------      --  -- -----------
     12     2.56       5.20       0.00    7376   0 aesm_service
     48    34.32      18.10      26.64    9320  13 AlertusDesktopAlert
     24    13.97      12.74       0.77   12656  13 ApplicationFrameHost
      8     1.79       4.41       0.00    8180   0 AppVShNotify
      9     1.99       5.07       0.19   19320  13 AppVShNotify

Nenhum erro é gerado ao usar Out-Default mas a saída não será alterada se não for explicitamente chamada.

Parâmetros

-InputObject

Aceita entradas para o cmdlet.

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

-Transcript

Determina se a saída deve ser enviada para os serviços de transcrição do PowerShell.

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