Out-Host
Envía los resultados a la línea de comandos.
Syntax
Out-Host
[-Paging]
[-InputObject <PSObject>]
[<CommonParameters>]Description
El Out-Host cmdlet envía la salida al host de PowerShell para su visualización. El host muestra los resultados en la línea de comandos. Dado Out-Host que es el valor predeterminado, no es necesario especificarlo a menos que quiera usar sus parámetros.
Out-Host se anexa automáticamente a cada comando que se ejecuta. Pasa la salida de la canalización al host que ejecuta el comando . Out-Host omite las secuencias de escape ANSI. El host controla las secuencias de escape. Out-Host pasa secuencias de escape ANSI al host sin intentar interpretarlas ni cambiarlas.
Ejemplos
Ejemplo 1: Mostrar la salida de una página a la vez
En este ejemplo se muestra que el sistema procesa una página 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 obtiene los procesos del sistema y envía los objetos a la canalización. Out-Host usa el parámetro Paging para mostrar una página de datos a la vez.
Ejemplo 2: Usar una variable como entrada
En este ejemplo se usan objetos almacenados en una variable como entrada para Out-Host.
$io = Get-History
Out-Host -InputObject $ioGet-History obtiene el historial de la sesión de PowerShell y almacena los objetos en la $io variable .
Out-Host usa el parámetro InputObject para especificar la $io variable y muestra el historial.
Parámetros
-InputObject
Especifica los objetos que se escriben en la consola. Especifique una variable que contenga los objetos o escriba un comando o una expresión que obtenga los objetos.
| Type: | PSObject |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Paging
Indica que Out-Host muestra una página de salida a la vez y espera la entrada del usuario antes de que se muestren las páginas restantes. De forma predeterminada, toda la salida se muestra en una sola página. El tamaño de página depende de las características del host.
Presione la barra espaciadora para mostrar la siguiente página de salida o la tecla Entrar para ver la siguiente línea de salida. Presione Q para salir.
La paginación es similar al comando más .
Nota:
El parámetro Paging no es compatible con el host de PowerShell ISE.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Entradas
Puede canalizar cualquier objeto a este cmdlet.
Salidas
None
Este cmdlet no devuelve ningún resultado. Envía objetos al host para su presentación.
Notas
PowerShell incluye los siguientes alias para Out-Host:
- Todas las plataformas:
oh
El parámetro Paging no es compatible con todos los hosts de PowerShell. Por ejemplo, si usa el parámetro Paging en PowerShell ISE, se muestra el siguiente error: out-lineoutput : The method or operation is not implemented.
Los cmdlets que contienen el verbo Out , Out-, no formatear objetos. Representan objetos y los envían al destino de presentación especificado. Si envía un objeto sin formato a un Out- cmdlet, el cmdlet lo envía a un cmdlet de formato antes de representarlo.
Los Out- cmdlets no tienen parámetros para nombres ni rutas de acceso de archivo. Para enviar datos a un Out- cmdlet, use la canalización para enviar la salida de un comando de PowerShell al cmdlet . O bien, puede almacenar datos en una variable y usar el parámetro InputObject para pasar los datos al cmdlet .
Out-Host envía datos, pero no genera ningún objeto de salida. Si canalizará la salida del Out-HostGet-Member cmdlet, Get-Member notifica que no se han especificado objetos.
