Out-Host
Envia a saída para a linha de comandos.
Syntax
Out-Host
[-Paging]
[-InputObject <PSObject>]
[<CommonParameters>]Description
O Out-Host cmdlet envia a saída para o anfitrião do PowerShell para visualização. O anfitrião apresenta a saída na linha de comandos. Uma Out-Host vez que é a predefinição, não tem de especificá-la, a menos que pretenda utilizar os respetivos parâmetros.
Out-Host é anexado automaticamente a todos os comandos que são executados. Transmite a saída do pipeline para o anfitrião que executa o comando. Out-Host ignora sequências de escape ANSI. As sequências de escape são processadas pelo anfitrião. Out-Host transmite sequências de escape ANSI para o anfitrião sem tentar interpretá-las ou alterá-las.
Exemplos
Exemplo 1: Apresentar saída uma página de cada vez
Este exemplo apresenta os processos do sistema uma página de cada vez.
Get-Process | Out-Host -Paging
NPM(K) PM(M) WS(M) CPU(s) Id SI ProcessName
------ ----- ----- ------ -- -- -----------
30 24.12 36.95 15.86 21004 14 ApplicationFrameHost
55 24.33 60.48 10.80 12904 14 BCompare
<SPACE> next page; <CR> next line; Q quit
9 4.71 8.94 0.00 16864 14 explorer
<SPACE> next page; <CR> next line; Q quitGet-Process obtém os processos do sistema e envia os objetos pelo pipeline. Out-Host utiliza o parâmetro Paginação para apresentar uma página de dados de cada vez.
Exemplo 2: Utilizar uma variável como entrada
Este exemplo utiliza objetos armazenados numa variável como entrada para Out-Host.
$io = Get-History
Out-Host -InputObject $ioGet-History obtém o histórico da sessão do PowerShell e armazena os objetos na $io variável.
Out-Host utiliza o parâmetro InputObject para especificar a $io variável e apresenta o histórico.
Parâmetros
-InputObject
Especifica os objetos que são escritos na consola. Introduza uma variável que contenha os objetos ou escreva um comando ou expressão que obtenha os objetos.
| Type: | PSObject |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Paging
Indica que Out-Host apresenta uma página de saída de cada vez e aguarda pela entrada do utilizador antes de as páginas restantes serem apresentadas. Por predefinição, todos os resultados são apresentados numa única página. O tamanho da página é determinado pelas características do anfitrião.
Prima a Barra de espaço para apresentar a página seguinte da saída ou a tecla Enter para ver a próxima linha de saída. Prima Q para sair.
A paginação é semelhante ao comando mais .
Nota
O parâmetro Paginação não é suportado pelo anfitrião ISE do PowerShell.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Entradas
Pode encaminhar qualquer objeto para este cmdlet.
Saídas
None
Este cmdlet não devolve nenhuma saída. Envia objetos para o anfitrião para apresentação.
Notas
O PowerShell inclui os seguintes aliases para Out-Host:
- Todas as plataformas:
oh
O parâmetro Paginação não é suportado por todos os anfitriões do PowerShell. Por exemplo, se utilizar o parâmetro Paginação no ISE do PowerShell, é apresentado o seguinte erro: out-lineoutput : The method or operation is not implemented.
Os cmdlets que contêm o verbo Out , Out-, não formatam objetos. Compõem objetos e enviam-nos para o destino de apresentação especificado. Se enviar um objeto não formatado para um Out- cmdlet, o cmdlet envia-o para um cmdlet de formatação antes de o compor.
Os Out- cmdlets não têm parâmetros para nomes ou caminhos de ficheiro. Para enviar dados para um Out- cmdlet, utilize o pipeline para enviar a saída de um comando do PowerShell para o cmdlet. Em alternativa, pode armazenar dados numa variável e utilizar o parâmetro InputObject para transmitir os dados para o cmdlet.
Out-Host envia dados, mas não produz objetos de saída. Se fizer o pipeline da saída de Out-Host para o Get-Member cmdlet, Get-Member comunica que não foram especificados objetos.