Delen via

Out-Host

Module:
Microsoft.PowerShell.Core Module

Hiermee wordt uitvoer verzonden naar de opdrachtregel.

Syntax

All 

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.

Parametereigenschappen

Type:PSObject
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Opmerking

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

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

PSObject

U kunt objecten in de pijplijn verzenden naar Out-Host.

Uitvoerwaarden

None

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

Notities

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.