Out-Default
Envia a saída para o formatador padrão e para o cmdlet de saída padrão.
Syntax
Out-Default
[-Transcript]
[-InputObject <PSObject>]
[<CommonParameters>]
Description
O PowerShell adiciona Out-Default
automaticamente ao final de cada pipeline. Out-Default
decide como formatar e gerar o fluxo de objeto. Se o fluxo de objeto for um fluxo de cadeias de caracteres, Out-Default
redirecione-os diretamente para Out-Host
o qual 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 o esquema XML e um mecanismo (o Update-FormatData
cmdlet) em que qualquer pessoa pode registrar exibições para um tipo de objeto. Você pode especificar exibições amplas, de lista, de tabela ou personalizadas para qualquer tipo de objeto. As exibições especificam quais propriedades exibir e como elas devem ser exibidas. Se uma exibição for registrada, ela definirá qual formatador usar. Portanto, se a exibição registrada for uma exibição 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 Format-*
cmdlets e o arquivo Format.ps1xml para controlar a formatação.
Exemplos
Exemplo 1
Embora esse cmdlet não se destine a 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 ela não for chamada explicitamente.
Parâmetros
-InputObject
Aceita entradas para o cmdlet.
Type: | PSObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Transcript
Determina se a saída deve ser enviada para os serviços de transcrição do PowerShell.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |