Out-Host

  • Referentie
Module:
Microsoft.PowerShell.Core

Hiermee wordt uitvoer verzonden naar de opdrachtregel.

Syntax

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 dit de standaardinstelling 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 negeert ANSI-escapereeksen. De escapereeksen worden verwerkt door de host. Out-Host geeft ANSI-escapereeksen door 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 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
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Paging

Geeft aan dat Out-Host één pagina met uitvoer tegelijk wordt weergegeven 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 is vergelijkbaar met de meer opdracht.

Notitie

De parameter Paging wordt niet ondersteund door de PowerShell ISE-host.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Invoerwaarden

PSObject

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

PowerShell bevat de volgende aliassen voor Out-Host:

  • Alle platforms:
    • oh

De parameter Paging wordt niet ondersteund door alle PowerShell-hosts. Als u bijvoorbeeld de parameter Paging in de PowerShell ISE gebruikt, wordt de volgende fout weergegeven: out-lineoutput : The method or operation is not implemented.

De cmdlets die het Out-werkwoord bevatten, Out-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 het wordt weergegeven.

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 verzendt gegevens, maar er worden geen uitvoerobjecten geproduceerd. Als u de uitvoer van Out-Host de Get-Member cmdlet pijplijnt, Get-Member rapporteert u dat er geen objecten zijn opgegeven.