Out-Host
Invia l'output alla riga di comando.
Sintassi
Out-Host
[-Paging]
[-InputObject <PSObject>]
[<CommonParameters>]Descrizione
Il Out-Host cmdlet invia l'output all'host di PowerShell per la visualizzazione. L'host visualizza l'output nella riga di comando. Poiché Out-Host è l'impostazione predefinita, non è necessario specificarla a meno che non si voglia usare i relativi parametri.
Out-Host passa l'output della pipeline all'host che esegue il comando .
Out-Host ignora le sequenze di escape ANSI. Le sequenze di escape vengono gestite dall'host.
Out-Host passa sequenze di escape ANSI all'host senza tentare di interpretarle o modificarle.
Esempio
Esempio 1: Visualizzare l'output di una pagina alla volta
In questo esempio vengono visualizzati i processi di sistema una pagina alla volta.
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 ottiene i processi di sistema e invia gli oggetti verso il basso nella pipeline.
Out-Host usa il parametro Paging per visualizzare una pagina di dati alla volta.
Esempio 2: Usare una variabile come input
In questo esempio vengono usati oggetti archiviati in una variabile come input per Out-Host.
$io = Get-History
Out-Host -InputObject $io
Get-History ottiene la cronologia della sessione di PowerShell e archivia gli oggetti nella $io variabile .
Out-Host usa il parametro InputObject per specificare la $io variabile e visualizza la cronologia.
Parametri
-InputObject
Specifica gli oggetti scritti nella console. Immettere una variabile contenente gli oggetti oppure digitare un comando o un'espressione che ottiene gli oggetti .
| Tipo: | PSObject |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-Paging
Indica che Out-Host visualizza una pagina di output alla volta. Le dimensioni della pagina sono determinate dalle caratteristiche dell'host.
Dopo aver restituito la prima pagina, il comando attende l'input dell'utente prima che vengano visualizzate le pagine rimanenti. Premere la barra spaziatrice per visualizzare la pagina successiva dell'output o il tasto INVIO per visualizzare la riga di output successiva. Premere Q per uscire.
L'uso del paging è simile all'uso del comando più .
Annotazioni
Il parametro Paging non è supportato dall'host ISE di PowerShell.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
Input
È possibile passare qualsiasi oggetto come input a questo cmdlet.
Output
None
Questo cmdlet non restituisce alcun output. Invia oggetti all'host per la visualizzazione.
Note
PowerShell include gli alias seguenti per Out-Host:
- Tutte le piattaforme:
oh
Non tutti gli host di PowerShell supportano il parametro Paging . Ad esempio, se si usa il parametro Paging in Windows PowerShell ISE, viene visualizzato l'errore seguente:
out-lineoutput: il metodo o l'operazione non è implementato.
I cmdlet che contengono il verbo Out , Out-, non formattano gli oggetti. Eseguono il rendering degli oggetti e li inviano alla destinazione di visualizzazione specificata. Se si invia un oggetto non formattato a un cmdlet di Out-, il cmdlet lo invia a un cmdlet di formattazione prima di eseguire il rendering.
I Out- cmdlet non leggono l'input dai file. Per inviare dati a un Out- cmdlet, usare la pipeline per inviare dati al cmdlet . In alternativa, è possibile archiviare i dati in una variabile e usare il parametro InputObject per passare i dati al cmdlet.
Out-Host invia i dati solo all'host. Tt non produce oggetti di output nella pipeline. Se si esegue la pipeline dell'output di Out-Host nel Get-Member cmdlet , Get-Member segnala che non sono stati specificati oggetti.
