Out-Host
Hiermee wordt uitvoer verzonden naar de opdrachtregel.
Syntaxis
Out-Host
[-Paging]
[-InputObject <PSObject>]
[<CommonParameters>]Description
De Out-Host cmdlet verzendt uitvoer naar de PowerShell-host voor weergave. De host geeft de uitvoer weer op de opdrachtregel. Omdat Out-Host de standaardwaarde is, hoeft u deze niet op te geven, tenzij u de parameters ervan wilt gebruiken.
Out-Host wordt automatisch toegevoegd aan elke opdracht die wordt uitgevoerd. De uitvoer van de pijplijn wordt doorgegeven aan de host die de opdracht uitvoert.
Out-Host ansi-escapereeksen negeert. De escapereeksen worden verwerkt door de host.
Out-Host ANSI-escapereeksen doorgeeft aan de host zonder ze te interpreteren of te wijzigen.
Voorbeelden
Voorbeeld 1: Uitvoer één pagina tegelijk weergeven
In dit voorbeeld worden de systeemprocessen één pagina tegelijk weergegeven.
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 haalt de systeemprocessen op en verzendt de objecten omlaag in de pijplijn.
Out-Host gebruikt de parameter Paging om één pagina met gegevens tegelijk weer te geven.
Voorbeeld 2: Een variabele gebruiken als invoer
In dit voorbeeld worden objecten gebruikt die zijn opgeslagen in een variabele als invoer voor Out-Host.
$io = Get-History
Out-Host -InputObject $io
Get-History haalt de geschiedenis van de PowerShell-sessie op en slaat de objecten op in de $io variabele.
Out-Host gebruikt de parameter InputObject om de $io variabele op te geven en de geschiedenis weer te geven.
Parameters
-InputObject
Hiermee geeft u de objecten op die naar de console worden geschreven. Voer een variabele in die de objecten bevat of typ een opdracht of expressie waarmee de objecten worden opgehaald.
| Type: | PSObject |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-Paging
Geeft aan dat Out-Host één pagina met uitvoer tegelijk weergeeft en wacht op gebruikersinvoer voordat de resterende pagina's worden weergegeven. Standaard wordt alle uitvoer op één pagina weergegeven. Het paginaformaat wordt bepaald door de kenmerken van de host.
Druk op de spatiebalk om de volgende pagina met uitvoer of de Enter-toets weer te geven om de volgende regel uitvoer weer te geven. Druk op Q om af te sluiten.
paging lijkt op de meer opdracht.
Notitie
De parameter Paging wordt niet ondersteund door de PowerShell ISE-host.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
Invoerwaarden
U kunt elk object doorsluisen naar deze cmdlet.
Uitvoerwaarden
None
Deze cmdlet retourneert geen uitvoer. Hiermee worden objecten verzonden naar de host voor weergave.
Notities
Windows PowerShell bevat de volgende aliassen voor Out-Host:
oh
De parameter Paging wordt niet ondersteund door alle PowerShell-hosts. Als u bijvoorbeeld de parameter Paging in powerShell ISE gebruikt, wordt de volgende fout weergegeven: out-lineoutput : The method or operation is not implemented.
De cmdlets die de out- werkwoord, Out-, bevatten, maken geen objecten op. Ze genereren objecten en verzenden ze naar de opgegeven weergavebestemming. Als u een niet-opgemaakt object naar een Out--cmdlet verzendt, verzendt de cmdlet het naar een opmaak-cmdlet voordat u het weergeeft.
De Out--cmdlets hebben geen parameters voor namen of bestandspaden. Als u gegevens naar een Out--cmdlet wilt verzenden, gebruikt u de pijplijn om de uitvoer van een PowerShell-opdracht naar de cmdlet te verzenden. U kunt ook gegevens opslaan in een variabele en de parameter InputObject gebruiken om de gegevens door te geven aan de cmdlet.
Out-Host gegevens verzendt, maar er worden geen uitvoerobjecten geproduceerd. Als u de uitvoer van Out-Host naar de cmdlet Get-Member pijplijnt, Get-Member rapporteert dat er geen objecten zijn opgegeven.
