Delen via

Out-Host

Module:
Microsoft.PowerShell.Core Module

Hiermee wordt uitvoer verzonden naar de opdrachtregel.

Syntaxis

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 geeft de uitvoer van de pijplijn door 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 er één pagina met uitvoer tegelijk wordt weergegeven. Het paginaformaat wordt bepaald door de kenmerken van de host.

Nadat de eerste pagina is uitgevoerd, wacht de opdracht op invoer van de gebruiker voordat de resterende pagina's worden weergegeven. 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.

Het gebruik van paging is vergelijkbaar met het gebruik van 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 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

Niet alle PowerShell-hosts ondersteunen de parameter Paging . Als u bijvoorbeeld de parameter Paging in windows PowerShell ISE gebruikt, wordt de volgende fout weergegeven:

out-lineoutput: de methode of bewerking wordt niet geïmplementeerd.

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 lezen geen invoer uit bestanden. Als u gegevens naar een Out- cmdlet wilt verzenden, gebruikt u de pijplijn om gegevens 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 alleen gegevens naar de host. Er worden geen uitvoerobjecten naar de pijplijn geproduceerd. Als u de uitvoer van Out-Host naar de cmdlet Get-Member pijplijnt, Get-Member rapporteert dat er geen objecten zijn opgegeven.