Out-Host
Envía la salida a la línea de comandos.
Sintaxis
All
Out-Host
[-Paging]
[-InputObject <PSObject>]
[<CommonParameters>]
Description
El cmdlet Out-Host envía la salida al host de PowerShell para su visualización. El host muestra la salida en la línea de comandos. Dado que Out-Host 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 quit
Get-Process obtiene los procesos del sistema y envía los objetos a la canalización.
Out-Host usa el parámetro paginación de 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 $io
Get-History obtiene el historial de la sesión de PowerShell y almacena los objetos en la variable $io.
Out-Host usa el parámetro InputObject para especificar la variable $io y muestra el historial.
Parámetros
-InputObject
Especifica los objetos que se escriben en la consola. Escriba una variable que contenga los objetos, o escriba un comando o expresión que obtenga los objetos.
Propiedades de parámetro
| Tipo: | PSObject |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | 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 viene determinado por las características del host.
Presione la barra espacio para mostrar la siguiente página de salida o la tecla Entrar para ver la siguiente línea de salida. Presione Q para salir.
de paginación es similar al comando más.
Nota:
El parámetro Paging no es compatible con el host de PowerShell ISE.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.
Entradas
PSObject
Puede canalizar cualquier objeto a este cmdlet.
Salidas
None
Este cmdlet no devuelve ninguna salida. 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 paginación 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 da formato a los objetos. Representan objetos y los envían al destino de presentación especificado. Si envía un objeto sin formato a un cmdlet de Out-, el cmdlet lo envía a un cmdlet de formato antes de representarlo.
Los cmdlets Out- no tienen parámetros para nombres ni rutas de acceso de archivo. Para enviar datos a un cmdlet de Out-, 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 de Out-Host al cmdlet Get-Member, Get-Member notifica que no se ha especificado ningún objeto.