Share via

Out-Host

  • Referentie
Module:
Microsoft.PowerShell.Core

Hiermee wordt uitvoer naar de opdrachtregel verzonden.

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 op de opdrachtregel weer. Omdat Out-Host de standaardinstelling is, hoeft u deze niet op te geven, tenzij u de bijbehorende parameters 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 escape-reeksen worden verwerkt door de host. Out-Host geeft ANSI-escapereeksen door aan de host zonder deze te interpreteren of te wijzigen.

Voorbeelden

Voorbeeld 1: uitvoer per pagina weergeven

In dit voorbeeld worden de systeemprocessen pagina voor pagina 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 naar beneden in de pijplijn. Out-Host gebruikt de parameter Paging om één pagina met gegevens tegelijk weer te geven.

Voorbeeld 2: Een variabele als invoer gebruiken

In dit voorbeeld worden objecten gebruikt die zijn opgeslagen in een variabele als de 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 geeft de geschiedenis weer.

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 er één pagina met uitvoer tegelijk wordt weergegeven en wordt gewacht op invoer van de gebruiker 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 uitvoerpagina weer te geven of druk op Enter om de volgende regel met uitvoer weer te geven. Druk op Q om af te sluiten.

Paging is vergelijkbaar met de opdracht meer .

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 objecten in de pijplijn naar Out-Hostverzenden.

Uitvoerwaarden

None

Out-Host genereert geen uitvoer. Er worden objecten naar de host verzonden voor weergave.

Notities

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

De cmdlets die het werkwoord Uit , , bevatten, Out-maken geen objecten op. Ze geven objecten weer en verzenden deze naar de opgegeven weergavebestemming. Als u een niet-opgemaakt object naar een Out- cmdlet verzendt, verzendt de cmdlet het naar een cmdlet voor opmaak 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 produceert geen uitvoerobjecten. Als u de uitvoer van Out-Host naar de Get-Member cmdlet pijplijnt, Get-Member wordt gerapporteerd dat er geen objecten zijn opgegeven.