Dela via

Out-Host

Modul:
Microsoft.PowerShell.Core Module

Skickar utdata till kommandoraden.

Syntax

All 

Out-Host
    [-Paging]
    [-InputObject <PSObject>]
    [<CommonParameters>]

Description

Cmdleten Out-Host skickar utdata till PowerShell-värden för visning. Värden visar utdata på kommandoraden. Eftersom Out-Host är standard behöver du inte ange det om du inte vill använda dess parametrar.

Out-Host skickar utdata från pipelinen till värden som kör kommandot. Out-Host ignorerar ANSI-escape-sekvenser. Escape-sekvenserna hanteras av värden. Out-Host skickar ANSI-escape-sekvenser till värden utan att försöka tolka eller ändra dem.

Exempel

Exempel 1: Visa utdata en sida i taget

I det här exemplet visas systemprocesserna en sida i taget.

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 hämtar systemprocesserna och skickar objekten nedåt i pipelinen. Out-Host använder parametern Växling för att visa en sida med data i taget.

Exempel 2: Använd en variabel som indata

I det här exemplet används objekt som lagras i en variabel som indata för Out-Host.

$io = Get-History
Out-Host -InputObject $io

Get-History hämtar PowerShell-sessionens historik och lagrar objekten i variabeln $io. Out-Host använder parametern InputObject för att ange variabeln $io och visa historiken.

Parametrar

-InputObject

Anger de objekt som skrivs till konsolen. Ange en variabel som innehåller objekten eller skriv ett kommando eller uttryck som hämtar objekten.

Parameteregenskaper

Typ:PSObject
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Paging

Anger att Out-Host visar en sida med utdata i taget. Sidstorleken bestäms av värdens egenskaper.

När du har matat ut den första sidan väntar kommandot på användarindata innan de återstående sidorna visas. Tryck på Blanksteg om du vill visa nästa sida med utdata eller retur för att visa nästa rad med utdata. Tryck på Q för att avsluta.

Att använda växling liknar att använda kommandot mer.

Anmärkning

Parametern växling stöds inte av PowerShell ISE-värden.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

PSObject

Du kan skicka valfritt objekt till den här cmdleten.

Utdata

None

Den här cmdleten returnerar inga utdata. Den skickar objekt till värden för visning.

Kommentarer

PowerShell innehåller följande alias för Out-Host:

  • Alla plattformar:
    • oh

Alla PowerShell-värdar stöder inte växlingsparametern . Om du till exempel använder växlingsparametern i Windows PowerShell ISE visas följande fel:

out-lineoutput : Metoden eller åtgärden implementeras inte.

De cmdletar som innehåller verbet Out, Out-, formaterar inte objekt. De renderar objekt och skickar dem till det angivna visningsmålet. Om du skickar ett oformaterat objekt till en Out- cmdlet skickar cmdleten det till en formaterings-cmdlet innan det återges.

Cmdletarna Out- läser inte indata från filer. Om du vill skicka data till en Out- cmdlet använder du pipelinen för att skicka data till cmdleten. Eller så kan du lagra data i en variabel och använda parametern InputObject för att skicka data till cmdleten.

Out-Host skickar endast data till värden. Tt producerar inte utdataobjekt till pipelinen. Om du dirigerar utdata från Out-Host till cmdleten Get-MemberGet-Member rapporter om att inga objekt har angetts.